xbps-checkvers(1)

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

NAME

xbps-checkversXBPS 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

The xbps-checkvers utility exits 0 on success, and >0 if an error occurs. 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 <davehome@redthumb.info.tm>
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

February 9, 2023 Linux 6.12.85-6.12-alt1