Provided by: dput_0.9.6.2ubuntu1_all bug

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 FTP
       archive upload queue.  It  is  a  companion  for  dput  and  uses  dput
       configuration  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 specify the host.  In default operation mode (unless you request  to
       upload  an existing file), the host description is followed by a comma-
       seperated list of commands. (Semicolons also  work  but  require  shell
       escaping.)

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
       directories, 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
       basename of 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 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 (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 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
       DEBFULLNAME 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

       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-----

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
              Christian Kurz.

SEE ALSO

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

AUTHOR

       Thomas Viehmann <tv@beamnet.de>

                                 January 2004                          dcut(1)