'\" t .\" Title: checkupdates .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2024-08-24 .\" Manual: Pacman-contrib Manual .\" Source: Pacman-contrib 1.10.6 .\" Language: English .\" .TH "CHECKUPDATES" "8" "2024\-08\-24" "Pacman\-contrib 1\&.10\&.6" "Pacman\-contrib Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" checkupdates \- safely print a list of pending updates .SH "SYNOPSIS" .sp \fIcheckupdates\fR [options] .SH "DESCRIPTION" .sp \fIcheckupdates\fR checks for pending updates using a separate pacman database located in \fBTMPDIR\fR if \fBCHECKUPDATES_DB\fR is not set and outputs a list of updates with the old and new version\&. .SH "OPTIONS" .PP \fB\-c, \-\-change\fR .RS 4 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\&. .RE .PP \fB\-d, \-\-download\fR .RS 4 Download any pending updates to the pacman cache\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 Display syntax and command\-line options\&. .RE .PP \fB\-\-nocolor\fR .RS 4 Do not colorize output\&. Color must be enabled in pacman\&.conf for the listing to be colored to begin with\&. .RE .PP \fB\-n, \-\-nosync\fR .RS 4 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\&. .RE .PP \fB\-V, \-\-version\fR .RS 4 Display version information\&. .RE .SH "ENVIRONMENT" .PP \fBCHECKUPDATES_DB\fR .RS 4 Override the default \fI${TMPDIR:\-/tmp}/checkup\-db\-${UID}\fR temporary database location\&. .RE .PP \fBCHECKUPDATES_CHANGE\fR .RS 4 state file location for the \-c/\-\-change option\&. .RE .PP \fBTMPDIR\fR .RS 4 Override the default \fI/tmp\fR temporary directory\&. .RE .PP \fBXDG_STATE_HOME\fR .RS 4 Override the default \fI$HOME/\&.local/state\fR state directory .RE .SH "ERRORS" .sp On exit, checkupdates will return one of the following error codes\&. .PP 0 .RS 4 Normal exit condition\&. .RE .PP 1 .RS 4 Unknown cause of failure\&. .RE .PP 2 .RS 4 No updates are available\&. .RE .SH "SEE ALSO" .sp \fBpacman\fR(8), \fBpacman.conf\fR(5) .SH "BUGS" .sp 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 https://gitlab\&.archlinux\&.org/pacman/pacman\-contrib/\-/issues/new\&. .SH "AUTHORS" .sp Current maintainers: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Johannes Löthberg .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Daniel M\&. Capella .RE .sp For additional contributors, use git shortlog \-s on the pacman\-contrib\&.git repository\&.