'\" 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\&.