Man Linux: Main Page and Category List

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)