Doculus: equery(1) - Gentoo: Package Query Tool

Manual: equery(1)

Updated: Oct 2005

NAME

equery - Gentoo: Package Query Tool

SYNOPSIS

equery [global-opts] command [local-opts]

DESCRIPTION

equery is a flexible utility which may display various information about packages, such as the files they own, their USE flags, the md5sum of each file owned by a given package, and many other things.

OPTIONS

The 'command' is the only mandatory option to equery. Most commands require a 'pkgspec' option, which is described by <cat/>packagename<-version>; namely, the package name is mandatory, while the category and version are optional.

[global-opts] may be one of:

-q, --quiet causes minimal output to be emitted

-C, --nocolor turns off colours

-h, --help displays a help summary

-V, --version displays the equery version

-N, --no-pipe turns off pipe detection

Only one command will actually be run, at most. The possible commands are:

belongs <local-opts> file

This command lists all packages owning the specified file.
Note: Normally, only one package will own a file. If multiple packages own the same file, it usually consitutes a problem, and should be reported (http://bugs.gentoo.org).

<local-opts> is either or both of:
-c, --category cat only search in category cat
-f, --full-regex supplied query is a regex
-e, --earlyout stop when first match found

check pkgspec This command checks the files of the specified package against recorded MD5 sums and timestamps.

depends <local-opts> pkgspec: This command displays all dependencies matching pkgspec.
<local-opts> is either or both of:
-a, --all-packages search in all available packages (slow)
-d, --direct search direct dependencies only (default)
-D, --indirect search indirect dependencies (very slow)
--depth=n Limit depth of indirect dependency tree to n levels. Setting --depth=0 is the same as not specifing --indirect.

depgraph <local-opts> pkgspec: This command display a dependency tree for pkgspec, by default indented to reflect how dependancies relate to each other.
: <local-opts> is either or both of:
-U, --no-useflags do not show USE flags.
-l, --linear do not use fancy formatting
--depth=n Limit depth of dependency graph to n levels.

files <local-opts> pkgspec

This lists files owned by a particular package, optionally with extra information specified by <local-opts>

<local-opts> is any combination of:
--timestamp output the timestamp of each file
--md5sum output the md5sum of each file
--type output the type of each file
--tree display results in a tree (turns off all other options)
--filter=<rules> filter output based on files type or path
<rules> is a comma separated list of filtering rules. Available rules are:
dir regular directories
obj regular files
sym symbolic links
dev device nodes
fifo named pipes
path shortest paths where some files where installed
conf configuration files (based on $CONFIG_PROTECT)
cmd user commands (based on $PATH)
doc documentation files (from /usr/share/doc)
man manpages (from /usr/share/man)
info info pages (from /usr/share/info)

hasuse <local-opts> useflag

This command lists packages matching a particular USE flag in a user-specified combination of installed packages, packages which are not installed, the portage tree, and the portage overlay tree.

<local-opts> must not include only -I; if -I is used, -p and/or -o must be also be present. By default, only installed packages are searched. -o searches only the overlay tree [and possibly installed packages], not the main portage tree.

list <local-opts> pkgspec

This command lists packages matching pkgspec in a user-specified combination of installed packages, packages which are not installed, the portage tree, and the portage overlay tree. By default the list command searches for partial name matches.

<local-opts> -I cannot be used by itself; if -I is used, -p and/or -o must be also be present. By default, only installed packages are searched. -o searches only the overlay tree [and possibly installed packages], not the main portage tree.

-i, --installed search installed packages (default)
-I, --exclude-installed do not search installed packages
-p, --portage-tree also search in portage tree (/usr/portage)
-o, --overlay-tree also search in overlay tree (/usr/local/portage)
-f, --full-regex query is a regular expression
-e, --exact-name list only those packages that exactly match
-d, --duplicates only list installed duplicate packages

Output:

The list command searches packages for the name given. If found, the following info will be displayed: the package location between the first square brackets (I for Installed packages, P for Portage, O for Overlay), the possible masks between the second (~ by keyword, - by arch or M hard masked), then the category and complete name and last of all, the slot in which the package is stored.

Examples:

equery list zilla - list all installed versions of packages containing the string 'zilla'

equery list --exact-name x11-libs/gtk+ - list all installed versions of x11-libs/gtk+

equery list --full-regex '(mozilla-firefox|mozilla-thunderbird)' - list all installed versions of mozilla-firefox and mozilla-thunderbird

equery list --duplicates - list all installed slotted packages

size <local-opts> pkgspec

This command outputs the number of files in the specified package, as well as their total size in an appropriate unit.

The possible values for <local-opts>, if specified, are:
-b, --bytes report size in bytes
-f, --full-regex query is a regular expression
-e, --exact-name list only those packages that exactly match

uses <local-opts> pkgspec

display USE flags for pkgspec.

The only possible value for <local-opts>, if specified, is:
-a, --all include all package versions

which pkgspec print full path to ebuild for package pkgspec

Unimplemented Options

changes

glsa - use glsa-check for the time being.

stats

BUGS

Many options aren't implemented. Command-line parsing could use some work.
Submit bug reports to http://bugs.gentoo.org

AUTHORS

equery, original man page: Karl Trygve Kalleberg <karltk@gentoo.org>, 2003.
Massive man page updates: Katerina Barone-Adesi <katerinab@gmail.com>, 2004.

Doculus

Manual index