1DPUT(1) DPUT(1)
2
3
4
6 dput - Debian package upload tool
7
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
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
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
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
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
178 Report bugs to http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=dput-ng
179
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
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
197 dput(5), dput.cf(5), dcut(1), dirt(1)
198
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 01/31/2019 DPUT(1)