Manpage logo

xbps-checkvers - XBPS utility to check for outdated packages


XBPS-CHECKVERS(1) General Commands Manual XBPS-CHECKVERS(1)

NAME

xbps-checkvers — XBPS utility to check for outdated packages

SYNOPSIS

xbps-checkvers [OPTIONS] [FILES...]

DESCRIPTION

The xbps-checkvers utility checks for outdated packages in a target root directory or in all registered repositories by comparing the package versions against the source package versions available in a void-packages tree. By default it will use the tree located in ˜/void-packages, but this location can be changed with the −D, −-distdir option. By default and unless the −I, −-installed option is set, it will use package versions from repositories to compare against the void-packages tree. The FILES argument sets extra packages to process with the outdated ones (only processed if missing).

OPTIONS
−C, −-config
dir

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

−D, −-distdir dir

Specifies the path to the void-packages tree (usually a git repository). By default set to ˜/void-packages.

−e, −-removed

List packages present in repos, but not in distdir. The source package version will be question mark for them, see documentation for −f, −-format.

−d, −-debug

Enables extra debugging shown to stderr.

−f, −-format format

Format according to the string format, inspired by printf(3).

The following formatting codes may be used:

\n

Newline.

\t

Tab.

\0

NULL.

%%

A plain ‘%’.

%n

The package name.

%r

The package version from repositories or pkgdb (returns ? if not found).

%s

The source package version (returns ? if not found).

%t

The requested template name (this can be a sub package).

%R

The repository url (returns ? if not found).

The default format is “%n %r %s %t %R”.

−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.

−I, −-installed

Check for outdated installed packages rather than in repositories.

−m, −-manual

Only process listed packages.

−R, −-repository=uri

Repository to be added to the top of the list. This option can be specified multiple times.

−r, −-rootdir dir

Specifies a full path for the target root directory.

−s, −-show-all

List all packages found in the void-packages tree and prints version available in repository and srcpkgs with the following format: pkgname repover srcver. If any version can’t be resolved, ? is printed instead.

−-staging

Enables the use of staged packages from remote repositories.

−V, −-version

Show the version information.

EXIT STATUS

A descriptive error message will be printed to stderr.

EXAMPLES

Show all packages in ˜/void-packages, listing the repository version and the srcpkgs version:

$ xbps-checkvers -s

Show packages in ˜/src/void-packages which have a newer version than the installed version:

$ xbps-checkvers -D ˜/src/void-packages -I

Check whether installed package ‘foo’ has a newer version in the void-packages tree:

$ xbps-checkvers -I -m foo

SEE ALSO

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

AUTHORS

Dave Elusive <[email protected]>
Juan Romero Pardines <[email protected]>
Duncan Overbruck <[email protected]>

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 GNU Feb 9, 2023 XBPS-CHECKVERS(1)


Updated 2026-06-01 - jenkler.se | uex.se