qdepends(1)

NAME
qdepends - show dependency info

SYNOPSIS
qdepends [opts] <pkgname>

DESCRIPTION
The 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, qdepends will only query installed packages. There is no support for querying packages not yet installed (see equery(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.

OPTIONS

-d, --depend
    Show DEPEND info (default).

-r, --rdepend
    Show RDEPEND info.

-p, --pdepend
    Show PDEPEND info.

-k <arg>, --key <arg>
    Advanced option to allow querying the VDB. This option overrides -d, -r, -p or -a. <arg> can be any key from Portage's VDB, e.g. any file from var/db/pkg/<cat>/<pkg>/.

-Q <arg>, --query <arg>
    Query reverse deps. This basically reverses the search to any package that references <arg> in DEPEND, RDEPEND or PDEPEND. This can be useful to find consumers of a given package, e.g. to search for packages that have logwatch in their DEPEND.

-N, --name-only
    Only show category/package, instead of category/package-version.

-a, --all
    Show *DEPEND, alias for -drp.

-f, --format
    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 -q option, only the pretty-printed dependency declaration is printed, e.g. the DEPEND= part is skipped.

--root <arg>
    Set the ROOT env var.

-v, --verbose
    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.

-q, --quiet
    Suppress DEPEND= output for -f.

-C, --nocolor
    Don't output color.

-h, --help
    Print this help and exit.

-V, --version
    Print version and exit.

EXAMPLES
For finding out what a particular package depends on for building, you could do:
	$ qdepends nano
	app-editors/nano-2.3.2: >=sys-libs/ncurses-5.9-r1[unicode] sys-apps/file ...
This tells us that we have app-editors/nano-2.3.2 installed and it depends on ncurses (among other things). Searching for packages that actually have nano in their RDEPEND:
	$ qdepends -rQ nano
	virtual/editor-0
Tells us that virtual/editor depends on nano. However, if we wanted to know in what way a package specifically depends on another package, one can use -v.
	$ qdepends -vrQ logrotate
	sys-apps/portage-2.3.18: >=app-admin/logrotate-3.8.0
This way we can see there is a specific dependency expressed here. If the above had used <logrotate-3, for example, no matches would be returned. Not using any specifiers allows to reveal in what way a dependency is expressed.

REPORTING BUGS
Please report bugs via http://bugs.gentoo.org/
Product: Portage Development; Component: Tools, Assignee: portage-utils@gentoo.org

AUTHORS
Ned Ludd <solar@gentoo.org>
Mike Frysinger <vapier@gentoo.org>
Fabian Groffen <grobian@gentoo.org>

SEE ALSO
q(1), qatom(1), qcache(1), qcheck(1), qfile(1), qgrep(1), qlist(1), qlop(1), qmerge(1), qpkg(1), qsearch(1), qsize(1), qtbz2(1), qtegrity(1), quse(1), qxpak(1)