repositories/ Configuration
In General
Each file in repositories/
named *.conf
defines a repository. A repository configuration
file is a standard key=value config file, and it may be in bash format (in which case it has a .bash
extension rather than .conf
). The repository_defaults.conf
file
(which does not live in the repositories
subdirectory), if it exists, is treated as if it were
prepended to each individual file. It is evaluated once per repository config, allowing predefined variables like
${repo_file}
to be used inside it.
The filenames used for repository configuration files have no effect upon the names of the repositories. Whilst
you could use the name giant-space-monkey.conf
for the repository named gentoo
,
for user sanity reasons it is best to use the repository name as the filename.
Predefined Keys
The following variables are predefined. They should not be modified, but may be used in configuration files to define other keys.
root
- The filesystem root. Relevant if
specpath.conf
is in use. Using this variable can create a configuration system that works both inside and outside of a chroot (e.g.location = ${root}/var/db/paludis/repositories/paludis-overlay
). repo_file
- The filename of the repository config file.
repo_file_basename
- The basename (filename without path) of the repository config file.
repo_file_unsuffixed
- The basename without file extension of the repository config file.
General Keys
The following keys are meaningful for all repository formats.
format
- Determines which repository class Paludis uses to create the repository. Example formats are
e
,vdb
andinstalled_unpackaged
. Mandatory. importance
- Must be an integer. Used by Paludis to determine from which repository a package should be selected, all other
things being equal (a higher importance is preferred over a lower importance). By default,
0
, except if themaster_repository
key is set, in which case it is10
instead.
For format-specific keys, see the documentation for that format.
Repository Formats
For All Distributions
- e format, for ebuild and exheres repositories.
- repository, for automatic repository configuration.
- unavailable, for information about ebuilds that are present in an overlay or supplemental repository that is not configured on this system.
- installed_unpackaged, for tracking installs of packages installed manually rather than through an ebuild.
Gentoo and Derived Distributions
- VDB, for tracking installed ebuilds.
Exherbo
- exndbam, for tracking installed packages installed from an exheres.
- accounts and installed_accounts format repositories, for tracking user and group accounts.
- unwritten, for packages that have yet to be written.