130 lines
4.8 KiB
Groff
130 lines
4.8 KiB
Groff
.TH DPKG-DEPCHECK "1" "March 2002" "dpkg-depcheck" DEBIAN
|
|
.SH NAME
|
|
dpkg-depcheck \- determine packages used to execute a command
|
|
.SH SYNOPSIS
|
|
\fBdpkg-depcheck\fR [\fIoptions\fR] \fIcommand\fR
|
|
.SH DESCRIPTION
|
|
This program runs the specified command under \fBstrace\fR and then
|
|
determines and outputs the packages used in the process. The list can
|
|
be trimmed in various ways as described in the options below. A good
|
|
example of this program would be the command \fBdpkg-depcheck \-b
|
|
debian/rules build\fR, which would give a good first approximation to
|
|
the Build-Depends line needed by a Debian package. Note, however,
|
|
that this does \fInot\fR give any direct information on versions
|
|
required or architecture-specific packages.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-a ", " \-\-all
|
|
Report all packages used to run \fIcommand\fR. This is the default
|
|
behaviour. If used in conjunction with \fB\-b\fR, \fB\-d\fR or
|
|
\fB\-m\fR, gives additional information on those packages skipped by
|
|
these options.
|
|
.TP
|
|
.BR \-b ", " \-\-build-depends
|
|
Do not report any build-essential or essential packages used, or any
|
|
of their (direct or indirect) dependencies.
|
|
.TP
|
|
.BR \-d ", " \-\-ignore-dev-deps
|
|
Do not show packages used which are direct dependencies of \fI\-dev\fR
|
|
packages used. This implies \fB\-b\fR.
|
|
.TP
|
|
.BR \-m ", " \-\-min-deps
|
|
Output a minimal set of packages needed, taking into account direct
|
|
dependencies. Using \fB\-m\fR implies \fB\-d\fR and also \fB\-b\fR.
|
|
.TP
|
|
.BR \-C ", " \-\-C-locale
|
|
Run \fIcommand\fR with the C locale.
|
|
.TP
|
|
.BR \-\-no-C-locale
|
|
Don't change locale when running \fIcommand\fR.
|
|
.TP
|
|
.BR \-l ", " \-\-list-files
|
|
Also report the list of files used in each package.
|
|
.TP
|
|
.BR \-\-no-list-files
|
|
Do not report the files used in each package. Cancels a \fB\-l\fR
|
|
option.
|
|
.TP
|
|
\fB\-o\fR, \fB\-\-output=\fIFILE\fR
|
|
Output the package diagnostics to \fIFILE\fR instead of stdout.
|
|
.TP
|
|
\fB\-O\fR, \fB\-\-strace-output=\fIFILE\fR
|
|
Write the \fBstrace\fR output to \fIFILE\fR when tracing \fIcommand\fR
|
|
instead of using a temporary file.
|
|
.TP
|
|
\fB\-I\fR, \fB\-\-strace-input=\fIFILE\fR
|
|
Get \fBstrace\fR output from \fIFILE\fR instead of tracing
|
|
\fIcommand\fR; \fBstrace\fR must have be run with the \fB\-f \-q\fR
|
|
options for this to work.
|
|
.TP
|
|
\fB\-f\fR, \fB\-\-features=\fILIST\fR
|
|
Enable or disabled features given in the comma-separated \fILIST\fR as
|
|
follows. A feature is enabled with \fI+feature\fR or just
|
|
\fIfeature\fR and disabled with \fI\-feature\fR. The currently
|
|
recognised features are:
|
|
.PD 0
|
|
.RS
|
|
.TP
|
|
.B warn\-local
|
|
Warn if files in \fI/usr/local\fR or \fI/var/local\fR are used.
|
|
Enabled by default.
|
|
.TP
|
|
.B discard-check-version
|
|
Discards \fIexecve\fR when only a \fI\-\-version\fR argument is given
|
|
to the program; this works around some configure scripts that check
|
|
for binaries they don't actually use. Enabled by default.
|
|
.TP
|
|
.B trace-local
|
|
Also try to identify files which are accessed in \fI/usr/local\fR and
|
|
\fI/var/local\fR. Not usually very useful, as Debian does not place
|
|
files in these directories. Disabled by default.
|
|
.TP
|
|
.B catch-alternatives
|
|
Warn about access to files controlled by the Debian \fIalternatives\fR
|
|
mechanism. Enabled by default.
|
|
.TP
|
|
.B discard-sgml-catalogs
|
|
Discards access to SGML catalogs; some SGML tools read all the registered
|
|
catalogs at startup. Files matching the regexp /usr/share/sgml/.*\\.cat are
|
|
recognised as catalogs. Enabled by default.
|
|
.PD
|
|
.RE
|
|
.TP
|
|
\fB\-\-no-conf\fR, \fB\-\-noconf\fR
|
|
Do not read any configuration files. This can only be used as the
|
|
first option given on the command-line.
|
|
.TP
|
|
.BR \-h ", " \-\-help
|
|
Display usage information and exit.
|
|
.TP
|
|
.BR \-v ", " \-\-version
|
|
Display version and copyright information and exit.
|
|
.SH "CONFIGURATION VARIABLES"
|
|
The two configuration files \fI/etc/devscripts.conf\fR and
|
|
\fI~/.devscripts\fR are sourced in that order to set configuration
|
|
variables. Command line options can be used to override configuration
|
|
file settings. Environment variable settings are ignored for this
|
|
purpose. The currently recognised variable is:
|
|
.TP
|
|
.B DPKG_DEPCHECK_OPTIONS
|
|
These are options which are parsed before the command-line options.
|
|
For example,
|
|
.IP
|
|
DPKG_DEPCHECK_OPTIONS="\-b \-f-catch-alternatives"
|
|
.IP
|
|
which passes these options to \fBdpkg-depcheck\fR before any
|
|
command-line options are processed. You are advised not to try tricky
|
|
quoting, because of the vagaries of shell quoting!
|
|
.SH "SEE ALSO"
|
|
.BR dpkg (1),
|
|
.BR strace (1),
|
|
.BR devscripts.conf (5),
|
|
.BR update-alternatives (8)
|
|
.SH "COPYING"
|
|
Copyright 2001 Bill Allombert <ballombe@debian.org>.
|
|
Modifications copyright 2002,2003 Julian Gilbey <jdg@debian.org>.
|
|
\fBdpkg-depcheck\fR is free software, covered by the GNU General
|
|
Public License, version 2 or (at your option) any later version,
|
|
and you are welcome to change it and/or distribute copies of it under
|
|
certain conditions. There is absolutely no warranty for
|
|
\fBdpkg-depcheck\fR.
|