Portage-utils
From Gentoo Linux Wiki
Contents |
[edit] About Portage-utils
Portage-utils provides small and fast portage helper tools written in C.
Portage-utils is also documentated within the Gentoo Linux Documentation.
[edit] Currently Defined Applets
q <applet> <args> : virtual applet
qatom <pkg> : split atom strings
qcache <action> <args> : search the metadata cache
qcheck <pkgname> : verify mtimes/digests
qdepends <pkgname> : show dependency info
qfile <filename> : list all pkgs owning files
qglsa <action> <list> : check GLSAs against system
qgrep <misc args> : grep in ebuilds
qlist <pkgname> : list files owned by pkgname
qlop <pkgname> : emerge log analyzer
qmerge <pkgnames> : fetch and merge binary package
qpkg <misc args> : manipulate Gentoo binpkgs
qpy <misc args> : python interface
qsearch <regex> : search pkgname/desc
qsize <pkgname> : calculate size usage
qtbz2 <misc args> : manipulate tbz2 packages
quse <useflag> : find pkgs using useflags
qxpak <misc args> : manipulate xpak archives
Options: -[irmvqChV]
-i, --install * Install symlinks for applets -r, --reinitialize * Reinitialize ebuild cache -m, --metacache * Reinitialize metadata cache -v, --verbose * Make a lot of noise -q, --quiet * Tighter output; suppress warnings -C, --nocolor * Don't output color -h, --help * Print this help and exit -V, --version * Print version and exit
[edit] Installing Portage-utils
# emerge portage-utils
[edit] Usage
[edit] Q
The top command for portage-utils. All following commands are modules belonging to Q. For easy individual execution, Q's modules are also linked so only the module name needs to be typed instead of using long form.
A long form example:
# qcheck qlist portage-utils
A short form example:
# qlist portage-utils
[edit] Qatom
[edit] Qcache
[edit] Qcheck
Will verify the integrity of your install packages. To check all your package files installed on your system:
# qcheck --all
Same as the above, but both displaying output and creating a log file (for parsing later):
# qcheck --all --nocolor 2>&1 | tee qcheck.log
Using >app-portage/portage-utils-0.1.29, the following option should be available for only listing packages with bad files, excluding packages only have bad /etc files:
# qcheck --all --badonly
(See Talk:Portage-utils concerning how to find all broken packages on a system using this command and reinstall them.)
[edit] Qdepends
[edit] Qfile
Lists all packages owning the specified file:
$ qfile /usr/bin/qfile app-portage/portage-utils (/usr/bin/qfile)
or
$ qfile qfile app-portage/portage-utils (/usr/bin/qfile)
[edit] Qglsa
- Sorry, this applet has been disabled (as of version 0.1.29)
[edit] Qgrep
[edit] Qlist
Lists all files owned by the specified package name.
$ qlist portage-utils
I commonly use this for finding all of a package's install documentation
$ qlist bash |grep doc $ qlist portage-utils |grep man
Or all of a package's user executable files.
$ qlist portage-utils |grep bin
