DPUT(1) General Commands Manual DPUT(1)
NAME
dput - Debian package upload tool
SYNOPSIS
dput [-DPUVdflosu] [-c CONFIGFILE] [-e DAYS] [HOSTNAME] CHANGESFILE ...
dput [-d] [-c CONFIGFILE] -H
dput [-d] [-c CONFIGFILE] -p
dput -h
dput -v
DESCRIPTION
Upload, to the Debian package upload queue, the files constituting the
package specified in each CHANGESFILE.
A Debian package release comprises several files, specified in the
CHANGESFILE for that release. The Debian Package Upload Tool (dput)
performs several verification checks on the package, then (if the veri-
fications succeed) uploads those files to the remote Debian package
repository. See VERIFICATION CHECKS, below, for a description of the
checks dput can perform on each package.
HOSTNAME is a name matching a host section in the dput.cf(5) configura-
tion. If not specified, HOSTNAME defaults to the value of the de-
fault_host_main configuration parameter.
The file transfer method is determined by the method configuration pa-
rameter for the specified host. See dput.cf(5) for the set of supported
method values.
If the configuration specifies a pre_upload_command for the remote
host, execute a shell subprocess for that command before attempting to
upload each package.
If the configuration specifies a post_upload_command for the remote
host, execute a shell subprocess for that command after each successful
package upload.
VERIFICATION CHECKS
Each package release, as specified by a CHANGESFILE, is checked to see
whether it is suitable for upload. The following checks are available:
Unique upload
The package should not already have been uploaded to the remote
host HOSTNAME.
Check for the log file created when dput successfully uploads a
package. If the corresponding log file already exists, abort the
upload attempt. This is unique only for the combination of lo-
cal machine (where the upload log is recorded), the CHANGESFILE
name, and the remote HOSTNAME.
This check is disabled if the --force option is specified.
Required package files
The package should comprise the required files for the type of
package.
If this is a source package release, and the required source
control file (….dsc) is not part of the package, abort the up-
load attempt.
If this is a source package release, and the version string im-
plies that this is the first Debian release for this version,
and the corresponding source tarball is not part of the package,
abort the upload attempt.
If the package contains the upstream source tarball, but this is
not required for this release, emit a warning that the upload
might be rejected by the remote host.
If the package contains the Debian-native source tarball, but
this is not required for this release, emit a warning that the
upload might be rejected by the remote host.
Successful local install
The package should be successfully installed on the local sys-
tem.
If this is a binary package release, and each binary package
(….deb file) is not successfully installed on the local system
at the specified version, abort the upload.
This check is disabled by default. It is enabled when the con-
figuration parameter check_version is true.
Cryptographic signature
The GnuPG signature on the CHANGESFILE should match that file's
contents. If this is a source package release, the GnuPG signa-
ture on the source control file (….dsc) should match that file's
contents.
If GnuPG does not report a good signature for these files, abort
the upload.
This check is disabled when either the allow_unsigned_uploads
parameter is true, or the --check-only option is specified.
Package files content match
The computed size and hash values for each constituent file
should match the values specified in CHANGESFILE.
For each file size and hash value specified in CHANGESFILE, com-
pute the size and hash using the corresponding named file's con-
tents on the filesystem. If any computed size or hash value
does not match the corresponding value in CHANGESFILE, abort the
upload.
Distribution name is permitted for the remote host
The configuration for HOSTNAME should permit the distribution
name specified in the package.
If the package release's target Debian distribution name is not
one specified by the distributions parameter for the HOSTNAME,
abort the upload attempt. See dput.cf(5) for the distributions
parameter.
Lintian success
The package should get a successful report from Lintian.
Invoke the Lintian tool to check the package described by
CHANGESFILE. If the check is unsuccessful (exit status non-
zero), abort the upload attempt.
This check is disabled by default. It is enabled when the con-
figuration parameter run_lintian is true, or the --lintian op-
tion is specified.
OPTIONS
-c CONFIGFILE
--config CONFIGFILE
Use the file CONFIGFILE for configuration. See dput.cf(5) for
the specification of this file format.
-d
--debug
Display debugging messages.
-D
--dinstall
Request a dry run of dinstall on the remote host after the up-
load.
-f
--force
Disable the check for a unique upload. See VERIFICATION CHECKS,
above, for a description of this check.
-h
--help Display help information, then exit.
-H
--host-list
Display the lists of hosts known to the configuration, then
exit. See dput.cf(5) for the specification of hosts.
-l
--lintian
Enable the Lintian verification check, and exit if the check
fails. See VERIFICATION CHECKS, above, for a description of
this check.
-U
--no-upload-log
Do not write a log file when uploading files.
This omits the record used later for checking whether an upload
is unique. See VERIFICATION CHECKS, above, for a description of
this check.
-o
--check-only
Do not upload the files, and disable the checks for unique up-
load and cryptographic signature. See VERIFICATION CHECKS,
above, for a description of these checks.
-p
--print
Display the configuration that dput is using, then exit. See
dput.cf(5) for the configuration format.
-P
--passive
Use passive mode for FTP. If not specified, default for FTP is
active mode.
-s
--simulate
Do not actually upload to the remote host.
-u
--unchecked
Disable the check for cryptographic signature. See VERIFICATION
CHECKS, above, for a description of this check.
-e DAYS
--delayed DAYS
Upload to a DELAYED queue, rather than the usual Incoming. This
takes a DAYS argument from 0 to 15. Note that a delay of 0 is
different from no delay at all.
-v
--version
Display version information, then exit.
-V
--check-version
Enable the check for successful local install. See VERIFICATION
CHECKS, above, for a description of this check.
ENVIRONMENT
USER If no username is specified for authenticating to the remote
host, use the value of this variable.
FILES
Configuration
See dput.cf(5) for the files to configure dput.
path/basename.HOSTNAME.upload
The log file that contains a record of the successful upload to
HOSTNAME.
path is the directory path of CHANGESFILE.
basename is derived from the CHANGESFILE filename, by removing
the directory path and the .changes suffix.
SEE ALSO
dput.cf(5), dcut(1), lintian(1)
‘dput’ package documentation ⟨file:///usr/share/doc/dput/⟩, ‘dput’
program files ⟨file:///usr/share/dput/⟩.
Debian 2016-12-31 DPUT(1)
Generated by dwww version 1.15 on Wed Jun 26 14:48:09 CEST 2024.