XBPS-CHECKVERS(1)

📦 version 0.60.6, in alpine 3.24, nixos 26.05, nixpkgs unstable

💅 XBPS-CHECKVERS(1) — the checkvers glow-up

okay so picture this: xbps-checkvers is the ✨ General Commands Manual ✨ era icon that lives in your terminal and tells you which of your packages are looking a little... outdated. bestie detective energy. 🔍

🌸 NAME 🌸

xbps-checkvers — an XBPS utility that checks for outdated packages. literally its whole job. slay.

🎀 SYNOPSIS 🎀

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

🦋 DESCRIPTION 🦋

okay so here's the vibe: 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. it's giving "who's falling behind" but make it package management. 💅

by default it will use the tree located in ~/void-packages, but this location can be changed with the -D, --distdir option — yes bestie, you can point it somewhere else.

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). so like, extra credit packages. 🫶

✨ 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. no cap, watch that leading slash. 👀
  • -D, --distdir dir — Specifies the path to the void-packages tree (usually a git repository). By default set to ~/void-packages. your home away from home 🏠
  • -e, --removed — List packages present in repos, but not in distdir. the source package version will be a question mark for them, see the documentation for -f, --format. gone but not forgotten 😭
  • -d, --debug — Enables extra debugging shown to stderr. the tea ☕ spills onto stderr only.
  • -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. iconic default, honestly. 🌈

  • -h, --help — Show the help message. we love a helper.
  • -i, --ignore-conf-repos — Ignore repositories defined in configuration files. only repositories specified in the command line via --repository will be used. bye-bye config repos 👋
  • -I, --installed — Check for outdated installed packages rather than in repositories. what's actually on your system, bestie. 💖
  • -m, --manual — Only process listed packages. no extras, no surprises.
  • -R, --repository=uri — Repository to be added to the top of the list. this option can be specified multiple times. stack 'em like your fave accessories 💅
  • -r, --rootdir dir — Specifies a full path for the target root directory. full path only, fr fr.
  • -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. the full roster reveal 👑
  • --staging — Enables the use of staged packages from remote repositories. yes, the staging ones. 🙈
  • -V, --version — Show the version information. flex the version number, periodt.

💀 EXIT STATUS 💀

A descriptive error message will be printed to stderr. that's the whole section bestie, it said what it said.

🔥 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) — the whole friend group, iykyk 🫶

👑 AUTHORS 👑

  • Dave Elusive <davehome@redthumb.info.tm>
  • Juan Romero Pardines <xtraeme@gmail.com>
  • Duncan Overbruck <mail@duncano.de>

the main characters, honestly. 🎀

🍓 BUGS 🍓

Probably, but I try to make this not happen. Use it under your own responsibility and enjoy your life. (that's a direct quote and also genuinely such a mood 😭)

Report bugs at https://github.com/void-linux/xbps/issues — go be a good citizen and file it, bestie 💜

and that's a wrap on XBPS-CHECKVERS(1) from the Debian manual, dated Feb 9, 2023 — mwah, go check those versions ✨💖

📦 where this page comes from