PORTPEEK

Section: Misc. Reference Manual Pages (1)
Updated: Aug 2009
Page Index

NAME

portpeek - Package (un)masking management script

SYNOPSIS

portpeek: [options] command
portpeek: --keyword | --unmask | --mask | --package-use | --all
portpeek: --changes-only [--keyword | --unmask | --mask | --package-use | --all]

DESCRIPTION

portpeek is a utility script that will process a system's package.* files and display to the user potential package upgrades. Along with displaying the installed packages and the versions that the package could be upgraded to, the keywords for each specific package will also be displayed. Results are colorcoded for readability.

OPTIONS

The 'command' is the only mandatory option to portpeek.

[options] may only be:

-c, --changes-only: show only packages that have a possible upgrade

-n, --no-color: suppress color output

-r, --removable-only: show all matches that can be removed from package files

-f --fix: remove the unnecessary packages without asking for confirmation

-q --fix-confirm: ask for confirmation before removing the unnecessary packages

-d --debug: display more verbose output for debugging

Except for version information, commands can be combined. The possible commands are:

-a, --all show all matches

-h, --help displays a help summary

-k, --keyword show matches from package.keywords and package.accept_keywords only

-m, --mask show matches from package.mask only

-u, --unmask show matches from package.unmask only

-s, --package.use show matches from package.use only

-t, --tilde-check process tilde entries ~(cat/pkg-version)

-V, --version displays the equery version

OTHER OPTIONS

Putting the words "portpeek-skip" with or without quotes on a comment line will make portpeek skip the rest of the file. This is useful, for example, if one has a separate KDE keywords file with many lines of the form: ~kde-base/kde-program. These tend to take awhile to process and might be a file you don't want analyzed for every portpeek call.

EXAMPLES

portpeek --changes-only --keyword - list all packages with a potential upgrade located in package.keywords or package.accept_keywords

portpeek --unmask - list all packages and their keywords currently listed in package.unmask

portpeek -ac - list all packages and keywords from all package.* files

portpeek -arf - list all packages which are stable and can be removed and then remove them automatically

AUTHORS

Michael Pagano <mpagano@gentoo.org>