aboutsummaryrefslogtreecommitdiff
blob: 2e1aab2f3f56a4fc94cc43444ba45361766b373f (plain)
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
.\" generated by mkman.py, please do NOT edit!
.TH qdepends "1" "May 2018" "Gentoo Foundation" "qdepends"
.SH NAME
qdepends \- show dependency info
.SH SYNOPSIS
.B qdepends
\fI[opts] <pkgname>\fR
.SH DESCRIPTION
The
.I qdepends
applet has a couple different modes.  Normally it is geared towards
answering the queries "what does package X depend on" and "what packages depend
on X".  Both can further be classified into build, run, and post dependencies.

By default, it will tell you the build time dependencies only (DEPEND).

Currently,
.I qdepends
will only query installed packages.  There is no support for
querying packages not yet installed (see \fBequery\fR(1) for that).

If there is no answer to your query (i.e. you've asked for a package that is not
installed, or a version that does not match), then you will get back no output.
.SH OPTIONS
.TP
\fB\-d\fR, \fB\-\-depend\fR
Show DEPEND info (default).
.TP
\fB\-r\fR, \fB\-\-rdepend\fR
Show RDEPEND info.
.TP
\fB\-p\fR, \fB\-\-pdepend\fR
Show PDEPEND info.
.TP
\fB\-k\fR \fI<arg>\fR, \fB\-\-key\fR \fI<arg>\fR
Advanced option to allow querying the VDB.  This option overrides
\fB\-d\fR, \fB\-r\fR, \fB\-p\fR or \fB\-a\fR.  \fI<arg>\fR can be
any key from Portage's VDB, e.g.\ any file from
var/db/pkg/<cat>/<pkg>/.
.TP
\fB\-Q\fR \fI<arg>\fR, \fB\-\-query\fR \fI<arg>\fR
Query reverse deps.  This basically reverses the search to any
package that references \fI<arg>\fR in DEPEND, RDEPEND or PDEPEND.
This can be useful to find consumers of a given package, e.g.\ to
search for packages that have \fIlogwatch\fR in their DEPEND.
.TP
\fB\-N\fR, \fB\-\-name\-only\fR
Only show category/package, instead of category/package-version.
.TP
\fB\-a\fR, \fB\-\-all\fR
Show *DEPEND, alias for \fB\-drp\fR.
.TP
\fB\-f\fR, \fB\-\-format\fR
Pretty-print DEPEND declaration to be used in an ebuild.  This
option initiates a very different mode of operation.  Instead of
printing searching through packages, it constructs a multi-line
statement in with shell syntax, to be used in an ebuild.  Each
argument is turned into a separate DEPEND variable declaration.  You
need to quote dependency strings in order for them to be printed as
a single dependency declaration.  When used with the \fB\-q\fR
option, only the pretty-printed dependency declaration is printed,
e.g.\ the DEPEND= part is skipped.
.TP
\fB\-\-root\fR \fI<arg>\fR
Set the ROOT env var.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
When in reverse dep mode, print the package or packages that matched
the query from the dependency line being searched.  This includes
specifiers and versions.
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Suppress DEPEND= output for \fB\-f\fR.
.TP
\fB\-C\fR, \fB\-\-nocolor\fR
Don't output color.
.TP
\fB\-h\fR, \fB\-\-help\fR
Print this help and exit.
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version and exit.
.SH "EXAMPLES"
For finding out what a particular package depends on for building, you could do:
.nf
	$ \fIqdepends nano\fR
	app-editors/nano-2.3.2: >=sys-libs/ncurses-5.9-r1[unicode] sys-apps/file ...
.fi
This tells us that we have \fIapp-editors/nano-2.3.2\fR installed and it depends
on ncurses (among other things).

Searching for packages that actually have nano in their RDEPEND:
.nf
	$ \fIqdepends -rQ nano\fR
	virtual/editor-0
.fi
Tells us that \fIvirtual/editor\fR depends on nano.  However, if we
wanted to know in what way a package specifically depends on another
package, one can use \fB\-v\fR.
.nf
	$ \fIqdepends -vrQ logrotate\fR
	sys-apps/portage-2.3.18: >=app-admin/logrotate-3.8.0
.fi
This way we can see there is a specific dependency expressed here.  If
the above had used \fI<logrotate-3\fR, for example, no matches would be
returned.  Not using any specifiers allows to reveal in what way a
dependency is expressed.
.SH "REPORTING BUGS"
Please report bugs via http://bugs.gentoo.org/
.br
Product: Portage Development; Component: Tools, Assignee:
portage-utils@gentoo.org
.SH AUTHORS
.nf
Ned Ludd <solar@gentoo.org>
Mike Frysinger <vapier@gentoo.org>
Fabian Groffen <grobian@gentoo.org>
.fi
.SH "SEE ALSO"
.BR q (1),
.BR qatom (1),
.BR qcache (1),
.BR qcheck (1),
.BR qfile (1),
.BR qgrep (1),
.BR qlist (1),
.BR qlop (1),
.BR qmerge (1),
.BR qpkg (1),
.BR qsearch (1),
.BR qsize (1),
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
.BR qxpak (1)