tools/debianqueued-0.9/Queue.README

   1
   2 This directory is the Debian upload queue of ftp-master.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 criteria 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, and filenames may not
  32 contain slashes (so that they're restricted to the queue
  33 directory). 'rm' can process as much arguments as you give it (not only
  34 one), and also knows about the shell wildcards *, ?, and [].
  35
  36 Example of a *.commands file:
  37
  38 -----BEGIN PGP SIGNED MESSAGE-----
  39
  40 Uploader: Some One <some@example.com>
  41 Commands:
  42  rm hello_1.0-1_i386.deb
  43
  44 -----BEGIN PGP SIGNATURE-----
  45 Version: 2.6.3ia
  46
  47 [...]
  48 -----END PGP SIGNATURE-----
  49
  50
  51 DELAYED Queue
  52 -------------
  53 There is a DELAYED queue available. Packages uploaded into the
  54 X-day (X between 0 and 15) subdirectories of DELAYED/ will be moved into
  55 the DEFERRED queue and won't be placed into the archive before the
  56 waiting time is over.
  57
  58 To avoid confusion, the terms used are:
  59 DELAYED  - the public ftp upload directories, reachable via DELAYED/X-day
  60
  61 DEFERRED - this is the place where the uploads are placed by the queue
  62            daemon after processing and where packages wait before they
  63            are moved into the incoming queue.
  64
  65
  66 You can modify the queues (besides uploading packages) with *.commands
  67 files as described above, using the following syntax.
  68
  69 Note that any processing in the DEFERRED queue works on whole uploads
  70 (i.e. a .changes file and all the files that came with it), whereas
  71 operations in the DELAYED queue (and the normal ftp root directory)
  72 work on individual files.
  73
  74  - To move a package from one DEFERRED directory into another, say
  75    from 8-days to 2-days delay:
  76    reschedule foo_1.2-1.1_all.changes 2-day
  77
  78    The move-target has to be without the trailing /.
  79
  80  - To delete an upload (and all associated files) in the DEFERRED queue:
  81    cancel foo_1.2-1.1_all.changes
  82
  83  - To delete a broken upload in the DELAYED queue:
  84    rm DELAYED/X-day/foobar.deb
  85
  86    or
  87
  88    rm --searchdirs foobar.deb
  89
  90  - The old mv command is no longer supported.
  91
  92 Wildcards in .commands files are only valid for the DELAYED queue and
  93 its rm command, the DEFERRED queue commands cancel and reschedule do
  94 not allow them.