keywords.conf / platforms.conf
This document applies only to clients using PaludisEnvironment
. Any standard client that supports a
--environment
command line option uses PaludisEnvironment
unless overridden, either by
explicitly selecting another environment (e.g. --environment portage
) or, on distributions also
supporting Portage, by lack of a Paludis configuration and presence of a Portage configuration.
The keywords.conf
(Gentoo and derived distributions) or platforms.conf
(Exherbo) file
controls which keywords are and are not accepted. It is a standard configuration file which may be a bash file
(keywords.bash
or platforms.bash
) and which may use the keywords.conf.d/
or
platforms.conf.d/
directory.
Each line in the file consists of a specification followed by one or more accepted keywords or platforms. A specification may be any of:
- The special specification
*/*
, which matches all packages. Nearly all users will have at least one line using this specification. - A simple
category/package
name. - A simple
set
name. - A complex dependency specification.
Any token may be quoted using either single or double quotes.
Accepted keywords or platforms are one of:
keyword
, which accepts any package containing that keyword.~keyword
, which accepts any package containing that ~keyword. This does not automatically accept the regular, non-tilde keyword.*
, which accepts any package, including one with empty keywords or platforms.-*
, which cancels any previously accepted match (see below).
Accepted keywords or platforms are usually cumulative, so if you have a */* arch ~arch
line, you will
need to use cat/pkg -* arch
if you only wish to accept arch
for a particular package.
Examples
For a system which is mostly stable:
# By default, only accept 'x86' packages */* x86 # For the repository named 'paludis-overlay', accept unstable too */*::paludis-overlay x86 ~x86 # For these packages, accept unstable too app-admin/eselect ~x86 app-doc/doxygen ~x86 # For packages in the 'kde' set, accept unstable kde ~x86 # Accept gcc 4.3 from the toolchain overlay, even if it is unkeyworded sys-devel/gcc:4.3::toolchain *
For a system which is mostly unstable:
# By default, accept stable and unstable */* amd64 ~amd64 # For these packages, accept stable only sys-devel/gcc -* amd64 sys-libs/glibc -* amd64