PORTPEEK(1)

NAME
portpeek - Package (un)masking management script

SYNOPSIS

portpeek
    [options] command

portpeek
    --keyword | --unmask | --mask | --package-use | --package-env | --all

portpeek
    --changes-only [--keyword | --unmask | --mask | --package-use | --package-env | --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

-z, --make-conf-use print a notice for use flags duplicated in both package.use and make.conf, only works with -s or -a

-e, --package-env show matches from package.env 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>