NAME

xbps-alternatives — XBPS utility to handle alternatives

SYNOPSIS

DESCRIPTION

The xbps-alternatives utility lists or sets the alternatives provided by installed packages. Alternatives are classified by groups, and a group contains a number of symbolic links which are applied when the group is set.

When a package is installed its alternative groups are registered in the package database (pkgdb).

When a package is removed its alternative groups are unregistered from the package database (pkgdb). If there are no more alternative groups, the package database removes the references. If there were alternative groups registered previously, the previous package is set as default provider.

OPTIONS

-C, --config dir

Specifies a path to the XBPS configuration directory. If the first character is not '/' then it's a relative path of rootdir.

-d, --debug

Enables extra debugging shown to stderr.

-g, --group

Alternative group name to match. To be used with the set mode.

-h, --help

Show the help message.

-i, --ignore-conf-repos

Ignore repositories defined in configuration files. Only repositories specified in the command line via --repository will be used.

-R

Enable repository mode when listing alternatives. This mode explicitly looks for all alternatives available in repositories rather than looking for installed alternatives.

--repository url

Appends the specified repository to the top of the list. The url argument expects a URL to the repository for remote repositories or a path for local repositories.

-r, --rootdir dir

Specifies a full path for the target root directory.

-v, --verbose

Enables verbose messages.

-V, --version

Show the version information.

MODE

Only one of the following modes can be used at a time.

-l, --list [PKG [-g group]]

Lists all current alternative groups or only from PKG, or just a specific group, if the -g --group option is set.

-s, --set PKG [-g group]

Set alternative groups specified by PKG or just a specific group, if the -g --group option is set.

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.

ENVIRONMENT

XBPS_ARCH

Overrides uname(2) machine result with this value.

XBPS_TARGET_ARCH

Sets the target architecture to this value.

XBPS_SYSLOG

Overrides the xbps.d(5) syslog=true|false configuration option.

EXIT STATUS

The xbps-alternatives utility exits 0 on success, and >0 if an error occurs. A descriptive error message will be printed to stderr.

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), xbps-uunshare(1), xbps.d(5)

AUTHORS

Juan Romero Pardines <xtraeme@gmail.com>
Duncan Overbruck <mail@duncano.de>

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