1DPUT(1)                                                                DPUT(1)
2
3
4

NAME

6       dput - Debian package upload tool
7

SYNOPSIS

9       dput [-h] [-d] [-c FILE] [-D] [-e DAYS] [-F] [-f] [-l] [-U] [-o] [-O
10       OVERRIDE] [-S UNSET] [-P] [-s] [-u] [-v] [-V] [HOST] CHANGES-FILE
11       [CHANGES-FILE ...]
12

DESCRIPTION

14       dput-ng is a Debian package upload tool which provides an easy to use
15       interface to Debian (like) package archive hosting facilities. It
16       allows anyone who works with Debian packages to upload their work to a
17       remote service, including Debian’s ftp-master, mentors.debian.net,
18       Launchpad or other package hosting facilities for Debian package
19       maintainers.
20
21       HOST may optionally specify a target stanza from any configured
22       configured profile which is selected as a upload target. If HOST is
23       omitted a default host using the heuristic described below is selected.
24
25       The only mandatory argument is a CHANGES-FILE which is interpreted as a
26       Debian package.changes file denoting the desired package to be
27       uploaded.
28
29       Packages being uploaded already, but not processed yet can be removed
30       later from the destination using dcut.
31

OPTIONS

33       -c, --config=FILE
34           Configuration file to parse. This option will override all other
35           configuration files.
36
37       -d, --debug
38           Enable debug messages. Repeat twice to increase the verbosity
39           level.
40
41       -D, --dinstall
42           Ignored silently for compatibility with old-style dput command
43           lines. Please use a post-upload hook or similar to reproduce this
44           functionality.
45
46       -e, --delayed=DAYS
47           Upload to the delayed queue, instead of the usual incoming
48           directory. This option takes an argument from 0 to 15 corresponding
49           to the respective DELAYED queue.
50
51       -F, --full-upload-log
52           Write more verbose .upload logs. When set to, upload logs will
53           include more details. This setting overrides profile defaults when
54           provided.
55
56       -f, --force
57           Force an upload, even if the upload log exists already.
58
59       -l, --lintian
60           Run Lintian before uploading the package. Note, this option is
61           deprecated. Profile targets have the ability to properly handle
62           invoking lintian before pushing it to the remote host, such as the
63           run_lintian key.
64
65               This option is a shortcut for --override "run_lintian=true"
66
67       -o, --check-only
68           Only run pre-upload checks for the package, do not actually upload.
69           This is useful to help in testing new checks, or verifying the
70           profile will work as expected.
71
72       -O, --override=OVERRIDE
73           Override profile key. This option takes the highest precedence and
74           replaces any profile setting. Use this switch if you want to change
75           a configured profile value without changing the profile itself.
76
77               This option accepts any key which can be configured in a profile (see
78               *dput(5)*). Sub keys are addressed using a dot notation. Keys are separated
79               using a equals sign ("=").
80
81               For example, to override the 'allow_dcut' you may do:
82
83               --override "allow_dcut=true"
84
85               The '--override' option may be repeated:
86
87               --override "check-debs.enforce=debs" --override "check-debs.skip=false"
88
89               Providing the same key on the command line several times will be additive.
90
91               Un-setting a key entirely can be achieved using the '-S' option. Such
92               overrides take no argument. Thus, the command line
93
94               --override "allow_dcut=true" --unset "run_lintian"
95
96               will set 'allow_dcut' to 'TRUE' and revert the 'run_lintian' key to
97               whatever the internal default value is set.
98
99       -P, --passive
100           Force FTP passive mode when uploading the package through FTP. This
101           option is deprecated - please declare this in the target profile.
102
103               This option is a shortcut for --override "passive_ftp=true"
104
105       -s, --simulate
106           Simulate the upload only. This runs all pre-upload checks,
107           initializes the upload handler but does not actually push any files
108           to the remote host.
109
110               This argument can be repeated twice in which case also the network
111               connection is set-up (for example logging in through the FTP or SFTP
112               protocol) and tested for its functionality.
113
114       -S,--unset=OVERRIDE
115           Override the configured profile key by unsetting its value. See -O
116           for a full explanation of the behavior.
117
118       -U, --no-upload-log
119           Do not write a .upload log file after uploading.
120
121       -u, --unchecked
122           Do not check GnuPG signature. You may also set this in your profile
123           with the allow_unsigned_uploads key.
124
125       -v, --version
126           Ignored silently for compatibility with old-style dput command
127           lines.
128
129       -V, --check-version
130           Ignored silently for compatibility with old-style dput command
131           lines.
132
133       HOST
134           Target host to upload a package. This refers to any existing upload
135           site, which either can be a section in old-style dput.cf files, or
136           alternatively any profile in a read dput.d directory. If HOST was
137           not supplied, the (first) profile having the default_host_main flag
138           set to a non-empty string will be selected. If neither, HOST was
139           present, nor any profile setting the upload host, dput-ng scans for
140           a profile called ftp-master which will be used on a successful
141           look-up.
142
143       CHANGES-FILE
144           A Debian package.changes file. Arguments may be repeated several
145           times to upload more than one package at once.
146

PROFILES

148       Profiles may define upload HOST names, log-in details and their
149       required upload methods used to upload packages. Moreover, profiles
150       define checks which are running before and after uploading. Their
151       format is described in dput(5).
152
153       Additionally, dput reads old-style configuration files from INI style
154       configuration files. This format is deprecated for use in dput-ng and
155       described in dput.cf(5). In particular this configuration file format
156       does not support all configurable settings which are specific to
157       dput-ng.
158
159       It is possible to run dput with any combination of new-style and
160       old-style configuration files. When both types of files are present,
161

EXIT STATUS

163       0
164           Success
165
166       1
167           A runtime check returned an error
168
169       2
170           An internal error was detected, for example while loading
171           configuration files
172
173       3
174           An upload error was detected, for example a permission or
175           authentication problem while uploading files
176

BUGS

178       Report bugs to http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=dput-ng
179

EXAMPLES

181           $ dput ppa:paultag/fluxbox fluxbox_1.3.2-4~ppa1_source.changes
182
183           $ dput ftp-master fbautostart_2.718281828-1_amd64.changes
184
185           $ dput dput-ng_0.9.5_amd64.changes
186
187           $ dput -d -d localhost node-jslint_0.1.8-1~wicked1_amd64.changes
188

AUTHOR

190       dput-ng was originally written by Arno Töll <arno(a)debian.org> and
191       Paul Richard I by the Grace of God of the United Kingdom of Debian and
192       Ubuntu and of his other realms and territories King Head of the Fluxbox
193       Window Manager Defender of the Faith Tagliamonte
194       <paultag(a)debian.org>.
195

RESOURCES

197       dput(5), dput.cf(5), dcut(1), dirt(1)
198

COPYING

200       Copyright © 2012 dput-ng authors. Free use of this software is granted
201       under the terms of the GNU General Public License (GPL) Version 2 or
202       later.
203
204
205
206                                  07/19/2023                           DPUT(1)
Impressum