Paludis manual

From Gentoo Linux Wiki

Jump to: navigation, search


Usage: paludis [options]

Contents

[edit] 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

[edit] 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

[edit] 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

[edit] Query options:

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

[edit] 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

[edit] 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

[edit] 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

[edit] 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

[edit] Owner options:

 --full-match           Match whole filename

[edit] 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
Personal tools