'\" t
.\"     Title: dput
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 02/17/2024
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "DPUT" "1" "02/17/2024" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dput \- Debian package upload tool
.SH "SYNOPSIS"
.sp
\fBdput\fR [\-h] [\-d] [\-c FILE] [\-D] [\-e DAYS] [\-F] [\-f] [\-l] [\-U] [\-o] [\-O OVERRIDE] [\-S UNSET] [\-P] [\-s] [\-u] [\-v] [\-V] [HOST] CHANGES\-FILE [CHANGES\-FILE \&...]
.SH "DESCRIPTION"
.sp
dput\-ng is a Debian package upload tool which provides an easy to use interface to Debian (like) package archive hosting facilities\&. It allows anyone who works with Debian packages to upload their work to a remote service, including Debian\(cqs ftp\-master, mentors\&.debian\&.net, Launchpad or other package hosting facilities for Debian package maintainers\&.
.sp
\fIHOST\fR may optionally specify a target stanza from any configured configured profile which is selected as a upload target\&. If \fIHOST\fR is omitted a default host using the heuristic described below is selected\&.
.sp
The only mandatory argument is a \fICHANGES\-FILE\fR which is interpreted as a Debian package\&.changes file denoting the desired package to be uploaded\&.
.sp
Packages being uploaded already, but not processed yet can be removed later from the destination using \fBdcut\fR\&.
.SH "OPTIONS"
.PP
\fB\-c, \-\-config\fR=FILE
.RS 4
Configuration file to parse\&. This option will override all other configuration files\&.
.RE
.PP
\fB\-d, \-\-debug\fR
.RS 4
Enable debug messages\&. Repeat twice to increase the verbosity level\&.
.RE
.PP
\fB\-D, \-\-dinstall\fR
.RS 4
Ignored silently for compatibility with old\-style dput command lines\&. Please use a post\-upload hook or similar to reproduce this functionality\&.
.RE
.PP
\fB\-e, \-\-delayed\fR=DAYS
.RS 4
Upload to the delayed queue, instead of the usual incoming directory\&. This option takes an argument from 0 to 15 corresponding to the respective DELAYED queue\&.
.RE
.PP
\fB\-F, \-\-full\-upload\-log\fR
.RS 4
Write more verbose \&.upload logs\&. When set to, upload logs will include more details\&. This setting overrides profile defaults when provided\&.
.RE
.PP
\fB\-f, \-\-force\fR
.RS 4
Force an upload, even if the upload log exists already\&.
.RE
.PP
\fB\-l, \-\-lintian\fR
.RS 4
Run Lintian before uploading the package\&. Note, this option is deprecated\&. Profile targets have the ability to properly handle invoking lintian before pushing it to the remote host, such as the
\fBrun_lintian\fR
key\&.
.sp
.if n \{\
.RS 4
.\}
.nf
This option is a shortcut for \-\-override "run_lintian=true"
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-o, \-\-check\-only\fR
.RS 4
Only run pre\-upload checks for the package, do not actually upload\&. This is useful to help in testing new checks, or verifying the profile will work as expected\&.
.RE
.PP
\fB\-O, \-\-override\fR=OVERRIDE
.RS 4
Override profile key\&. This option takes the highest precedence and replaces any profile setting\&. Use this switch if you want to change a configured profile value without changing the profile itself\&.
.sp
.if n \{\
.RS 4
.\}
.nf
This option accepts any key which can be configured in a profile (see
*dput(5)*)\&. Sub keys are addressed using a dot notation\&. Keys are separated
using a equals sign ("=")\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
For example, to override the \*(Aqallow_dcut\*(Aq you may do:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-override "allow_dcut=true"
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
The \*(Aq\-\-override\*(Aq option may be repeated:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-override "check\-debs\&.enforce=debs" \-\-override "check\-debs\&.skip=false"
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
Providing the same key on the command line several times will be additive\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
Un\-setting a key entirely can be achieved using the \*(Aq\-S\*(Aq option\&. Such
overrides take no argument\&. Thus, the command line
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-override "allow_dcut=true" \-\-unset "run_lintian"
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
will set \*(Aqallow_dcut\*(Aq to \*(AqTRUE\*(Aq and revert the \*(Aqrun_lintian\*(Aq key to
whatever the internal default value is set\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-P, \-\-passive\fR
.RS 4
Force FTP passive mode when uploading the package through FTP\&. This option is deprecated \- please declare this in the target profile\&.
.sp
.if n \{\
.RS 4
.\}
.nf
This option is a shortcut for \-\-override "passive_ftp=true"
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-s, \-\-simulate\fR
.RS 4
Simulate the upload only\&. This runs all pre\-upload checks, initializes the upload handler but does not actually push any files to the remote host\&.
.sp
.if n \{\
.RS 4
.\}
.nf
This argument can be repeated twice in which case also the network
connection is set\-up (for example logging in through the FTP or SFTP
protocol) and tested for its functionality\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-S,\-\-unset\fR=OVERRIDE
.RS 4
Override the configured profile key by unsetting its value\&. See
\fB\-O\fR
for a full explanation of the behavior\&.
.RE
.PP
\fB\-U, \-\-no\-upload\-log\fR
.RS 4
Do not write a \&.upload log file after uploading\&.
.RE
.PP
\fB\-u, \-\-unchecked\fR
.RS 4
Do not check GnuPG signature\&. You may also set this in your profile with the
\fBallow_unsigned_uploads\fR
key\&.
.RE
.PP
\fB\-v, \-\-version\fR
.RS 4
Ignored silently for compatibility with old\-style dput command lines\&.
.RE
.PP
\fB\-V, \-\-check\-version\fR
.RS 4
Ignored silently for compatibility with old\-style dput command lines\&.
.RE
.PP
\fBHOST\fR
.RS 4
Target host to upload a package\&. This refers to any existing upload site, which either can be a section in old\-style
\fBdput\&.cf\fR
files, or alternatively any profile in a read
\fBdput\&.d\fR
directory\&. If
\fBHOST\fR
was not supplied, the (first) profile having the
default_host_main
flag set to a non\-empty string will be selected\&. If neither,
\fIHOST\fR
was present, nor any profile setting the upload host, dput\-ng scans for a profile called
\fIftp\-master\fR
which will be used on a successful look\-up\&.
.RE
.PP
\fBCHANGES\-FILE\fR
.RS 4
A Debian
package\&.changes
file\&. Arguments may be repeated several times to upload more than one package at once\&.
.RE
.SH "PROFILES"
.sp
Profiles may define upload \fIHOST\fR names, log\-in details and their required upload methods used to upload packages\&. Moreover, profiles define checks which are running before and after uploading\&. Their format is described in \fBdput(5)\fR\&.
.sp
Additionally, \fBdput\fR reads old\-style configuration files from INI style configuration files\&. This format is deprecated for use in dput\-ng and described in \fBdput\&.cf(5)\fR\&. In particular this configuration file format does not support all configurable settings which are specific to dput\-ng\&.
.sp
It is possible to run \fBdput\fR with any combination of new\-style and old\-style configuration files\&. When both types of files are present,
.SH "EXIT STATUS"
.PP
\fB0\fR
.RS 4
Success
.RE
.PP
\fB1\fR
.RS 4
A runtime check returned an error
.RE
.PP
\fB2\fR
.RS 4
An internal error was detected, for example while loading configuration files
.RE
.PP
\fB3\fR
.RS 4
An upload error was detected, for example a permission or authentication problem while uploading files
.RE
.SH "BUGS"
.sp
Report bugs to http://bugs\&.debian\&.org/cgi\-bin/pkgreport\&.cgi?pkg=dput\-ng
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
$ dput ppa:paultag/fluxbox fluxbox_1\&.3\&.2\-4~ppa1_source\&.changes
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ dput ftp\-master fbautostart_2\&.718281828\-1_amd64\&.changes
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ dput dput\-ng_0\&.9\&.5_amd64\&.changes
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ dput \-d \-d localhost node\-jslint_0\&.1\&.8\-1~wicked1_amd64\&.changes
.fi
.if n \{\
.RE
.\}
.SH "AUTHOR"
.sp
dput\-ng was originally written by Arno Töll <arno(a)debian\&.org> and Paul Richard I by the Grace of God of the United Kingdom of Debian and Ubuntu and of his other realms and territories King Head of the Fluxbox Window Manager Defender of the Faith Tagliamonte <paultag(a)debian\&.org>\&.
.SH "RESOURCES"
.sp
\fBdput(5)\fR, \fBdput\&.cf(5)\fR, \fBdcut(1)\fR, \fBdirt(1)\fR
.SH "COPYING"
.sp
Copyright \(co 2012 dput\-ng authors\&. Free use of this software is granted under the terms of the GNU General Public License (GPL) Version 2 or later\&.