Debian Codegraph @

upstream/debian-unstable/man8/dnf5-check-upgrade.8

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