Paludis_manual

Usage: paludis [options]

Actions:

 --query, -q            Query for package information
 --install, -i          Install one or more packages
 --uninstall, -u        Uninstall one or more packages
 --uninstall-unused     Uninstall unused packages
 --sync, -s             Sync all or specified repositories
 --report, -r           Report the current state of the system
 --contents, -k         Display contents of a package
 --owner, -o            Display the owner of a file
 --config               Run post-install configuration for a package
 --version, -V          Display program version
 --info, -I             Display program version and system information
 --help, -h             Display program help

More actions:

 --has-version          Check whether the specified spec is installed
 --best-version         Display the best version of the specified spec
 --environment-variable
                        Display the value of an environment variable for a particular package
 --configuration-variable
                        Display the value of a configuration variable for a particular repository
 --list-repositories    List available repositories
 --list-categories      List available categories
 --list-packages        List available packages
 --list-sets            List available package sets
 --list-sync-protocols  List available sync protocols
 --list-repository-formats
                        List available repository formats
 --list-dep-tag-categories
                        List known dep tag categories
 --regenerate-installed-cache
                        Regenerate (non-metadata) cache for installed repositories
 --regenerate-installable-cache
                        Regenerate (non-metadata) cache for installable repositories
 --update-news          No longer useful, does nothing

General options:

 --log-level            Specify the log level
     debug                Show debug output (noisy)
     qa                   Show QA messages and warnings only (default)
     warning              Show warnings only
     silent               Suppress all log messages (UNSAFE)
 --no-colour            Do not use colour
 --no-color             Alias for --no-colour
 --environment, -E      Environment specification (class:suffix, both parts optional)
 --resume-command-template
                        Save the resume command to a file. If the filename contains 'XXXXXX', use mkstemp(3) to generate the filename

Query options:

 --show-deps, -D        Show dependencies
 --show-metadata, -M    Show raw metadata

Install, Uninstall options:

 --pretend, -p          Pretend only
 --destinations, -d     Use specified destinations instead of defaults
 --preserve-world, -1   Don't modify the world file
 --add-to-world-spec    Use this spec, rather than all targets, for updating world (for resume commands)
 --no-config-protection
                        Disable config file protection (dangerous)
 --debug-build          What to do with debug information
     none                 Discard debug information (default)
     split                Split debug information
     internal             Keep debug information
 --fetch, -f            Only fetch sources; don't install anything
 --safe-resume          Allow interrupted downloads to be resumed safely
 --show-reasons         Show why packages are being (un)installed
     none                 Don't show any information (default)
     summary              Show a summary
     full                 Show full output (can be very verbose)
 --show-use-descriptions
                        Show descriptions of USE flags
     none                 Don't show any descriptions (default)
     new                  Show for new use flags
     changed              Show for new and changed flags
     all                  Show for all flags

Uninstall options:

 --with-unused-dependencies
                        Also uninstall any dependencies of the target that are no longer used
 --with-dependencies    Also uninstall packages that depend upon the target
 --all-versions         Uninstall all versions of a package

