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 brackets.
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.
login
Your login on the machine named before.
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 anonymous or using a
login/password. This should be the default for UploadQueues, but you
should avoid it for debian.org machines, as the password will be sent
unencrypted.
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.
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.
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.
default_host_non-us
This defines the default host for packages that are only allowed to be uploaded
to the non-us archive. This variable is used when guessing the host to upload to.
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 <shorty@debian.org>
Many other people have contributed to this code. See the
Thanks file.
