Search:  
Gentoo Wiki

Portage-utils

Contents

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.

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

Installing Portage-utils

# emerge portage-utils


Usage

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

Qatom

Qcache

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.)

Qdepends

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)

Qglsa

Qgrep

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

Qlop

Qmerge

Qpkg

Qpy

Qsearch

Qsize

Qtbz2

Quse

Qxpak

Retrieved from "http://www.gentoo-wiki.info/Portage-utils"

Last modified: Thu, 04 Sep 2008 06:00:00 +0000 Hits: 2,784