Provided by: dput_0.9.6.2ubuntu1_all bug

NAME

       dput.cf - Debian package upload tool configuration file

DESCRIPTION

       This manpage gives a brief overview of dput's configuration file and the available options
       in it.  dput is a tool to upload Debian packages to the archive.

FORMAT

       dput.cf consists of different groups of configuration options, one for each host where you
       want  to  be  able to upload packages. Hosts are defined using an identifier header with a
       short name for the host, enclosed in square brackets.  Note that  only  if  multiple  such
       headers  are encountered in the configuration, only the group following the last header is
       considered. This is done to avoid confusion when overriding a  global  configuration  file
       with  a  user-specific  one.  There's a special identifier, [DEFAULT], which holds default
       parameters for all the hosts. The defaults can be overridden by redefining them  again  in
       each host section. The available parameters are listed below:

       fqdn   This  is  the  fully  qualified  domain name that will be used (can be specified as
              host:port for HTTP, HTTPS and FTP).

       login  Your login on the machine named before. A single asterisk * will cause the scp  and
              rsync uploaders to not use supply a login name when calling to ssh, scp, and rsync.

       incoming
              The directory that you should upload the files to.

       method The  method  that you want to use for uploading the files.  Currently, dput accepts
              the following values for method:

              ftp    the package will  be  uploaded  via  ftp,  either  anonymously  or  using  a
                     login/password.  Note that ftp is unencrypted so you should not use password
                     authentication with this.

              http and https
                     the package will be uploaded via http or  https  using  the  PUT  method  as
                     specified  in  WebDAV.  The  upload  method  will  prompt  for a password if
                     necessary.

              scp    the package will be uploaded using ssh's scp. This transfers files  using  a
                     secure ssh tunnel, and needs an account on the upload machine.

              sftp   the  package will be uploaded using ssh's sftp. This transfers files using a
                     secure ssh tunnel, and needs sftp access on the upload machine.

              rsync  the package will be uploaded using rsync over ssh. This is similar  to  scp,
                     but  can  save  some bandwidth if the destination file already exists on the
                     upload server. It also needs a login on the remote machine as it uses ssh.

              local  the  package  will  be  "uploaded"  locally  using  /usr/bin/install.   This
                     transfers  files  to  a  local  incoming  directory,  and  needs appropriate
                     permissions set on that directory.

       hash   The hash algorithm that should be used in calculating the  checksum  of  the  files
              before uploading them. Currently, dput accepts the following values for hash:

              md5    use the md5 algorithm for calculation

              sha    use the sha algorithm for calculation

       allow_unsigned_uploads
              This  defines  if you are allowed to upload files without a GnuPG signature to this
              host or not.

       allow_dcut
              This defines if you are allowed to upload a dcut  changes  file  to  the  queue  to
              remove or move files.

       distributions
              This  defines  a comma-separated list of distributions that this host accepts, used
              to guess the host to use when none is given on the command line.

       allowed_distributions
              A regular expression (of Python re module syntax) that the distribution field  must
              match or dput will refuse the upload.

       delayed
              Set  a  numeric  default  parameter for delayed uploads (i.e. uploads to this queue
              will be delayed the specified number of days. Defaults to the empty string, meaning
              no delay. This only works with upload queues that support delayed uploads.

       run_lintian
              This option defines if lintian should be run before the package will be uploaded or
              not. If the package is not lintian clean, the upload will not happen.

       run_dinstall
              This options defines if dinstall -n should  be  run  after  the  package  has  been
              uploaded  or  not.  This  is an easy way to test if your package would be installed
              into the archive or not.

       check_version
              This option defines if dput should check if the user has installed the  package  in
              his  system  for testing it before putting it into the archive. If the user has not
              installed and tested it, dput will reject the upload.

       passive_ftp
              This option defines if dput should use passive ftp or active ftp  for  uploading  a
              package to one of the upload queues. By default, dput uses passive ftp connections.
              If you need to use active ftp connections, set passive_ftp to 0.

       progress_indicator
              This integer option defines if dput should display a  progress  indicator  for  the
              upload. (Currently implemented in ftp only.)
              Supported values: 0 (default) - no progress, 1 - rotating progress indicator, and 2
              - kilobyte counter.

       scp_compress
              This option defines if the scp upload to the host will be compressed, or not.  This
              option  is  only  used  for the 'scp' upload method, and has been found to decrease
              upload time for slow links, and increase upload times for faster links.

       ssh_config_options
              The arguments of this config options should be ssh config file options in the style
              documented  in  ssh_config(5).  They will be passed to all automatic invocations of
              ssh and scp by dput. Note  that  you  can  define  multiline  (dput)  configuration
              options by indenting the second line with whitespace (i.e. similar to RFC822 header
              continuations).

       post_upload_command
              This option defines a command to be run by dput after a successful upload.

       pre_upload_command
              This option defines a command to be run by dput before a upload happens.

       default_host_main
              This defines the default host for packages that are allowed to be uploaded  to  the
              main archive. This variable is used when guessing the host to upload to.

HOST ARGUMENT

       If  a  user  passes  an  argument  to  a  host  by  appending  the  hostname with a colon,
       %(HOSTNAME)s will be replaced with the specified argument. Otherwise, it will be  replaced
       with an empty string.

BUGS

       Please send bug reports to the author.

FILES

       /etc/dput.cf
              global dput configuration file

       ~/.dput.cf
              peruser dput configuration file

AUTHOR

       Christian Kurz. Updated by Thomas Viehmann <tv@beamnet.de>.

       Many other people have contributed to this code. See the Thanks file.

SEE ALSO

       dput(1)
       /usr/share/doc/dput

COMMENTS

       The author appreciates comments and suggestions from you, if any.

                                          April 8, 2001                                dput.cf(5)