MAN page from Fedora 23 dput-0.9.6.4-1.fc23.noarch.rpm

dcut

Section: User Commands (1)
Updated: January 2004
Index

NAME

dcut- Debian archive .commands file upload tool

SYNTAX

dcut[options][host][command [, command]]dcut-U filename[host]

DESCRIPTION

dcut creates and / or uploads .commands files for the Debian FTParchive upload queue.It is a companion for dput and uses dput configuration files.As with dput, you can specify ahostdefined in the dput configuration file. In case your host isfunnily named, i.e. it could mistaken for a command, you may also usea command line option to specify the host.In default operation mode (unless you request to upload an existingfile), the host description is followed by a comma-separated list ofcommands. (Semicolons also work but require shell escaping.)

COMMANDS

Presently supported commands are rm, reschedule andcancel. rm can be used to remove files from theUploadQueue directories. dcut generates commands thatsearch the subdirectories automatically, but you can alsospecify --nosearchdirs and then target individualUploadQueue directories, i.e. either filenames without path forregular incoming or DELAYED/#-day/filename. Wildcardsare accepted. reschedule changes-file #-day can be usedto move an upload from any DEFERRED queue to#-day (use 0-day for immediate processing).cancel changes-file cancels an upload from DEFERRED.Both reschedule and cancel take a complete basenameof a changes file as argument and operate on the whole upload,they process the changes and all files mentioned by it.The authorative documentation for the commands interfacecan be found at"ftp://ftp.upload.debian.org/pub/UploadQueue/README".The options try to resemble dput's to the extent possible.Note that dcut calls debsign to sign any commands file generated.In particular, debsign does basic syntax checking on the commands youspecify.

OPTIONS

-c filename, --config=filename: Use config file filename.
-d, --debug: Print debug messages.
-h, --help: Print help information and exit.
--host=host: Upload to host (as found in the dput configuration).Use this if your host is named like one of the commands.
-m maintainer, --maintainer=maintainer: Use maintainer (full email) for the uploader field and gpg key selection.This has no effect when --upload is used.
-k keyid, --keyid=keyid: Use keyid for signing. Default is to let debsign choose a keyid.This has no effect when --upload is used.
-O filename, --output=filename: Write commands file to filename instead of uploading.You sould not specify a host when using this option.Also, this option should not be used with --upload.Both filename and filename.asc will be overwritten.
-P, --passive: Use passive ftp instead of active.
-s, --simulate: Simulate an upload only.
-U filename, --upload=filename: Upload commands file. Note: No checks (syntax or presence/validity ofsignature) are currently performed.
-i filename, --input=filename: Read an input changes file to create a commands file that can removethe files listed in the .changes file from the upload queue.
-v, --version: Print version information and exit.

ENVIRONMENT

The program uses the environment variables DEBEMAIL or EMAIL andDEBFULLNAME to populate the uploader field. Also, environment variablesmay be used in search of a suitable place for temporary files.

EXAMPLES

To upload a GPG signed commands file that removes dput_0.9.2.33_all.debfile 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: SHA1Uploader: Foo Bar <fooAATTbar.org>Commands: rm dput_0.9.2.33_all.deb-----BEGIN PGP SIGNATURE-----Version: GnuPG v1.4.9 (GNU/Linux)iEYEARECAAYKAkisYx0ACgkQ4eu+pS04mIfwLQCg85XVpae/LHLrbvzywcQNt9PSztsAoMgw6HjcI9flfmwjgMiapcu379Pu=fjp0-----END PGP SIGNATURE-----

To upload a GPG signed commands file that removes files named indput_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: SHA1Uploader: Foo Bar <fooAATTbar.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/LHLrbvzywcQNt9PSztsAoMgw6HjcI9flfmwjgMiapcu379Pu=fjp0-----END PGP SIGNATURE-----

If you've uploaded packages with the --delayed option (uploaded toDEFERRED queue), then use the cancel command with a .changesfile.

$ dcut cancel dput_0.9.4_i386.changes

This creates and uploads a commands file just like the other commands.

LICENSE

This program is distributed under the terms of the Gnu General PublicLicense, Version 2 or later.

BUGS

Please direct bug reports and comments to the author.Your feedback is appreciated.If you're using Debian packages, file bugs against the dput package.

FILES

dcut makes use of the dput configuration files:

/etc/dput.cf: System dput configuration file.
~/.dput.cf: User dput configuration file.
Much helpful input and some stolen code from dput author Christian Kurz.

AUTHOR

Thomas Viehmann <tvAATTbeamnet.de>

This document was created byman2html,using the manual pages.