Paludis Logo Introduction Hooks general.conf bashrc
Bugs, Requests, Support Syncers keywords.conf / platforms.conf suggestions.conf
Overview Fetchers use.conf / options.conf sets/
FAQ Env Vars licenses.conf / licences.conf repositories/
Clients File Formats mirrors.conf  
Configuration Dep Specs output.conf  
API specpath.conf package_mask.conf  

Environment Variables

A number of environment variables can be used to override the behaviour of Paludis. These variables must be set in the environment before Paludis is launched; using them in a configuration bashrc will not work.

Default Options for Clients

Every standard client provides a way of providing default command line options in an environment variable named CLIENT_OPTIONS, where CLIENT is PALUDIS, ADJUTRIX, RECONCILIO etc. For example, you might find something like the following helpful:

export PALUDIS_OPTIONS="--show-reasons summary --dl-reinstall-scm weekly"

Internal Variables

The following variables can be used to override certain aspects of Paludis' behaviour. Tinkering with these variables can be dangerous and may break things; many of these variables exist mainly for use in test cases.

PALUDIS_DISTRIBUTION
The distribution configuration file to use (e.g. 'gentoo'). Usually this is configured at compile time; however, overriding it can be useful when building a chroot for a different distribution.
PALUDIS_DISTRIBUTIONS_DIR
Where Paludis looks to find distribution config files.
PALUDIS_FETCHERS_DIR
Where Paludis looks to find fetchers.
PALUDIS_ENVIRONMENT_SO_DIR
Where Paludis looks to find environment .so files.
PALUDIS_EBUILD_DIR
Where Paludis looks to find ebuild-related scripts.
PALUDIS_HOME
Overrides the normal HOME environment variable.
PALUDIS_NO_GLOBAL_HOOKS
If set to a non-empty string, global hooks will be ignored.
PALUDIS_NO_GLOBAL_SETS
If set to a non-empty string, global sets will be ignored.
PALUDIS_NO_GLOBAL_FETCHERS
If set to a non-empty string, global fetchers will be ignored.
PALUDIS_NO_GLOBAL_SYNCERS
If set to a non-empty string, global syncers will be ignored.
PALUDIS_HOOKER_DIR
Where Paludis looks to find the hooker script.
PALUDIS_PYTHON_DIR
Where Paludis looks to find Python things.
PALUDIS_E_REPOSITORY_QA_SO
The .so file to use for QA for e repositories.
PALUDIS_EAPIS_DIR
Where Paludis looks to find EAPI config files.
PALUDIS_QA_DATA_DIR
Where Paludis looks to find QA data.
PALUDIS_NO_CHOWN
If set to a non-empty string, Paludis will skip calling chown and chmod when installing files.
PALUDIS_REPOSITORY_SO_DIR
Where Paludis looks to find repository .so files.
PALUDIS_DO_NOTHING_SANDBOXY
If set to a non-empty string, Paludis will do absolutely nothing involving Sandbox.
PALUDIS_NO_XTERM_TITLES
If set to a non-empty string, Paludis will not set xterm titles.
PALUDIS_EXEC_PALUDIS
If set to never, Paludis will never re-exec itself when upgrading. If set to always, Paludis will always re-exec itself when upgrading, even if it isn't necessary.
PALUDIS_NO_XML
If set to a non-empty string, Paludis will disable all XML-related functionality. This can be useful if libxml2 is misbehaving.