xbps/data/xbps.conf
Andreas Kempe 02c9cb11c4 configuration: add keepconf option
Add configuration option keepconf that stops xbps from overwriting
unchanged configuration files. If keepconf=true, xbps will store the new
configuration as <name>.new-<version> instead of overwriting unchanged
configuration files.
2020-02-08 21:06:04 +01:00

107 lines
3.6 KiB
Plaintext

# Configuration file for XBPS.
#
# - Lines starting with # are ignored.
# - Values are set after the equal sign, and don't accept blanks nor newlines.
# Set root directory, by default set to /. This expects an absolute path.
#rootdir=/
# Set cache directory, if starts with / it's an absolute path,
# otherwise it's relative to rootdir.
#cachedir=var/cache/xbps
# Set it to false to disable syslog logging.
#syslog=true
# Enable package best matching (disabled by default). If enabled a package with
# the greatest version available in all repositories will be choosen, rather
# than on the first package matching the expression.
#
#bestmatching=true
## REPOSITORIES
#
# The `repository' keyword defines a repository. A complete URL or absolute
# path to a local directory can be used.
#
# Local or remote repositories are accepted.
#
# - Local repositories expect an absolute path to the directory that stores
# the <arch>-repodata file.
# - Accepted protocols for remote repositories: ftp, http or https.
# - Repositories are added in the order in which are specified (top->bottom).
# - Repositories declared in this file are added at the head of the list.
# - Repositories declared in the system or configuration directories are added
# to the tail of the list.
#
# The "repository" keyword can be used to include additional repositories in
# addition to the files available in /etc/xbps.d/*.conf and
# /usr/share/xbps.d/*.conf.
#
# syntax: <protocol>://<url>[:<port>]/<doc> [remote]
# syntax: <abspath> [local]
#
# Example:
# repository=http://foo.example.org/dir
# repository=https://foo.example.org:8080/dir
# repository=/hostdir/binpkgs
## REPOSITORY MIRRORS
#
# - https://beta.de.repo.voidlinux.org/current
# - https://beta.de.repo.voidlinux.org/current/nonfree
# - https://beta.de.repo.voidlinux.org/current/multilib
# - https://beta.de.repo.voidlinux.org/current/multilib/nonfree
#
# - http://alpha.us.repo.voidlinux.org/current
# - http://alpha.us.repo.voidlinux.org/current/nonfree
# - http://alpha.us.repo.voidlinux.org/current/multilib
# - http://alpha.us.repo.voidlinux.org/current/multilib/nonfree
## PRESERVING FILES
#
# The `preserve` keyword can be used to make xbps ignore changes to the
# specified files. Files must be specified with absolute pathnames or via
# file globbing.
#
# Files bearing the same name in the configuration directory override the
# ones from the system directory.
#
# Example:
# preserve=/etc/file
# preserve=/etc/dir/*.conf
## PRESERVING CONFIGURATION
#
# The `keepconf` (disabled by default) keyword can be used to prevent
# xbps from overwriting configuration files.
#
# If set to false, 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.
# keepconf=true
## VIRTUAL PACKAGES
#
# Virtual package overrides. You can set your own list of preferred virtual
# packages for your system. This expects two arguments separated by a colon:
# <vpkgver>:<realpkgname>.
#
# - <vpkgver> means "virtual package name" and "version/revision"
# separated by a dash, i.e 'foo-1.0_1".
# - <realpkgname> means a real package name (without any version).
#
# Files bearing the same name in the configuration directory override the
# ones from the system directory.
#
# Example:
# virtualpkg=cron-daemon-0_1:dcron
# You can also include additional files by using the "include" keyword.
# This expects an absolute path to a file.
#include=/path/to/another/file.conf