from small one page howto to huge articles all in one place

Other .linuxhowtos.org sites:toolsntoys.linuxhowtos.org
gentoo.linuxhowtos.org

poll results

Last additions:

words:

887

views:

17816

userrating:

average rating: 3.6 (185 votes) (1=very good 6=terrible)

May 25th. 2007:

Words

486

Views

33527

why adblockers are bad

Workaround and fixes for the current Core Dump Handling vulnerability affected kernels

words:

161

views:

19659

userrating:

average rating: 1.0 (28 votes) (1=very good 6=terrible)

April, 26th. 2006:

Words

Views

15122

New subdomain: toolsntoys.linuxhowtos.org

You are here: manpages

ANALYSE

Section: Misc. Reference Manual Pages (22)
Updated: Febuary 2010
Index Return to Main Contents

NAME

analyse - Gentoo Installed Package Analysis Tool

SYNOPSIS

analyse [global-options] module [local-options]TARGET

DESCRIPTION

Analyse Is a collection of modules for analysing the state of installed Gentoo packages for USE flags or keywords used for installation, and their current masking status.
It can also optionally (re)generate new /etc/portage/package.* files.

CAUTION: This is beta software and is not yet feature complete. Some features, options or its name may change in the future. Any files that it generates are saved to your home directory and will not harm your system without effort on your part.

GLOBAL OPTIONS

-h, --help: Output a help message.
-q, --quiet: Be less verbose where possible. In some modules, this option can increase the output speed.
-C, --no-color: Do not colorize output.
-N, --no-pipe: Turn off automatic pipe detection. Use this option if you do not want analyse To detect if the output is being directed to the screen or to another program and adjust color and verbosity accordingly.
-V, --version: Display Gentoolkit's version. Please include this in all bug reports. (see BUGS below)

MODULES

Analyse Uses a system of modules. Each module has both a long and short name. The list below uses the notation "module (m)", where m is the short name and module is the long name. You can view the help message for a specific module by using -h, --help as either a global option (after analyse and before the module name) or as a local option (after the module name).

analyse(a)[OPTIONS]TARGET

Report on all installed packages for TARGET.

TARGET:

use: Will analyse the installed with USE flags for output results.
pkguse: Will analyse the USE flags information from the installed pkg's 'PKGUSE' file which contains only flags settings from /etc/portage/package.use at the time of installation.
keywords: Will analyse the recorded keywords for output results.
unmask: Will analyse the installed packages and portage trees for pkgs that require unmasking and report them.
LOCAL OPTIONS:
-u, --unset: Will also include any USE flags used that were not enabled for some packages.
-v, --verebose: Gives more detail about the results found and the current task being performed.
EXAMPLES:
: analyse a --verbose --unset use
Report on all use flags used to install the packages. (--unset) Include in the report all flags that have been used but also were not set enabled for some packages. (--verbose) Also list the packages that used the USE flag setting. The report will break down the useage and report the USE flag up to 3 times indicating its setting {"+","-"," "= unset} prepended to the flag name. It will also color the output, red = Disabled, blue = Enabled, plain text = unset

rebuild(r)[OPTIONS]TARGET

Create a list all packages for TARGET settings that are needed for other than the default settings.

TARGET:

use: Will analyse the USE flags for output results.
keywords: Will analyse the keywords for output results.
unmask: Will analyse the installed packages and portage trees for pkgs that require unmasking and produce output/a new /etc/portage/package.unmask file. LOCAL OPTIONS:
-a, --all: Create files/output for all TARGET(s) found to need it. (not Implemented yet)
-e, --excact: Will prepend the pkg with = as well as use the version information for the entries.
eg.: =CAT/PKG-VER flag1 flag2
-p, --pretend: Sends the output to the screen instead of a file.
-v, --verebose: Gives more detail about the results found and the current task being performed. EXAMPLES:
: analyse rebuild -p use
Analyse the installed packages database and current system USE flag settings
and output the results in the form of:

CAT/PKG -flag1 -flag2 flag3 flag4...

clean(c)[OPTIONS]TARGET

Clean all packages for TARGET settings that are found with obsolete settings for the current settings and pkg ebuild. (not Implemented yet)

TARGET:

use

Will analyse the USE flags and /etc/portage/package.use file(s) for entries that are redundant or no longer used by the pkg.

keywords

Will analyse the keywords and /etc/portage/package.keywords file(s) for entries that are no longer needed.

unmask

Will analyse the installed packages, /etc/portage/package.unmask file(s) and portage trees for pkgs that no longer require unmasking. LOCAL OPTIONS:

-a, --all

Clean files/output for all TARGET(s) found to need it. (not Implemented yet)

-p, --pretend

Sends the output to the screen instead of a file.

-v, --verebose