MAN page from Fedora 24 dput-0.9.6.4-1.fc24.noarch.rpm

dput.cf

Section: File Formats (5)
Updated: April 8, 2001
Index

NAME

dput.cf- Debian package upload tool configuration file

DESCRIPTION

This manpage gives a brief overview of dput's configuration file and theavailable 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 eachhost where you want to be able to upload packages. Hosts are defined using anidentifier header with a short name for the host, enclosed in square brackets.Note that only if multiple such headers are encountered in theconfiguration, only the group following the last header is considered. Thisis done to avoid confusion when overriding a global configuration file witha user-specific one.There's a special identifier, [DEFAULT], which holds default parameters forall the hosts. The defaults can be overridden by redefining them again ineach host section. The available parameters are listed below:

fqdn

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

login

Your login on the machine named before. A single asterisk * willcause the scp and rsync uploaders to not use supply a login name whencalling 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 alogin/password. Note that ftp is unencrypted so you should not usepassword authentication with this.
http and https: the package will be uploaded via http or https using the PUT methodas specified in WebDAV. The upload method will prompt for a passwordif necessary.
scp: the package will be uploaded using ssh's scp. This transfers files using asecure 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 theupload 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. Thistransfers files to a local incoming directory, and needs appropriatepermissions set on that directory.

hash

The hash algorithm that should be used in calculating the checksum ofthe files before uploading them. Currently, dput accepts the following valuesfor 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 GnuPGsignature to this host or not.

allow_dcut

This defines if you are allowed to upload a dcut changes file to thequeue 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 thedistribution field must match or dput will refuse the upload.

delayed

Set a numeric default parameter for delayed uploads (i.e. uploads to thisqueue will be delayed the specified number of days. Defaults to theempty string, meaning no delay. This only works with upload queuesthat 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 willnot happen.

run_dinstall

This options defines if dinstall -n should be run after the package hasbeen 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 theuser 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 uploadinga package to one of the upload queues. By default, dput uses passive ftpconnections. If you need to use active ftp connections, setpassive_ftp to 0.

progress_indicator

This integer option defines if dput should display a progress indicator forthe upload. (Currently implemented in ftp only.)
Supported values: 0 (default) - no progress, 1 - rotating progressindicator, 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 todecrease upload time for slow links, and increase upload times for fasterlinks.

ssh_config_options

The arguments of this config options should be ssh config file options inthe style documented in ssh_config(5). They will be passed to allautomatic invocations of ssh and scp by dput. Note that you candefine multiline (dput) configuration options by indenting the secondline 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 uploadedto the main 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. Updated by Thomas Viehmann <tvAATTbeamnet.de>.

Many other people have contributed to this code. See theThanks file.

COMMENTS

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

This document was created byman2html,using the manual pages.