SYNTAX
       dcut [options] [host] [command [, command]]

       dcut -U filename [host]

DESCRIPTION
       dcut  creates  and  / or uploads .commands files for the Debian FTP ar-
       chive upload queue.  It is a companion for dput and uses dput  configu-
       ration files.  As with dput, you can specify a host defined in the dput
       configuration file. In case your host is funnily named, i.e.  it  could
       mistaken for a command, you may also use a command line option to spec-
       ify the host.  In default operation mode (unless you request to  upload
       an  existing  file), the host description is followed by a comma-seper-
       ated list of commands. (Semicolons also work but require  shell  escap-
       ing.)

COMMANDS
       Presently  supported  commands are rm, reschedule and cancel. rm can be
       used to remove files from the UploadQueue directories.  dcut  generates
       commands  that search the subdirectories automaticall, but you can also
       specify --nosearchdirs and then target individual UploadQueue  directo-
       ries,  i.e.  either  filenames  without  path  for  regular incoming or
       DELAYED/#-day/filename. Wildcards are accepted. reschedule changes-file
       #-day  can  be  used to 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 base-
       name of a changes file as argument and operate  on  the  whole  upload,
       they  process  the changes and all files mentioned by it.  The authora-
       tive  documentation  for  the  commands  interface  can  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  you
       specify.

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 for the uploader field  and  gpg  key  selection.

       -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/valid-
              ity of signature) are currently performed.

       -i filename, --input=filename
              Read an input changes file to create a commands  file  that  can
              remove  the  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  and  DEB-
       FULLNAME  to  populate  the uploader field. Also, environment variables
       may 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.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

       -----BEGIN PGP SIGNATURE-----
       Version: GnuPG v1.4.9 (GNU/Linux)

       iEYEARECAAYKAkisYx0ACgkQ4eu+pS04mIfwLQCg85XVpae/LHLrbvzywcQNt9PS
       ztsAoMgw6HjcI9flfmwjgMiapcu379Pu
       =fjp0
       -----END PGP SIGNATURE-----


LICENSE
       This program is distributed under the terms of the Gnu  General  Public
       License, 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 Chris-
              tian Kurz.

SEE ALSO
       dput(1), dput.cf(5)
       ftp://ftp.upload.debian.org/pub/UploadQueue/README


AUTHOR
       Thomas Viehmann <tv@beamnet.de>