DCUT(1) | General Commands Manual | DCUT(1) |
dcut - Debian command upload tool for the archive upload queue
dcut |
[-Pds] [-c CONFIGFILE] [-k KEYID] [-m MAINTAINER] [-O COMMANDFILE] [ [--host] HOSTNAME] COMMAND [, COMMAND] ... |
dcut |
[-Pds] [-c CONFIGFILE] [-k KEYID] [-m MAINTAINER] [-O COMMANDFILE] [ [--host] HOSTNAME] -i CHANGESFILE |
dcut |
[-Pds] [-c CONFIGFILE] [ [--host] HOSTNAME] -U COMMANDFILE |
dcut |
-h |
dcut |
-v |
dcut creates and / or uploads Debian queue commands files for a Debian repository upload queue. It is a companion for dput(1) and uses dput configuration files (see FILES, below).
The normal workflow is:
In the default command-line syntax, parse each command-line argument COMMAND, in the format needed by a Debian archive queue manager. Multiple queue commands must be separated by a comma (,) as a separate word between each command.
See COMMANDS below for valid queue commands.
When the CHANGESFILE parameter is specified, instead parse that file and compose a rm command for each file specified in CHANGESFILE.
If the --upload (-U) option is specified, instead read the queue control commands from the file COMMANDFILE.
The Uploader field in the batch is set to the package maintainer specification MAINTAINER. If not specified, the value of MAINTAINER is derived from environment variables (see ENVIRONMENT, below).
The Commands field in the batch is set to the sequence of queue control commands determined.
If the --output (-O) option is specified, write the batch to the file named by its COMMANDFILE argument. Otherwise, write the batch to a temporary file and remove it after upload.
After writing the batch of commands to a file, sign the file with debsign(1). The MAINTAINER and KEYID parameters, if specified, are passed to the debsign command.
If the --upload (-U) option is specified, do not compose the batch of commands; instead use the content of its COMMANDFILE argument as the name of the command file to upload to the queue host.
The HOSTNAME must match one of the named hosts in the configuration (see dput.cf(5)). The value is determined as follows:
Upload the composed batch of queue commands to the queue host HOSTNAME, using the parameters in the dput.cf(5) configuration for that host.
If the --output (-O) option is specified, do not upload the commands to the queue host. Instead, leave the composed file COMMANDFILE on the filesystem.
Presently supported commands are:
Both reschedule and cancel take a complete basename of a changes file as argument and operate on the whole upload, they process the changes and all files mentioned by it.
The authoritative documentation for the commands interface can be found at ftp://ftp.upload.debian.org/pub/UploadQueue/README.
To upload a GPG signed commands file that removes dput_0.9.2.33_all.deb file from the queue, one would have to do:
$ dcut rm dput_0.9.2.33_all.deb
This creates and uploads a commands file that looks like the following:
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Uploader: Foo Bar <foo@bar.org> Commands:
rm dput_0.9.2.33_all.deb -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (GNU/Linux) iEYEARECAAYKAkisYx0ACgkQ4eu+pS04mIfwLQCg85XVpae/LHLrbvzywcQNt9PS ztsAoMgw6HjcI9flfmwjgMiapcu379Pu =fjp0 -----END PGP SIGNATURE-----
To upload a GPG signed commands file that removes files named in dput_0.9.4_i386.changes from the queue, one would have to do:
$ dcut --input dput_0.9.4_i386.changes
This creates and uploads a commands file that looks like the following:
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Uploader: Foo Bar <foo@bar.org> Commands:
rm --searchdirs dput_0.9.4.dsc
rm --searchdirs dput_0.9.4.tar.gz
rm --searchdirs dput_0.9.4_all.deb -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (GNU/Linux) iEYEARECAAYKAkisYx0ACgkQ4eu+pS04mIfwLQCg85XVpae/LHLrbvzywcQNt9PS ztsAoMgw6HjcI9flfmwjgMiapcu379Pu =fjp0 -----END PGP SIGNATURE-----
If you've uploaded packages with the --delayed option (uploaded to DEFERRED queue), then use the cancel command with a .changes file:
$ dcut cancel dput_0.9.4_i386.changes
This creates and uploads a commands file just like the other commands.
2017-01-09 | Debian |