tools/debianqueued-0.9/Queue.README

   1
   2 This directory is the Debian upload queue of ftp.upload.debian.org. All
   3 files uploaded here will be moved into the project incoming dir on
   4 this machine.
   5
   6 Only known Debian developers can upload here. Uploads have to be signed
   7 by PGP keys in the Debian keyring. Files not meeting this criterion or
   8 files not mentioned in a .changes file will be removed after some time.
   9
  10 The queue daemon will notify you by mail of success or any problems
  11 with your upload.
  12
  13
  14 *.commands Files
  15 ----------------
  16
  17 Besides *.changes files, you can also upload *.commands files for the
  18 daemon to process. With *.commands files, you can instruct the daemon
  19 to remove or rename files in the queue directory that, for example,
  20 resulted from failed or interrupted uploads. A *.commands file looks
  21 much like a *.changes, but contains only two fields: Uploader: and
  22 Commands:. It must be PGP-signed by a known Debian developer, to avoid
  23 that E.V.L. Hacker can remove/rename files in the queue. The basename
  24 (the part before the .commands extension) doesn't matter, but best
  25 make it somehow unique.
  26
  27 The Uploader: field should contain the mail address to which the reply
  28 should go, just like Maintainer: in a *.changes. Commands: is a
  29 multi-line field like e.g. Description:, so each continuation line
  30 should start with a space. Each line in Commands: can contain a
  31 standard 'rm' command, but no options are allowed. Except for the
  32 DELAYED queue (see below) filenames may not contain slashes (so that
  33 they're restricted to the queue directory). 'rm' can process as much
  34 arguments as you give it (not only one), and also knows about the shell
  35 wildcards *, ?, and [].
  36
  37 Example of a *.commands file:
  38
  39 -----BEGIN PGP SIGNED MESSAGE-----
  40
  41 Uploader: Some One <some@example.com>
  42 Commands:
  43  rm hello_1.0-1_i386.deb
  44
  45 -----BEGIN PGP SIGNATURE-----
  46 Version: 2.6.3ia
  47
  48 [...]
  49 -----END PGP SIGNATURE-----
  50
  51
  52 DELAYED Queue
  53 -------------
  54 There is a DELAYED queue available. Packages uploaded into the
  55 X-day (X between 0 and 15) subdirectories of DELAYED/ will be moved into
  56 the DEFERRED queue and won't be placed into the archive before the
  57 waiting time is over.
  58
  59 To avoid confusion, the terms used are:
  60 DELAYED  - the public ftp upload directories, reachable via DELAYED/X-day
  61
  62 DEFERRED - this is the place where the uploads are placed by the queue
  63            daemon after processing and where packages wait before they
  64            are moved into the incoming queue.
  65
  66
  67 You can modify the queues (besides uploading packages) with *.commands
  68 files as described above, using the following syntax.
  69
  70 Note that any processing in the DEFERRED queue works on whole uploads
  71 (i.e. a .changes file and all the files that came with it), whereas
  72 operations in the DELAYED queue (and the normal ftp root directory)
  73 work on individual files.
  74
  75  - To move a package from one DEFERRED directory into another, say
  76    from 8-days to 2-days delay:
  77    reschedule foo_1.2-1.1_all.changes 2-day
  78
  79    The move-target has to be without the trailing /.
  80
  81  - To delete an upload (and all associated files) in the DEFERRED queue:
  82    cancel foo_1.2-1.1_all.changes
  83
  84  - To delete a broken upload in the DELAYED queue:
  85    rm DELAYED/X-day/foobar.deb
  86
  87    or
  88
  89    rm --searchdirs foobar.deb
  90
  91  - The old mv command is no longer supported.
  92
  93 Wildcards in .commands files are only valid for the DELAYED queue and
  94 its rm command, the DEFERRED queue commands cancel and reschedule do
  95 not allow them.