1DCUT(1) DCUT(1)
2
6 dcut - Debian archive command file upload tool
7
9 dcut [-h] [-d] [-c FILE] [-m MAINTAINER] [-k KEYID] [-O FILENAME] [-P]
10 [-s] [-U FILENAME] [-i FILENAME] [-v] [HOST] SUBCOMMAND ...
11 dcut [OPTIONS] [HOST] SUBCOMMAND [SUB-COMMAND OPTIONS]
13
15 dcut can create and/or upload command files understood by the debian
16 archive kit ("dak") software. It provides an extensible interface so
17 that third party authors can easily integrate more sub-commands. Hence,
18 your running instance of dcut may understand more commands than these
19 documented here. Refer to the respective documentations for these
20 commands.
21 Similar to dput, a HOST can be specified as a target site for the
23 command file. Likewise, the same default host selection criteria apply.
24 It also parses the same configuration files described there.
25 It should be noted that this does not support the same interface as the
27 old dput binary. Please be sure to double-check scripts that depend on
28 old-style dput’s interface.
29
31 -c, --config=FILE
32 Configuration file to parse.
33 -d, --debug
35 Enable debug messages. Repeat twice to increase the verbosity
36 level.
37 -f, --force
39 Bypass all sanity checks and upload the commands file as is. Use
40 with caution.
41 -m, --maintainer=MAINTAINER
43 Use MAINTAINER for the uploader field and GnuPG key selection.
44 Provide it as a full identity, that is in "J Uploader
45 <yourid@example.com>" format. This has no effect when the upload
46 command is used.
47 -k, --keyid=KEYID
49 Use KEYID as a key for signing. Default is to use DEBEMAIL and
50 DEBFULLNAME, or whatever identity was provided with --maintainer.
51 This has no effect when the upload command is used.
52 -O, --output=FILENAME
54 Write the resulting commands file to FILENAME instead of uploading
55 it. This option should not be used with the upload command. The
56 selected FILENAME won’t be overwritten if it exists already. This
57 is very helpful for testing that things work correctly.
58 -P, --passive
60 Force FTP passive mode when uploading the package through FTP. This
61 option is deprecated - use profiles instead.
62 -s, --simulate
64 Simulate the upload only. This runs all pre-upload checks,
65 initializes the upload handler but does not actually store any
66 file.
67 -i, --input=FILENAME
69 Ignored silently for compatibility with old-style dput command
70 lines.
71 -v, --version
73 Print version information and exit
74 HOST
76 Target host to upload a package. It has the same behavior and
77 semantics as dput(1)s 'HOST argument. It also uses the same
78 profiles from it.
79
81 Sub-commands are actually implementing commands understood by be
82 archive software. They can take individual arguments which must appear
83 after specifying the actual desired sub-command.
84 cancel
86 Cancel an upload entirely. The upload is referred to as a changes file
87 name existing remote in the incoming or deferred queues.
88 OPTIONS
90 Takes one argument
91 -f, --file=FILENAME
93 The changes file name which refers to the upload to be
94 cancelled.
95 rm
97 Remove a lost or wrongly uploaded file from the incoming directory. The
98 argument is interpreted as a path fragment by the archive software.
99 Therefore, to delete a filename from a deferred queue, refer to it by
100 using the full path
101 For example, to delete a broken upload in the DELAYED queue, use the
103 command
104 dcut rm -f DELAYED/X-day/foobar.deb
106 Alternatively, the --searchdirs argument instructs the archive software
108 to search for a file name in all directory. Hence, this command is
109 equivalent to the command before:
110 dcut rm --searchdirs -f foobar.deb
112 OPTIONS
114 Takes at least one argument
115 -f, --file=FILENAME
117 The file name to be removed. This argument can be repeated, and
118 also knows about the shell wildcards *, ?, and []. However,
119 please keep your local shell replacements in mind when
120 supplying shell meta characters. You may need to escape them or
121 provide them within quotes.
122 --searchdirs
124 Search in all directories for the given file. Only supported
125 for files in the DELAYED queue.
126 dm
128 Manage Debian Maintainer (DM) upload permissions. Debian Developers can
129 grant or revoke them package upload permissions using this command.
130 Takes the Debian Maintainer and the action to perform as argument.
131 Note, dcut will not perform any validation for conflicting arguments
133 within --allow and --deny below. This handling is left to the archive
134 software, which is currently processing --allow before --deny as an
135 implementation detail.
136 OPTIONS
138 --uid
139 Any searchable, unique identity to identify an existing Debian
140 Maintainer. This can be a (full) name an e-mail address or a
141 GnuPG fingerprint of any existing Debian Maintainer. Note, the
142 identity provided must be known in the DM keyring installed on
143 your local system. The keyring is used to validate the supplied
144 argument and makes sure the identity hint supplied matches
145 exactly one DM. If the user you want to change ACLs on is not
146 known to the local DM keyring, you can provide the full GPG
147 user ID as argument, and pass --force, to cause dcut to bypass
148 any argument checking/translation. Please note, this will
149 generate a commands file which will be uploaded literally as
150 is. Use with caution.
151 --allow=PACKAGE
153 --allow PACKAGE LIST
155 Source package(s) where permissions to upload should be
156 granted. Give a space-separated list of packages to apply
157 permissions to more than one package at once. If multiple
158 --allow options are given, the last one takes precedence.
159 --deny=PACKAGE
161 --deny PACKAGE LIST
163 Source package(s) where permissions to upload should be denied.
164 Give a space-separated list of packages to apply permissions to
165 more than one package at once. If multiple --deny options are
166 given, the last one takes precedence.
167 reschedule
169 Reschedule an upload. This command can move a deferred upload to any
170 other deferred queue.
171 OPTIONS
173 Takes two arguments
174 -f, --file=FILENAME
176 file name to be rescheduled
177 -d, --days=DAYS
179 Reschedule the upload to DAYS days. Takes a numeric argument
180 from 0 to 15 corresponding to the respective delayed queues.
181 Note, 0-day is not the same as uploading to incoming straight.
182 upload
184 This is a pseudo-command (that is, it is handled within dcut and not
185 forwarded to the archive kit) which uploads a locally existing commands
186 file as is.
187 However, no checks are performed for this file. Use with caution.
189 OPTIONS
191 Takes one argument
192 -f, --file=FILENAME
194 A local file name which is uploaded as is to the archive
195 software.
196
198 0
199 Success
200 1
202 A runtime check returned an error
203 2
205 An internal error was detected, for example while loading
206 configuration files
207 3
209 An upload error was detected, for example a permission or
210 authentication problem while uploading files
211
213 Report bugs to http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=dput-ng
214
216 $ dcut dm --uid "Paul Tagliamonte" --allow glibc
217 $ dcut dm --uid 0x0DEFACED --allow linux --deny kfreebsd9
219 $ dcut dm --uid paul@example.com --allow eglibc linux
221 $ dcut rm --searchdirs -f udj-desktop-client_0.5.1-2_amd64.deb
223 $ dcut ftp-master rm -f 'linux*.deb'
225
227 dput-ng was originally written by Arno Töll <arno(a)debian.org> and
228 Paul Richard I by the Grace of God of the United Kingdom of Debian and
229 Ubuntu and of his other realms and territories King Head of the Fluxbox
230 Window Manager Defender of the Faith Tagliamonte
231 <paultag(a)debian.org>.
232
234 dput(5), dput.cf(5), dcut(1), gpg(1), dirt(1)
235
237 Copyright © 2012 dput-ng authors. Free use of this software is granted
238 under the terms of the GNU General Public License (GPL) Version 2 or
239 later.
240 07/19/2023 DCUT(1)