XBPS configuration directory
configuration directory sets properties for
the XBPS package manager. The configuration
default set to /etc/xbps.d
overrides settings from files
available in the system configuration
directory, by default
set to /usr/share/xbps.d
Files in the configuration directory have
preference over files in the system configuration
Only files with the .conf extension will be
processed in alphabetical order.
The configuration files can set multiple
keywords that are pairs of keys and values, such as
`key=value`. No whitespace between the
key and its value is allowed, nor
trailing whitespaces after its value.
- Overrides the native machine architecture, as reported by
- When this keyword is enabled, a package with the greatest version
available in all registered repositories will be chosen. This will be
applied to dependencies as well.
- Sets the default cache directory to store downloaded binary packages from
remote repositories, as well as its signatures. If path starts with '/'
it's an absolute path, otherwise it will be relative to
- Declares a ignored package. If a package depends on an ignored package the
dependency is always satisfied, without installing the ignored
- Skip extraction of matching files. Patterns starting with a exclamation
mark negate the previous match, a single backslash can be used to escape
the exclamation mark.
In the following example all files matching the first pattern
will not be extracted, but files that also match the second pattern will
still be extracted.
- Imports settings from the specified configuration file.
NOTE only one level of nesting is allowed.
- If set ignores modifications to the specified files, while unpacking
packages. Absolute path to a file and file globbing are supported,
- If set to false (default), xbps will overwrite configuration files if they
have not been changed since installation and a newer version is available.
If set to true, xbps will save the new configuration file as
<name>.new-<version> if the original configuration file has
not been changed since installation.
- Declares a package repository. The url argument
accepts local and remote repositories. A complete url or absolute path to
the directory that stores the <arch>-repodata
archive is expected. Note that remote repositories must be signed using
- Sets the default root directory.
- Enables or disables syslog logging. Enabled by default.
- Declares a virtual package. A virtual package declaration is composed by
two components delimited by a colon, example:
- Any request to the cron-daemon virtual package
will be resolved to the dcron real package.
The first component expects a virtual package
name and optionally its version component. The second component
expects a package name to match the real package.
- Overrides uname(2) machine result with
this value. Useful to install packages with a fake architecture.
- Sets the target architecture to this value. This variable differs from
XBPS_ARCH in that it allows you to install packages
partially, because configuration phase is skipped (the target binaries
might not be compatible with the native architecture).
Juan Romero Pardines <firstname.lastname@example.org>
Probably, but I try to make this not happen. Use it under your own
responsibility and enjoy your life.
- Default configuration directory.
- Default system configuration directory.
- Package files metadata.
- Default package database (0.38 format). Keeps track of installed packages
- Default cache directory to store downloaded binary packages.
Report bugs at https://github.com/void-linux/xbps/issues