1DCUT(1)                                                                DCUT(1)
2
3
4

NAME

6       dcut - Debian archive command file upload tool
7

SYNOPSIS

9       dcut [-h] [-d] [-c FILE] [-m MAINTAINER] [-k KEYID] [-O FILENAME] [-P]
10       [-s] [-U FILENAME] [-i FILENAME] [-v] [HOST] SUBCOMMAND ...
11
12       dcut [OPTIONS] [HOST] SUBCOMMAND [SUB-COMMAND OPTIONS]
13

DESCRIPTION

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
22       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
26       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

OPTIONS

31       -c, --config=FILE
32           Configuration file to parse.
33
34       -d, --debug
35           Enable debug messages. Repeat twice to increase the verbosity
36           level.
37
38       -f, --force
39           Bypass all sanity checks and upload the commands file as is. Use
40           with caution.
41
42       -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
48       -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
53       -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
59       -P, --passive
60           Force FTP passive mode when uploading the package through FTP. This
61           option is deprecated - use profiles instead.
62
63       -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
68       -i, --input=FILENAME
69           Ignored silently for compatibility with old-style dput command
70           lines.
71
72       -v, --version
73           Print version information and exit
74
75       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

SUB-COMMANDS

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
85   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
89       OPTIONS
90           Takes one argument
91
92           -f, --file=FILENAME
93               The changes file name which refers to the upload to be
94               cancelled.
95
96   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
102       For example, to delete a broken upload in the DELAYED queue, use the
103       command
104
105           dcut rm -f DELAYED/X-day/foobar.deb
106
107       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
111           dcut rm --searchdirs -f foobar.deb
112
113       OPTIONS
114           Takes at least one argument
115
116           -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
123           --searchdirs
124               Search in all directories for the given file. Only supported
125               for files in the DELAYED queue.
126
127   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
132       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
137       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
152           --allow=PACKAGE
153
154           --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
160           --deny=PACKAGE
161
162           --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
168   reschedule
169       Reschedule an upload. This command can move a deferred upload to any
170       other deferred queue.
171
172       OPTIONS
173           Takes two arguments
174
175           -f, --file=FILENAME
176               file name to be rescheduled
177
178           -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
183   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
188       However, no checks are performed for this file. Use with caution.
189
190       OPTIONS
191           Takes one argument
192
193           -f, --file=FILENAME
194               A local file name which is uploaded as is to the archive
195               software.
196

EXIT STATUS

198       0
199           Success
200
201       1
202           A runtime check returned an error
203
204       2
205           An internal error was detected, for example while loading
206           configuration files
207
208       3
209           An upload error was detected, for example a permission or
210           authentication problem while uploading files
211

BUGS

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

EXAMPLES

216           $ dcut dm --uid "Paul Tagliamonte" --allow glibc
217
218           $ dcut dm --uid 0x0DEFACED --allow linux --deny kfreebsd9
219
220           $ dcut dm --uid paul@example.com --allow eglibc linux
221
222           $ dcut rm --searchdirs -f udj-desktop-client_0.5.1-2_amd64.deb
223
224           $ dcut ftp-master rm -f 'linux*.deb'
225

AUTHOR

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

RESOURCES

234       dput(5), dput.cf(5), dcut(1), gpg(1), dirt(1)
235

COPYING

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
241
242
243                                  01/28/2020                           DCUT(1)
Impressum