115 lines
3.7 KiB
Groff
115 lines
3.7 KiB
Groff
.TH DCMD 1 "Debian Utilities" "DEBIAN" \" -*- nroff -*-
|
|
.SH NAME
|
|
dcmd \- expand file lists of .dsc/.changes files in the command line
|
|
.SH SYNOPSIS
|
|
\fBdcmd\fR [\fIoptions\fR] [\fIcommand\fR] [\fIchanges-file\fR|\fIdsc-file\fR] ...
|
|
.SH DESCRIPTION
|
|
\fBdcmd\fR replaces any reference to a \fI.dsc\fR or \fI.changes\fR file in the
|
|
command line with the list of files in its 'Files' section, plus the
|
|
file itself. It allows easy manipulation of all the files involved in
|
|
an upload (for \fI.changes\fR files) or a source package (for \fI.dsc\fR files).
|
|
|
|
If \fIcommand\fR is omitted (that is the first argument is an existing \fI.dsc\fR
|
|
or \fI.changes\fR file), the expanded list of files is printed to stdout, one file
|
|
by line. Useful for usage in backticks.
|
|
.SH OPTIONS
|
|
There are a number of options which may be used in order to select only a
|
|
subset of the files listed in the \fI.dsc\fR or \fI.changes\fR file. If a requested file
|
|
is not found, an error message will be printed.
|
|
.TP 14
|
|
.B \-\-dsc
|
|
Select the \fI.dsc\fR file.
|
|
.TP
|
|
.B \-\-buildinfo
|
|
Select the \fI.buildinfo\fR file.
|
|
.TP
|
|
.B \-\-schanges
|
|
Select \fI.changes\fR files for the 'source' architecture.
|
|
.TP
|
|
.B \-\-bchanges
|
|
Select \fI.changes\fR files for binary architectures.
|
|
.TP
|
|
.B \-\-changes
|
|
Select \fI.changes\fR files. Implies \fB\-\-schanges\fR and \fB\-\-bchanges\fR.
|
|
.TP
|
|
.B \-\-archdeb
|
|
Select architecture-dependent binary packages (\fI.deb\fR files).
|
|
.TP
|
|
.B \-\-indepdeb
|
|
Select architecture-independent binary packages (\fI.deb\fR files).
|
|
.TP
|
|
.B \-\-deb
|
|
Select binary packages (\fI.deb\fR files). Implies \fB\-\-archdeb\fR and \fB\-\-indepdeb\fR.
|
|
.TP
|
|
.B \-\-archudeb
|
|
Select architecture-dependent \fI.udeb\fR binary packages.
|
|
.TP
|
|
.B \-\-indepudeb
|
|
Select architecture-independent \fI.udeb\fR binary packages.
|
|
.TP
|
|
.B \-\-udeb
|
|
Select \fI.udeb\fR binary packages. Implies \fB\-\-archudeb\fR and \fB\-\-indepudeb\fR.
|
|
.TP
|
|
.BR \-\-tar ,\ \-\-orig
|
|
Select the upstream \fI.tar\fR file.
|
|
.TP
|
|
.BR \-\-diff ,\ \-\-debtar
|
|
Select the Debian \fI.debian.tar\fR or \fI.diff\fR file.
|
|
.PP
|
|
Each option may be prefixed by \fB\-\-no\fR to indicate that all files
|
|
\fInot\fR matching the specification should be selected.
|
|
.PP
|
|
It is not possible to combine positive filtering options (e.g. \fB\-\-dsc\fR)
|
|
and negative filtering options (e.g. \fB\-\-no\-changes\fR) in the same
|
|
\fBdcmd\fR invocation.
|
|
.TP
|
|
.B \-\-no\-fail\-on\-missing\fR, \fB\-r
|
|
If any of the requested files were not found, do not output an error.
|
|
.TP
|
|
.B \-\-package\fR, \fB\-p
|
|
Output package name part only.
|
|
.TP
|
|
.B \-\-sort\fR, \fB\-s
|
|
Sort output alphabetically.
|
|
.TP
|
|
.B \-\-tac\fR, \fB\-t
|
|
Reverse output order.
|
|
|
|
.SH "EXAMPLES"
|
|
Copy the result of a build to another machine:
|
|
|
|
.nf
|
|
$ dcmd scp rcs_5.7-23_amd64.changes elegiac:/tmp
|
|
rcs_5.7-23.dsc 100% 490 0.5KB/s 00:00
|
|
rcs_5.7-23.diff.gz 100% 12KB 11.7KB/s 00:00
|
|
rcs_5.7-23_amd64.deb 100% 363KB 362.7KB/s 00:00
|
|
rcs_5.7-23_amd64.changes 100% 1095 1.1KB/s 00:00
|
|
$
|
|
|
|
$ dcmd \-\-diff \-\-deb scp rcs_5.7-23_amd64.changes elegiac:/tmp
|
|
rcs_5.7-23.diff.gz 100% 12KB 11.7KB/s 00:00
|
|
rcs_5.7-23_amd64.deb 100% 363KB 362.7KB/s 00:00
|
|
$
|
|
.fi
|
|
|
|
Check the contents of a source package:
|
|
|
|
.nf
|
|
$ dcmd md5sum rcs_5.7-23.dsc
|
|
8fd09ea9654cda128f8d5c337d3b8de7 rcs_5.7.orig.tar.gz
|
|
f0ceeae96603e823eacba6721a30b5c7 rcs_5.7-23.diff.gz
|
|
5241db1e231b1f43ae5514b63d2523f8 rcs_5.7-23.dsc
|
|
$
|
|
|
|
$ dcmd \-\-no\-diff md5sum rcs_5.7-23.dsc
|
|
8fd09ea9654cda128f8d5c337d3b8de7 rcs_5.7.orig.tar.gz
|
|
5241db1e231b1f43ae5514b63d2523f8 rcs_5.7-23.dsc
|
|
$
|
|
.fi
|
|
|
|
.SH "SEE ALSO"
|
|
.BR dpkg-genchanges (1),
|
|
.BR dpkg-source (1)
|
|
.SH AUTHOR
|
|
This program was written by Romain Francoise <rfrancoise@debian.org> and
|
|
is released under the GPL, version 2 or later.
|