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