Man Linux: Main Page and Category List

NAME - Debian package upload tool configuration file


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

              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

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

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

              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.

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

              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.

              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.

              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.

              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.

              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.

              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.

              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.

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

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

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

              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.


       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.


       Please send bug reports to the author.


              global dput configuration file

              peruser dput configuration file


       Christian Kurz. Updated by Thomas Viehmann <>.

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




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

                                 April 8, 2001