blob: 8bd0fbb480a74e85d45d1df96ee42a72ee5198d7 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
'\" t
.\" Title: checkupdates
.\" Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 2024-05-10
.\" Manual: Pacman-contrib Manual
.\" Source: Pacman-contrib 1.10.6
.\" Language: English
.\"
.TH "CHECKUPDATES" "8" "2024\-05\-10" "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 <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\&.
|