DepList behaviour:

 --dl-reinstall         When to reinstall packages
     never                Never (default)
     always               Always
     if-use-changed       If USE flags have changed
 --dl-reinstall-scm     When to reinstall scm packages
     never                Never (default)
     always               Always
     daily                If they are over a day old
     weekly               If they are over a week old
 --dl-reinstall-targets
                        Whether to reinstall targets
     auto                 If the target is a set, never, otherwise always (default)
     never                Never
     always               Always
 --dl-upgrade           When to upgrade packages
     always               Always (default)
     as-needed            As needed
 --dl-new-slots         When to pull in new slots (works with --dl-upgrade)
     always               Always (default)
     as-needed            As needed
 --dl-downgrade         When to downgrade packages
     as-needed            As needed (default)
     warning              As needed, but warn when doing so
     error                Downgrades should be treated as errors
 --dl-deps-default      Override default behaviour for all dependency classes
     pre                  As pre dependencies
     pre-or-post          As pre dependencies, or post dependencies where needed
     post                 As post dependencies
     try-post             As post dependencies, with no error for failures
     discard              Discard
 --dl-installed-deps-pre
                        How to handle pre dependencies for installed packages
     pre                  As pre dependencies
     pre-or-post          As pre dependencies, or post dependencies where needed
     post                 As post dependencies
     try-post             As post dependencies, with no error for failures
     discard              Discard (default)
 --dl-installed-deps-runtime
                        How to handle runtime dependencies for installed packages
     pre                  As pre dependencies
     pre-or-post          As pre dependencies, or post dependencies where needed
     post                 As post dependencies
     try-post             As post dependencies, with no error for failures (default)
     discard              Discard
 --dl-installed-deps-post
                        How to handle post dependencies for installed packages
     pre                  As pre dependencies
     pre-or-post          As pre dependencies, or post dependencies where needed
     post                 As post dependencies
     try-post             As post dependencies, with no error for failures (default)
     discard              Discard
 --dl-uninstalled-deps-pre
                        How to handle pre dependencies for uninstalled packages
     pre                  As pre dependencies (default)
     pre-or-post          As pre dependencies, or post dependencies where needed
     post                 As post dependencies
     try-post             As post dependencies, with no error for failures
     discard              Discard
 --dl-uninstalled-deps-runtime
                        How to handle runtime dependencies for uninstalled packages
     pre                  As pre dependencies
     pre-or-post          As pre dependencies, or post dependencies where needed (default)
     post                 As post dependencies
     try-post             As post dependencies, with no error for failures
     discard              Discard
 --dl-uninstalled-deps-post
                        How to handle post dependencies for uninstalled packages
     pre                  As pre dependencies
     pre-or-post          As pre dependencies, or post dependencies where needed
     post                 As post dependencies (default)
     try-post             As post dependencies, with no error for failures
     discard              Discard
 --dl-uninstalled-deps-suggested
                        How to handle suggested dependencies for uninstalled packages (only with --dl-suggested install)
     pre                  As pre dependencies
     pre-or-post          As pre dependencies, or post dependencies where needed
     post                 As post dependencies (default)
     try-post             As post dependencies, with no error for failures
     discard              Discard
 --dl-suggested         How to handle suggested dependencies
     show                 Display, but do not install (default)
     install              Install
     discard              Discard
 --dl-circular          How to handle circular dependencies
     error                Raise an error (default)
     discard              Discard
 --dl-blocks            How to handle blocks
     accumulate           Accumulate and show in the dependency list
     error                Error straight away (default)
     discard              Discard (dangerous)
 --dl-override-masks    Zero or more mask kinds that can be overridden as necessary
     tilde-keyword        Keyword masks where accepting ~ would work
     unkeyworded          Keyword masks where a package is unkeyworded
     profile              Profile masks
     repository           Repository masks
     license              License masks
 --dl-fall-back         When to fall back to installed packages
     as-needed-except-targets Where necessary, but not for target packages (default)
     as-needed            Where necessary, including for target packages
     never                Never

List options:

 --repository           Matches with this repository name only
 --repository-format    Matches with this repository format only
 --category             Matches with this category name only
 --package              Matches with this package name only
 --set                  Matches with this package set name only

Owner options:

 --full-match           Match whole filename

Deprecated options:

 --dl-no-unnecessary-upgrades, -U
                        Replaced by --dl-upgrade as-needed
 --dl-drop-all, -0      Replaced by --dl-deps-default discard
 --dl-ignore-installed, -e
                        Replaced by --dl-reinstall always
 --show-install-reasons
                        Replaced by --show-reasons
 --add-to-world-atom    Replaced by --add-to-world-spec
 --config-suffix, -c    Replaced by --environment