XBPS-D(5)

NAME
xbps.d - XBPS configuration directory

SYNOPSIS
/etc/xbps.d/*.conf
/usr/share/xbps.d/*.conf

DESCRIPTION
The xbps.d configuration directory sets properties for the XBPS package manager. The configuration directory, by 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 directory.

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.

KEYWORDS

architecture=string
    Overrides the native machine architecture, as reported by uname(2).

bestmatching=true|false
    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.

cachedir=path
    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 rootdir.

ignorepkg=pkgname
    Declares a ignored package. If a package depends on an ignored package the dependency is always satisfied, without installing the ignored package.

noextract=pattern
    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.

    noextract=/usr/bin/f*
    noextract=!/usr/bin/foo

include=path/file.conf
    Imports settings from the specified configuration file. NOTE only one level of nesting is allowed.

preserve=path
    If set ignores modifications to the specified files, while unpacking packages. Absolute path to a file and file globbing are supported, example:

    preserve=/usr/bin/foo
    preserve=/etc/foo/*.conf

keepconf=true|false
    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.

repository=url
    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 xbps-rindex(1), example:

    repository=https://a-hel-fi.m.voidlinux.org/current
    repository=/hostdir/binpkgs

rootdir=path
    Sets the default root directory.

syslog=true|false
    Enables or disables syslog logging. Enabled by default.

virtualpkg=[vpkgname|vpkgver]:pkgname
    Declares a virtual package. A virtual package declaration is composed by two components delimited by a colon, example:

    virtualpkg=cron-daemon:dcron
        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.

ENVIRONMENT

XBPS_ARCH
    Overrides uname(2) machine result with this value. Useful to install packages with a fake architecture.

XBPS_TARGET_ARCH
    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).

FILES

/etc/xbps.d
    Default configuration directory.

/usr/share/xbps.d
    Default system configuration directory.

/var/db/xbps/.<pkgname>-files.plist
    Package files metadata.

/var/db/xbps/pkgdb-0.38.plist
    Default package database (0.38 format). Keeps track of installed packages and properties.

/var/cache/xbps
    Default cache directory to store downloaded binary packages.

SEE ALSO
xbps-checkvers(1), xbps-create(1), xbps-dgraph(1), xbps-digest(1), xbps-fbulk(1), xbps-fetch(1), xbps-install(1), xbps-pkgdb(1), xbps-query(1), xbps-reconfigure(1), xbps-remove(1), xbps-rindex(1), xbps-uchroot(1)

AUTHORS
Juan Romero Pardines <xtraeme@gmail.com>

BUGS
Probably, but I try to make this not happen. Use it under your own responsibility and enjoy your life.

Report bugs at https://github.com/void-linux/xbps/issues