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 --debug-build split --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 distibution 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_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_FUTURE_THREAD_COUNT

(Highly experimental, only if threads are enabled) The number of threads used to precalculate futures.

PALUDIS_IDLE_THREAD_COUNT

(Highly experimental, only if threads are enabled) The number of low priority threads used to precalculate values that might be used in the future.

PALUDIS_OUTPUTWRAPPER_DIR

Where Paludis looks to find outputwrapper.

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.