File: dcut.1

package info (click to toggle)
dput 0.9.6.1%2Bsqueeze1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 232 kB
  • ctags: 109
  • sloc: python: 1,487; makefile: 61; sh: 24
file content (189 lines) | stat: -rw-r--r-- 5,684 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
.\" Hey, Emacs!  This is an -*- nroff -*- source file.
.TH dcut 1 "January 2004"
.SH NAME
.B dcut
\- Debian archive .commands file upload tool
.SH SYNTAX
.B dcut
[\fIoptions\fR]
[\fIhost\fR]
[\fIcommand\fR [\fB,\fR \fIcommand\fR]]
.P
.B dcut
\fB-U\fR \fIfilename\fR
[\fIhost\fR]
.SH DESCRIPTION
dcut creates and / or uploads .commands files for the Debian FTP
archive upload queue.
It is a companion for \fBdput\fR and uses dput configuration files.
As with dput, you can specify a
.I host
defined in the dput configuration file. In case your host is
funnily named, i.e. it could mistaken for a command, you may also use
a command line option to specify the host.
In default operation mode (unless you request to upload an existing
file), the host description is followed by a comma-seperated list of
commands. (Semicolons also work but require shell escaping.)
.SH COMMANDS
Presently supported commands are \fBrm\fR, \fBreschedule\fR and
\fBcancel\fR. \fBrm\fR can be used to remove files from the
UploadQueue directories. \fBdcut\fR generates commands that
search the subdirectories automaticall, but you can also
specify \fB--nosearchdirs\fR and then target individual
UploadQueue directories, i.e. either filenames without path for
regular incoming or \fBDELAYED/#-day/filename\fR. Wildcards
are accepted. \fBreschedule changes-file #-day\fR can be used
to move an upload from any \fBDEFERRED\fR queue to
\fB#-day\fR (use \fB0-day\fR for immediate processing).
\fBcancel changes-file\fR cancels an upload from \fBDEFERRED\fR.
Both \fBreschedule\fR and \fBcancel\fR take a complete basename
of a changes file as argument and operate on the whole upload,
they process the changes and all files mentioned by it.
The authorative documentation for the commands interface
can be found at
"ftp://ftp.upload.debian.org/pub/UploadQueue/README".
.P
The options try to resemble dput's to the extent possible.
.P
Note that dcut calls debsign to sign any commands file generated.
In particular, debsign does basic syntax checking on the commands you
specify.
.SH OPTIONS
.TP
.B \-c \fIfilename\fR, \fB\-\-config\fR=\fIfilename\fR
Use config file \fIfilename\fR.
.TP
.B \-d, \-\-debug
Print debug messages.
.TP
.B \-h, \-\-help
Print help information and exit.
.TP
.B \-\-host=\fIhost\fR
Upload to \fIhost\fR (as found in the dput configuration).
Use this if your host is named like one of the commands.
.TP
.B \-m \fImaintainer\fR, \fB\-\-maintainer\fR=\fImaintainer\fR
Use \fImaintainer\fR for the uploader field and gpg key selection.
This has no effect when \fB--upload\fR is used.
.TP
.B \-k \fIkeyid\fR, \fB\-\-keyid\fR=\fIkeyid\fR
Use \fIkeyid\fR for signing. Default is to let \fBdebsign\fR choose a keyid.
This has no effect when \fB--upload\fR is used.
.TP
.B \-O \fIfilename\fR, \fB\-\-output\fR=\fIfilename\fR
Write commands file to \fIfilename\fR instead of uploading.
You sould not specify a host when using this option.
Also, this option should not be used with \fB--upload\fR.
Both \fIfilename\fR and \fIfilename\fB.asc\fR will be overwritten.
.TP
.B \-P, \-\-passive
Use passive ftp instead of active.
.TP
.B \-s, \-\-simulate
Simulate an upload only.
.TP
.B \-U \fIfilename\fR, \fB\-\-upload\fR=\fIfilename\fR
Upload commands file. Note: No checks (syntax or presence/validity of
signature) are currently performed.
.TP
.B \-i \fIfilename\fR, \fB\-\-input\fR=\fIfilename\fR
Read an input changes file to create a commands file that can remove
the files listed in the .changes file from the upload queue.
.TP
.B \-v, \-\-version
Print version information and exit.

.SH ENVIRONMENT
The program uses the environment variables DEBEMAIL or EMAIL and
DEBFULLNAME to populate the uploader field. Also, environment variables
may be used in search of a suitable place for temporary files.

.SH EXAMPLES
To upload a GPG signed commands file that removes dput_0.9.2.33_all.deb
file from the queue, one would have to do

.in +4n
.nf
$ dcut rm dput_0.9.2.33_all.deb
.fi

.in
This creates and uploads a commands file that looks like the following:
.nf

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Uploader: Foo Bar <foo@bar.org>
Commands:
 rm dput_0.9.2.33_all.deb


-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iEYEARECAAYKAkisYx0ACgkQ4eu+pS04mIfwLQCg85XVpae/LHLrbvzywcQNt9PS
ztsAoMgw6HjcI9flfmwjgMiapcu379Pu
=fjp0
-----END PGP SIGNATURE-----
.fi

To upload a GPG signed commands file that removes files named in
dput_0.9.4_i386.changes from the queue, one would have to do

.in +4n
.nf
$ dcut \-\-input dput_0.9.4_i386.changes
.fi

.in
This creates and uploads a commands file that looks like the following:
.nf

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Uploader: Foo Bar <foo@bar.org>
Commands:
 rm \-\-searchdirs dput_0.9.4.dsc
 rm \-\-searchdirs dput_0.9.4.tar.gz
 rm \-\-searchdirs dput_0.9.4_all.deb


-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iEYEARECAAYKAkisYx0ACgkQ4eu+pS04mIfwLQCg85XVpae/LHLrbvzywcQNt9PS
ztsAoMgw6HjcI9flfmwjgMiapcu379Pu
=fjp0
-----END PGP SIGNATURE-----
.fi

.SH LICENSE
This program is distributed under the terms of the Gnu General Public
License, Version 2 or later.

.SH BUGS
Please direct bug reports and comments to the author.
Your feedback is appreciated.
If you're using Debian packages, file bugs against the dput package.

.SH FILES
dcut makes use of the dput configuration files:
.TP
.I /etc/dput.cf
System dput configuration file.
.TP
.I ~/.dput.cf
User dput configuration file.

Much helpful input and some stolen code from dput author Christian Kurz.
.SH SEE ALSO
.BR dput (1),
.BR dput.cf (5)
.br
ftp://ftp.upload.debian.org/pub/UploadQueue/README

.SH AUTHOR
Thomas Viehmann <tv@beamnet.de>