diff options
Diffstat (limited to 'upstream/archlinux/man8/checkupdates.8')
| -rw-r--r-- | upstream/archlinux/man8/checkupdates.8 | 150 |
1 files changed, 150 insertions, 0 deletions
diff --git a/upstream/archlinux/man8/checkupdates.8 b/upstream/archlinux/man8/checkupdates.8 new file mode 100644 index 00000000..62b8f150 --- /dev/null +++ b/upstream/archlinux/man8/checkupdates.8 @@ -0,0 +1,150 @@ +'\" t +.\" Title: checkupdates +.\" Author: [see the "Authors" section] +.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> +.\" Date: 2024-01-29 +.\" Manual: Pacman-contrib Manual +.\" Source: Pacman-contrib 1.10.4 +.\" Language: English +.\" +.TH "CHECKUPDATES" "8" "2024\-01\-29" "Pacman\-contrib 1\&.10\&.4" "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 <johannes@kyriasis\&.com> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Daniel M\&. Capella <polyzen@archlinux\&.org> +.RE +.sp +For additional contributors, use git shortlog \-s on the pacman\-contrib\&.git repository\&. |