xbps-checkvers(1)
| 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,--configdir- Specifies a path to the XBPS configuration directory. If the first character is not '/', then it's a path relative to rootdir.
-D,--distdirdir- 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,--formatformat- 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,--rootdirdir- Specifies a full path for the target root directory.
-s,--show-all- List all packages found in the
void-packagestree 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 -sShow packages in ~/src/void-packages which have a newer version than the installed version:
$ xbps-checkvers -D
~/src/void-packages -ICheck whether installed package ‘foo’ has a newer
version in the void-packages tree:
$ xbps-checkvers -I -m
fooSEE 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 |
