Paludis is a multi-format package manager and an alternative to Portage.
- 1 Installation
- 2 Configuration
- 3 Usage
- 4 Troubleshooting
- 5 See also
- 6 External resources
Refer to the Paludis guide for instructions on how to install Paludis and set up the basic configuration.
This section gives an overview on where to configure various things in Paludis.
- Toolchain and environmental package behavior: /etc/paludis/bashrc
- Keywords (allowing packages from unstable branch): /etc/paludis/keywords.conf or /etc/paludis/keywords.conf.d/*.conf
- USE flags (enabling package features): /etc/paludis/use.conf or /etc/paludis/use.conf.d/*.conf
- Licenses: /etc/paludis/licenses.conf or /etc/paludis/licenses.conf.d/*.conf
- Package (un)masks: /etc/paludis/package_mask.conf or /etc/paludis/package_mask.conf.d/*.conf and /etc/paludis/package_unmask.conf or /etc/paludis/package_unmask.conf.d/*.conf respectively
- Hooks: various subdirectories of /etc/paludis/hooks/
- Output and log behavior: /etc/paludis/output.conf
This section tries to give a concise usage overview and may serve as a quick lookup reference. However, it does not and will not replace the official documentation.
Basics and installing a package
The most basic form is:
cave resolve <category>/<package-name>
This will try to solve the dependencies and print out the results. It will not actually perform the resolution (as in: install the target package). To actually carry out the resolution we would have to pass the
-x option. You should only do that if you know what you are doing, because paludis is truly non-interactive and will not ask in between. The more common workflow is to save the resolution information in a so called resume file, review the changes that would be performed (like installing and uninstalling packages) and then execute them:
cave resolve --resume-file ~/cave_resume <category>/<package-name>
# review resolution on stdout
cave resume --resume-file ~/cave_resume
It may make sense to create aliases for these commands in your favorite shell.
To perform dependency resolution and instantly carry out the results (if possible), you would do:
cave resolve -x <category>/<package-name>
It is also possible to pass both
The resume state also allows us to resume compilations/installations we have aborted or which have failed.
Not only the resolve subcommand behaves this way. Refer to the man page of a particular subcommand to get more detailed information.
All further commands in this section will omit the
-x and the
--resume-file options (if applicable) and will leave it up to the user which one to choose (or none).
You can omit the
category/part, in which case Paludis will try to look it up.
Uninstall a package
Either this way:
cave uninstall <category>/<package-name>
or the following way, which lets you combine it with installation of packages:
cave resolve \!<category>/<package-name>
If you want to uninstall all unneeded packages, do
cave resolve -c world
Install a repository
If you have configured unavailable layman repositories as per the the Paludis guide, then you should be able to install repositories just like regular packages.
cave resolve <repository-name>
If the repository name could be ambiguous with a package name, then you can tell cave explicitly that this is a repository:
cave resolve repository/<repository-name>
Sync all repositories
Post-configure a package
Some ebuilds have a pkg_config phase which allows post-install configuration for packages.
A lot of ebuilds might output something like this:
* In order to update your hddtemp database, run: * emerge --config =app-admin/hddtemp-0.3_beta15-r7
Since we don't use Portage, we have to do this instead for the above case:
cave config =app-admin/hddtemp-0.3_beta15-r7
Tell the resolver how much work it should perform
There are three main options that change the default behavior:
||Does as little work as possible, typically used when quickly installing a single package only.|
||Does all optional work, typically used when updating the 'world' set.|
||Does all optional work and always re-installs, typically used when you want to rebuild everything after a major gcc upgrade for example.|
If none of the above options are passed, then the default behavior is roughly in between --lazy and --complete. These options are in fact just shorthands for more fine-grained options. Check the man page of cave-resolve for additional information on this subject.
Keep output logs
Add the following file:
always_keep_output_logs = true
Make Paludis quiet
Add the following file:
quiet = true
Speed up cave-search
cave search can make use of a search index, similar to what eix does. First, we have to generate the index:
cave manage-search-index --create ~/cave-search-index
And then we can use it:
cave search --index ~/cave-search-index <pattern>
Although subslot handling in Paludis technically meets the spec, it misbehaves from a user perspective. Paludis will not pull in installed packages with mismatched subslots into the depgraph which are not part of the resolution, nor does it allow the user to easily do that. There exist various hacks and scripts to work around that. Another way is to pass -D dev-libs/foo if installed dependant packages of foo use an older subslot than the one that is about to be installed. However, that will also reinstall packages that are not affected. Also see the upstream bug report.
Paludis frequently fails to build with Clang. Your best bet is to use the stable gentoo releases which have a better chance of containing a patch. The live ebuild will most likely fail to build.
Gentoo rsync mirrors
Some rsync gentoo mirrors are out of date and don't run rsync-3.1 yet. These cause trouble. You can either overwrite the default rsync syncer with your own syncer or pick a gentoo mirror that works properly.
- http://paludis.exherbo.org/faq/howdoi.html - FAQ: How do I ...?
- http://exherbo.org/ - Exherbo Linux.