]> git.decadent.org.uk Git - dak.git/blob - tools/debianqueued-0.9/Queue.README
Merge remote branch 'stew/contents' into merge
[dak.git] / 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.