.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "APT-RDEPENDS 1"
.TH APT-RDEPENDS 1 "2016-12-26" "1.3.0" " "
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
apt\-rdepends \- performs recursive dependency listings similar to apt\-cache
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
apt-rdepends [options] [\fIpkgs\fR ...]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBapt-rdepends\fR searches through the \s-1APT\s0 cache to find package
dependencies.  \fBapt-rdepends\fR knows how to emulate the result
of calling \fBapt-cache\fR with both \fIdepends\fR and \fIdotty\fR
options.
.PP
By default, \fBapt-rdepends\fR shows a listing of each dependency
a package has.  It will also look at each of these fulfilling packages,
and recursively lists their dependencies.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-b\fR, \fB\-\-build\-depends\fR" 8
.IX Item "-b, --build-depends"
Show build dependencies instead of normal package dependencies.
.IP "\fB\-d\fR, \fB\-\-dotty\fR" 8
.IX Item "-d, --dotty"
dotty takes a list of packages on the command line and generates
output suitable for use by springgraph (1). The result will be a set of
nodes and edges representing the relationships between the
packages. By default the given packages will trace out all dependent
packages which can produce a very large graph.
.Sp
Blue lines are pre-depends, green lines are conflicts, yellow lines
are suggests, orange lines are recommends, red lines are replaces,
and black lines are depends.
.Sp
Caution, dotty cannot graph larger sets of packages.
.IP "\fB\-p\fR, \fB\-\-print\-state\fR" 8
.IX Item "-p, --print-state"
Shows the state of each dependency after each package version.
See \fB\-\-state\-follow\fR and \fB\-\-state\-show\fR for why this is useful.
.IP "\fB\-r\fR, \fB\-\-reverse\fR" 8
.IX Item "-r, --reverse"
Shows the listings of each package that depends on a package.
Furthermore, it will look at these dependent packages, and find their
dependers.
.IP "\fB\-f\fR, \fB\-\-follow=\fR\fI\s-1DEPENDS\s0\fR" 8
.IX Item "-f, --follow=DEPENDS"
A comma-separated list of \fI\s-1DEPENDS\s0\fR types to follow recursively.
By default, it only follows the \fIDepends\fR and \fIPreDepends\fR types.
.Sp
The possible values for \fI\s-1DEPENDS\s0\fR are: \fIDepends\fR, \fIPreDepends\fR,
\&\fISuggests\fR, \fIRecommends\fR, \fIConflicts\fR, \fIReplaces\fR, and
\&\fIObsoletes\fR.
.Sp
In \fB\-\-build\-depends\fR mode, the possible values are: \fIBuild-Depends\fR,
\&\fIBuild-Depends-Indep\fR, \fIBuild-Conflicts\fR, \fIBuild-Conflicts-Indep\fR.
.IP "\fB\-s\fR, \fB\-\-show=\fR\fI\s-1DEPENDS\s0\fR" 8
.IX Item "-s, --show=DEPENDS"
A comma-separated list of \fI\s-1DEPENDS\s0\fR types to show, when displaying
a listing.  By default, it only shows the \fIDepends\fR and \fIPreDepends\fR types.
.IP "\fB\-\-state\-follow=\fR\fI\s-1STATES\s0\fR" 8
.IX Item "--state-follow=STATES"
.PD 0
.IP "\fB\-\-state\-show=\fR\fI\s-1STATES\s0\fR" 8
.IX Item "--state-show=STATES"
.PD
These two options are similar to \fB\-\-follow\fR and \fB\-\-show\fR.  They both
deal with the current state of a package.  By default, the value of
\&\fI\s-1STATES\s0\fR is \fIUnknown\fR, \fINotInstalled\fR, \fIUnPacked\fR, \fIHalfConfigured\fR,
\&\fIHalfInstalled\fR, \fIConfigFiles\fR, and \fIInstalled\fR.
.Sp
These options are useful, if you only want to only look at the
dependencies between the \fIInstalled\fR packages on your system.  You
can then call:
.RS 8
.Sp
.RS 4
apt-rdepends \-\-state\-follow=Installed libfoo
.RE
.RE
.RS 8
.Sp
Or if you want to only show the packages installed on your system:
.Sp
.RS 4
apt-rdepends \-\-state\-follow=Installed \-\-state\-show=Installed libfoo
.RE
.RE
.RS 8
.RE
.IP "\fIpkgs\fR" 8
.IX Item "pkgs"
The list of packages on which to discover dependencies.
.IP "\fB\-v\fR, \fB\-\-vcg\fR, \fB\-\-xvcg\fR" 8
.IX Item "-v, --vcg, --xvcg"
This option takes a list of packages on the command line and generates
output suitable for use by xvcg.  The result will be a set of
nodes and edges representing the relationships between the
packages. By default the given packages will trace out all dependent
packages which can produce a very large graph.
.Sp
Blue lines are pre-depends, green lines are conflicts, yellow lines
are suggests, orange lines are recommends, red lines are replaces,
and black lines are depends.
.IP "\fB\-o\fR, \fB\-\-option=\fR\fI\s-1OPTION\s0\fR" 8
.IX Item "-o, --option=OPTION"
Set an \s-1APT\s0 Configuration Option; This will set an arbitrary configuration
option. The syntax is \fB\-o Foo::Bar=bar\fR.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIapt.conf\fR(5), \fIsources.list\fR(5), \fBapt-cache\fR(8), \fIAptPkg\fR(3),
\&\fIspringgraph\fR(1)
.SH "BUGS"
.IX Header "BUGS"
\&\fBapt-rdepends\fR does not emulate \fBapt-cache\fR perfectly.  It does
not display information about virtual packages, nor does it know about
virtual packages when it is in reverse dependency mode.
.PP
\&\fBapt-rdepends\fR also does not know how to stop after a certain depth
has been reached.
.PP
\&\fBapt-rdepends\fR cannot do reverse build-dependencies.  This is really
difficult, since it would have to load the whole cache into memory
before discovering which packages depend on others to build.
.PP
\&\fBapt-rdepends\fR exists.  This functionality should really reside in
\&\fBapt-cache\fR itself.
.SH "AUTHOR"
.IX Header "AUTHOR"
\&\fBapt-rdepends\fR was written by Simon Law <sfllaw@debian.org>