Paludis Logo Introduction paludis instruo
Bugs, Requests, Support inquisitio appareo
Overview importare  
FAQ qualudis  
Clients reconcilio  
Configuration accerso  
API adjutrix  

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.