paludis(1)
Name
paludis - The other package mangler
Synopsis
paludis --query [query options] target ...
paludis --install [install options] target ...
paludis --uninstall [uninstall options] target ...
paludis --uninstall-unused
paludis --sync [target (leave blank for all)]
paludis --report
paludis --contents target ...
paludis --executables target ...
paludis --owner [owner options] files ...
paludis --config target ...
paludis --version
paludis --info [target ...]
paludis --help
paludis --has-version spec
paludis --best-version spec
paludis --environment-variable spec variable
paludis --configuration-variable repository variable
paludis --list-repositories [--repository repo1 --repository repo2 ...]
paludis --list-categories [--repository repo1 ... --category cat1 --category cat2 ...]
paludis --list-packages [--repository repo1 ... --category cat1 ... --package pkg1 --package pkg2 ...]
paludis --list-sets [--repository repo1 ... --set set1 ...]
paludis --list-sync-protocols
paludis --list-repository-formats
paludis --list-dep-tag-categories
paludis --regenerate-installed-cache [target (leave blank for all)]
paludis --regenerate-installable-cache [target (leave blank for all)]
Description
paludis is the command line interface used to handle packages. It can query and install packages, update repositories and display information about packages already installed on a system.
Options
Actions
Selects which basic action to perform. Exactly one action should be specified.
- -q, --query
- Query for package information
- -i, --install
- Install one or more packages
- -u, --uninstall
- Uninstall one or more packages
- --uninstall-unused
- Uninstall unused packages
- -s, --sync
- Sync all or specified repositories
- -r, --report
- Report the current state of the system
- -k, --contents
- Display contents of a package
- --executables
- Display executable contents of a package
- -o, --owner
- Display the owner of a file
- --config
- Run post-install configuration for a package
- -V, --version
- Display program version
- -I, --info
- Display program version and system information
- -h, --help
- Display program help
More actions
Additional actions, mostly for script and internal use.
- --has-version
- Check whether the specified spec is installed
- --best-version
- Display the best version of the specified spec
- --match
- Display all installed packages matching the supplied argument
- --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
- --regenerate-installed-cache
- Regenerate (non-metadata) cache for installed repositories
- --regenerate-installable-cache
- Regenerate (non-metadata) cache for installable repositories
General options
Options which are relevant for most or all actions.
- --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
- --force-colour
- Force the use of colour
- --force-color
- Alias for --force-colour
- --no-suggestions
- Do not give suggestions if an unknown name is specified
- -E, --environment
- 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
- --multitask (--no-multitask)
- Perform tasks in parallel, where supported (currently --sync only)
- --compact (--no-compact)
- Display output using one line per entry (--install, --query)
Query options
Options which are relevant for --query.
- -D, --show-deps (--no-show-deps)
- Show dependencies
- -A, --show-authors (--no-show-authors)
- Show author information
- -M, --show-metadata (--no-show-metadata)
- Show raw metadata
Install, Uninstall options
Options which are relevant for --install, --uninstall or --uninstall-unused.
- -p, --pretend
- Pretend only
- -d, --destinations
- Use specified destinations instead of defaults
- -1, --preserve-world (--no-preserve-world)
- Don't modify the world file
- --add-to-world-spec
- Use this spec, rather than all targets, for updating world (for resume commands)
- -f, --fetch
- Only fetch sources; don't install anything
- --no-safe-resume
- Do not allow interrupted downloads to be resumed
- --show-reasons
- Show why packages are being (un)installed
- none
- Don't show any information
- summary
- Show a summary (default)
- full
- Show full output (can be very verbose)
- --show-use-descriptions
- Show descriptions of USE flags
- none
- Don't show any descriptions
- new
- Show for new use flags
- changed
- Show for new and changed flags (default)
- all
- Show for all flags
- --show-package-descriptions
- Show package descriptions
- none
- Don't show any descriptions
- new
- Show descriptions for new packages (default)
- all
- Show descriptions for all packages
- --continue-on-failure
- Whether to continue after a fetch or install error
- if-fetch-only
- If fetching only (default)
- never
- Never
- if-satisfied
- If remaining packages' dependencies are satisfied
- if-independent
- If independent of failed and skipped packages
- always
- Always (UNSAFE)
- --skip-phase
- Skip phases with a given name (e.g. init, preinst, unpack, merge, strip). Dangerous.
- --abort-at-phase
- Abort when a phase with a given name is encountered.
- --skip-until-phase
- Skip all phases until a phase with a given name is encountered. Dangerous.
- --change-phases-for
- Control to which package or packages options --skip-phase, --abort-at-phase and --skip-until-phase apply.
- all
- All packages (default)
- first
- Only the first package on the list
- last
- Only the last package on the list
- --serialised
- Rather than being a collection of atoms, treat the positional parameters as a serialised dependency list. The parameter to this option specifies the format version. Used by resume commands and Paludis exec()ing itself upon an upgrade; not to be used manually
Uninstall options
Options which are relevant for --uninstall.
- --with-unused-dependencies (--no-with-unused-dependencies)
- Also uninstall any dependencies of the target that are no longer used
- --with-dependencies (--no-with-dependencies)
- Also uninstall packages that depend upon the target
- --all-versions (--no-all-versions)
- Uninstall all versions of a package
- --permit-unsafe-uninstalls (--no-permit-unsafe-uninstalls)
- Allow depended-upon packages to uninstalled
DepList behaviour
Modify dependency list generation behaviour. Use with caution.
- --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
- warning
- As needed, but warn when doing so (default)
- 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 (default)
- error
- Error straight away
- discard
- Discard (dangerous)
- --dl-override-masks
- Zero or more mask kinds that can be overridden as necessary (default: tilde-keyword and license)
- none
- None (overrides defaults, not user selections)
- tilde-keyword
- Keyword masks where accepting ~ would work
- unkeyworded
- Keyword masks where a package is unkeyworded
- 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
Options relevant for one or more of the --list actions.
- --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
Options relevant for the --owner actions.
- --full-match (--no-full-match)
- Match whole filename
Environment
- PALUDIS_OPTIONS
- Default command-line options.
Examples
paludis --sync
Sync all syncable repositories, and perform any necessary cache updates.
paludis --install --pretend world
Show available updates for packages in the 'world' set (which contains all packages that have been explicitly installed as targets, along with the 'system' set), along with runtime dependencies of packages therein recursively.
paludis --install world
...and, having checked the output above, perform the install.
paludis --install --continue-on-failure if-satisfied world
...and continue as far as possible even after errors are encountered.
paludis --install --pretend --dl-reinstall if-use-changed world
...also reinstall packages whose use settings have changed.
paludis --install --pretend --dl-reinstall-scm weekly world
...also reinstall any scm (cvs, svn, ...) package that was installed over a week ago.
paludis --install --pretend x11-wm/fluxbox
Show what would be done to install a single package, along with all its dependencies, whilst recursively updating runtime dependencies.
paludis --install --pretend fluxbox
...as above, if the package name is unambiguous.
paludis --install fluxbox
...and perform the install, and add the package to the 'world' set when done.
paludis --install --preserve-world fluxbox
...or don't add the package to the 'world' set.
paludis --install --pretend --dl-upgrade as-needed fluxbox
...only update dependencies where required.
paludis --install --pretend =x11-wm/fluxbox-1.0.0
...specifying an exact version (which also prevents the package from being added to 'world').
paludis --uninstall app-editors/emacs
Uninstall a package.
paludis --uninstall --pretend --with-dependencies app-editors/emacs
Uninstall a package, along with any packages depending upon it.
paludis --uninstall --pretend --with-dependencies --with-unused-dependencies app-editors/emacs
...and also any packages that are only installed to satisfy that package's dependencies.
paludis --uninstall --pretend --permit-unsafe-uninstalls app-editors/emacs
...uninstall, even if the package is required by another installed package.
paludis --uninstall-unused --pretend
Uninstall all unused packages.