]> git.decadent.org.uk Git - dak.git/blob - tools/debianqueued-0.9/Queue.README
Merge mainline
[dak.git] / tools / debianqueued-0.9 / Queue.README
1
2 This directory is the Debian upload queue of ftp.uni-erlangen.de. All
3 files uploaded here will be moved into the project incoming dir on
4 master.debian.org.
5
6 Only known Debian developers can upload here. All uploads must be in
7 the same format as they would go to master, i.e. with a PGP-signed
8 .changes file that lists all files that belong to the upload. Files
9 not meeting this condition will be removed automatically after some
10 time.
11
12 The queue daemon will notify you by mail of success or any problems
13 with your upload. For this, the Maintainer: field in the .changes must
14 contain your (the uploader's) correct e-mail address, not the address
15 of the real maintainer (if different). The same convention applies to
16 master itself, which sends installation acknowledgements to the
17 address in Maintainer:.
18
19
20 *.commands Files
21 ----------------
22
23 Besides *.changes files, you can also upload *.commands files for the
24 daemon to process. With *.commands files, you can instruct the daemon
25 to remove or rename files in the queue directory that, for example,
26 resulted from failed or interrupted uploads. A *.commands file looks
27 much like a *.changes, but contains only two fields: Uploader: and
28 Commands:. It must be PGP-signed by a known Debian developer, to avoid
29 that E.V.L. Hacker can remove/rename files in the queue. The basename
30 (the part before the .commands extension) doesn't matter, but best
31 make it somehow unique.
32
33 The Uploader: field should contain the mail address to which the reply
34 should go, just like Maintainer: in a *.changes. Commands: is a
35 multi-line field like e.g. Description:, so each continuation line
36 should start with a space. Each line in Commands: can contain a
37 standard 'rm' or 'mv' command, but no options are allowed, and
38 filenames may not contain slashes (so that they're restricted to the
39 queue directory). 'rm' can process as much arguments as you give it
40 (not only one), and also knows about the shell wildcards *, ?, and [].
41
42 Example of a *.commands file:
43
44 -----BEGIN PGP SIGNED MESSAGE-----
45
46 Uploader: Roman Hodek <Roman.Hodek@informatik.uni-erlangen.de>
47 Commands: 
48  rm hello_1.0-1_i386.deb
49  mv hello_1.0-1.dsx hello_1.0-1.dsc
50
51 -----BEGIN PGP SIGNATURE-----
52 Version: 2.6.3ia
53
54 iQCVAwUBNFiQSXVhJ0HiWnvJAQG58AP+IDJVeSWmDvzMUphScg1EK0mvChgnuD7h
55 BRiVQubXkB2DphLJW5UUSRnjw1iuFcYwH/lFpNpl7XP95LkLX3iFza9qItw4k2/q
56 tvylZkmIA9jxCyv/YB6zZCbHmbvUnL473eLRoxlnYZd3JFaCZMJ86B0Ph4GFNPAf
57 Z4jxNrgh7Bc=
58 =pH94
59 -----END PGP SIGNATURE-----