Debian Codegraph @

upstream/mageia-cauldron/man8/dnf5-check-upgrade.8

raw
1 .\" Man page generated from reStructuredText.
2 .
3 .
4 .nr rst2man-indent-level 0
5 .
6 .de1 rstReportMargin
7 \\$1 \\n[an-margin]
8 level \\n[rst2man-indent-level]
9 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
10 -
11 \\n[rst2man-indent0]
12 \\n[rst2man-indent1]
13 \\n[rst2man-indent2]
14 ..
15 .de1 INDENT
16 .\" .rstReportMargin pre:
17 . RS \\$1
18 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
19 . nr rst2man-indent-level +1
20 .\" .rstReportMargin post:
21 ..
22 .de UNINDENT
23 . RE
24 .\" indent \\n[an-margin]
25 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
26 .nr rst2man-indent-level -1
27 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
28 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
29 ..
30 .TH "DNF5-CHECK-UPGRADE" "8" "May 10, 2026" "" "dnf5"
31 .SH NAME
32 dnf5-check-upgrade \- Check-Upgrade Command
33 .SH SYNOPSIS
34 .sp
35 \fBdnf5 check\-upgrade [options] [<package\-spec\-N>...]\fP
36 .SH DESCRIPTION
37 .sp
38 Non\-interactively checks for available updates of specified packages. If no \fB<package\-spec\-N>\fP
39 is provided, it checks for updates for the entire system.
40 .sp
41 \fBDNF5\fP will exit with code \fI100\fP if updates are available and list them; \fI0\fP if no updates
42 are available.
43 .sp
44 If terminal is available, list of the packages is colored, packages available for reinstall are
45 (by default) colored with bold green and packages available for upgrade with bold blue. This
46 behavior can be adjusted in \fBdnf5.conf(5)\fP via \fIcolor_list_available_upgrade\fP and
47 \fIcolor_list_available_reinstall\fP options.
48 .SH OPTIONS
49 .INDENT 0.0
50 .TP
51 .B \fB\-\-changelogs\fP
52 .nf
53 Print the package changelogs.
54 .fi
55 .sp
56 .UNINDENT
57 .INDENT 0.0
58 .TP
59 .B \fB\-\-advisories=ADVISORY_NAME,...\fP
60 .nf
61 Include content contained in advisories with specified name.
62 This is a list option.
63 Expected values are advisory IDs, e.g. \fIFEDORA\-2201\-123\fP\&.
64 Any transaction command (install, upgrade) will fail with an error if there is no existing advisory in the list; this can be bypassed by using the \-\-skip\-unavailable switch.
65 .fi
66 .sp
67 .UNINDENT
68 .INDENT 0.0
69 .TP
70 .B \fB\-\-advisory\-severities=ADVISORY_SEVERITY,...\fP
71 .nf
72 Include content contained in advisories with specified severity.
73 This is a list option.
74 Accepted values are: \fIcritical\fP, \fIimportant\fP, \fImoderate\fP, \fIlow\fP, \fInone\fP\&.
75 .fi
76 .sp
77 .UNINDENT
78 .INDENT 0.0
79 .TP
80 .B \fB\-\-bzs=BUGZILLA_ID,...\fP
81 .nf
82 Include content contained in advisories that fix a ticket of the given Bugzilla ID.
83 This is a list option.
84 Expected values are numeric IDs, e.g. \fI123123\fP\&.
85 Any transaction command (install, upgrade) will fail with an error if there is no advisory fixing the given ticket; this can be bypassed by using the \-\-skip\-unavailable switch.
86 .fi
87 .sp
88 .UNINDENT
89 .INDENT 0.0
90 .TP
91 .B \fB\-\-cves=CVE_ID,...\fP
92 .nf
93 Include content contained in advisories that fix a ticket of the given CVE (Common Vulnerabilities and Exposures) ID.
94 This is a list option.
95 Expected values are string IDs in CVE format, e.g. \fICVE\-2201\-0123\fP\&.
96 Any transaction command (install, upgrade) will fail with an error if there is no advisory fixing the given ticket; this can be bypassed by using the \-\-skip\-unavailable switch.
97 .fi
98 .sp
99 .UNINDENT
100 .INDENT 0.0
101 .TP
102 .B \fB\-\-security\fP
103 .nf
104 Include content contained in security advisories.
105 .fi
106 .sp
107 .UNINDENT
108 .INDENT 0.0
109 .TP
110 .B \fB\-\-bugfix\fP
111 .nf
112 Include content contained in bugfix advisories.
113 .fi
114 .sp
115 .UNINDENT
116 .INDENT 0.0
117 .TP
118 .B \fB\-\-enhancement\fP
119 .nf
120 Include content contained in enhancement advisories.
121 .fi
122 .sp
123 .UNINDENT
124 .INDENT 0.0
125 .TP
126 .B \fB\-\-newpackage\fP
127 .nf
128 Include content contained in newpackage advisories.
129 .fi
130 .sp
131 .UNINDENT
132 .INDENT 0.0
133 .TP
134 .B \fB\-\-minimal\fP
135 .nf
136 Reports the lowest versions of packages that fix advisories of type bugfix, enhancement, security, or
137 newpackage. In case that any option limiting advisories is used it reports the lowest versions of packages
138 that fix advisories matching selected advisory properties\(dq
139 .fi
140 .sp
141 .TP
142 .B \fB\-\-json\fP
143 .nf
144 Request JSON output format.
145 .fi
146 .sp
147 .UNINDENT
148 .SH EXAMPLES
149 .INDENT 0.0
150 .TP
151 .B \fBdnf5 check\-upgrade\fP
152 .nf
153 Print a list of packages that have updates available.
154 .fi
155 .sp
156 .TP
157 .B \fBdnf5 check\-upgrade \-\-changelogs\fP
158 .nf
159 Print changelogs for all packages with pending updates.
160 .fi
161 .sp
162 .UNINDENT
163 .SH JSON OUTPUT
164 .sp
165 \fBdnf5 check\-upgrade \-\-json\fP
166 .sp
167 The command returns a JSON object with the following structure:
168 .INDENT 0.0
169 .IP \(bu 2
170 keys represent a section of the “pretty” CLI output
171 .IP \(bu 2
172 values represent the packages in that section as an array of objects with the following structure:
173 .INDENT 2.0
174 .INDENT 3.5
175 .INDENT 0.0
176 .IP \(bu 2
177 \fBname\fP (string): package name
178 .IP \(bu 2
179 \fBarch\fP (string): package architecture
180 .IP \(bu 2
181 \fBevr\fP (string): available update version
182 .IP \(bu 2
183 \fBrepository\fP (string): repository ID from which the update is available
184 .IP \(bu 2
185 \fBobsoletes\fP (array): (only for the “Obsoleting packages” section) list of the packages that
186 obsolete this package (they have the same structure as above, omitting \fBobsoletes\fP)
187 .UNINDENT
188 .UNINDENT
189 .UNINDENT
190 .UNINDENT
191 .SH SEE ALSO
192 .INDENT 0.0
193 .INDENT 3.5
194 .nf
195 \fBdnf5\-specs(7)\fP, \fI\%Patterns specification\fP
196 .fi
197 .sp
198 .UNINDENT
199 .UNINDENT
200 .SH AUTHOR
201 See AUTHORS.md in dnf5 source distribution.
202 .SH COPYRIGHT
203 Contributors to the dnf5 project.
204 .\" Generated by docutils manpage writer.
205 .