CHECKUPDATES(8) Pacman-contrib Manual CHECKUPDATES(8)

checkupdates - safely print a list of pending updates

checkupdates [options]

checkupdates checks for pending updates using a separate pacman database located in TMPDIR if CHECKUPDATES_DB is not set and outputs a list of updates with the old and new version.

-c, --change

Check for new available updates only, prints the list of available updates only if it differs from the last time checkupdates was run with that option.

-d, --download

Download any pending updates to the pacman cache.

-h, --help

Display syntax and command-line options.


Do not colorize output. Color must be enabled in pacman.conf for the listing to be colored to begin with.

-n, --nosync

Do not sync the temporary database, works best when the temporary database is updated regularly through some other means such as a cronjob or systemd timer.

-V, --version

Display version information.


Override the default ${TMPDIR:-/tmp}/checkup-db-${UID} temporary database location.


state file location for the -c/--change option.


Override the default /tmp temporary directory.


Override the default $HOME/.local/state state directory

On exit, checkupdates will return one of the following error codes.


Normal exit condition.


Unknown cause of failure.


No updates are available.

pacman(8), pacman.conf(5)

Bugs? You must be kidding; there are no bugs in this software. But if we happen to be wrong, file an issue with as much detail as possible at

Current maintainers:

•Johannes Löthberg <>
•Daniel M. Capella <>

For additional contributors, use git shortlog -s on the pacman-contrib.git repository.

2024-01-29 Pacman-contrib 1.10.4