Debian Codegraph @

upstream/mageia-cauldron/man8/dnf5-advisory.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-ADVISORY" "8" "May 10, 2026" "" "dnf5"
31 .SH NAME
32 dnf5-advisory \- Advisory Command
33 .SH SYNOPSIS
34 .sp
35 \fBdnf5 advisory <subcommand> [options] [<advisory\-spec>...]\fP
36 .SH DESCRIPTION
37 .sp
38 The \fBadvisory\fP command in \fBDNF5\fP offers several queries for getting information about
39 advisories and packages related to them.
40 .sp
41 Optional \fBadvisory\-spec\fP arguments could be passed to filter only advisories with given names.
42 .sp
43 \fBNOTE:\fP
44 .INDENT 0.0
45 .INDENT 3.5
46 The \fBupdateinfo\fP command is available as a compatibility alias for \fBadvisory\fP\&.
47 For example, \fBdnf5 updateinfo list\fP is equivalent to \fBdnf5 advisory list\fP\&.
48 .UNINDENT
49 .UNINDENT
50 .SH SUBCOMMANDS
51 .INDENT 0.0
52 .TP
53 .B \fBlist\fP
54 .nf
55 List advisories matching the specified criteria.
56 Displays a table with the following columns: Name (advisory ID), Type, Severity, Package (NEVRA), and Issued (date).
57 When \fB\-\-with\-bz\fP or \fB\-\-with\-cve\fP is specified, the first column shows the Bugzilla or CVE reference ID instead of the advisory name.
58 Installed advisory packages are highlighted in green.
59 .fi
60 .sp
61 .TP
62 .B \fBinfo\fP
63 .nf
64 Print detailed information about advisories.
65 For each matching advisory, displays: Name, Title, Severity, Type, Status, Vendor, Issued date, Description, Message, Rights, References (with Title, Id, Type, and URL), and affected packages/modules organized by collection.
66 .fi
67 .sp
68 .TP
69 .B \fBsummary\fP
70 .nf
71 Print a summary count of advisories by type and severity.
72 Displays a hierarchical summary showing the number of advisories in each category:
73 Security (with subcategories: Critical, Important, Moderate, Low, Other), Bugfix, Enhancement, and Other.
74 The output header indicates the filter mode: Available (default), All, Installed, or Updates.
75 .fi
76 .sp
77 .UNINDENT
78 .SH OPTIONS
79 .INDENT 0.0
80 .TP
81 .B \fB\-\-all\fP
82 .nf
83 Show advisories containing any version of installed packages.
84 .fi
85 .sp
86 .TP
87 .B \fB\-\-available\fP
88 .nf
89 Show advisories containing newer versions of installed packages. This is the default behavior.
90 .fi
91 .sp
92 .TP
93 .B \fB\-\-installed\fP
94 .nf
95 Show advisories containing equal and older versions of installed packages.
96 .fi
97 .sp
98 .TP
99 .B \fB\-\-updates\fP
100 .nf
101 Show advisories containing newer versions of installed packages for which a newer version is available.
102 .fi
103 .sp
104 .TP
105 .B \fB\-\-contains\-pkgs=PACKAGE_NAME,...\fP
106 .nf
107 Show only advisories containing packages with specified names.
108 This is a list option.
109 Only installed packages are matched. Globs are supported.
110 .fi
111 .sp
112 .UNINDENT
113 .INDENT 0.0
114 .TP
115 .B \fB\-\-security\fP
116 .nf
117 Include content contained in security advisories.
118 .fi
119 .sp
120 .UNINDENT
121 .INDENT 0.0
122 .TP
123 .B \fB\-\-bugfix\fP
124 .nf
125 Include content contained in bugfix advisories.
126 .fi
127 .sp
128 .UNINDENT
129 .INDENT 0.0
130 .TP
131 .B \fB\-\-enhancement\fP
132 .nf
133 Include content contained in enhancement advisories.
134 .fi
135 .sp
136 .UNINDENT
137 .INDENT 0.0
138 .TP
139 .B \fB\-\-newpackage\fP
140 .nf
141 Include content contained in newpackage advisories.
142 .fi
143 .sp
144 .UNINDENT
145 .INDENT 0.0
146 .TP
147 .B \fB\-\-advisory\-severities=ADVISORY_SEVERITY,...\fP
148 .nf
149 Include content contained in advisories with specified severity.
150 This is a list option.
151 Accepted values are: \fIcritical\fP, \fIimportant\fP, \fImoderate\fP, \fIlow\fP, \fInone\fP\&.
152 .fi
153 .sp
154 .UNINDENT
155 .INDENT 0.0
156 .TP
157 .B \fB\-\-bzs=BUGZILLA_ID,...\fP
158 .nf
159 Include content contained in advisories that fix a ticket of the given Bugzilla ID.
160 This is a list option.
161 Expected values are numeric IDs, e.g. \fI123123\fP\&.
162 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.
163 .fi
164 .sp
165 .UNINDENT
166 .INDENT 0.0
167 .TP
168 .B \fB\-\-cves=CVE_ID,...\fP
169 .nf
170 Include content contained in advisories that fix a ticket of the given CVE (Common Vulnerabilities and Exposures) ID.
171 This is a list option.
172 Expected values are string IDs in CVE format, e.g. \fICVE\-2201\-0123\fP\&.
173 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.
174 .fi
175 .sp
176 .UNINDENT
177 .INDENT 0.0
178 .TP
179 .B \fB\-\-with\-bz\fP
180 .nf
181 Show only advisories referencing a Bugzilla ticket.
182 .fi
183 .sp
184 .TP
185 .B \fB\-\-with\-cve\fP
186 .nf
187 Show only advisories referencing a CVE ticket.
188 .fi
189 .sp
190 .TP
191 .B \fB\-\-json\fP
192 .nf
193 Request JSON output format for machine\-readable results.
194 Available for \fBlist\fP and \fBinfo\fP subcommands only.
195 .fi
196 .sp
197 .UNINDENT
198 .SH EXAMPLES
199 .INDENT 0.0
200 .TP
201 .B \fBdnf5 advisory info FEDORA\-2022\-07aa56297a\fP
202 .nf
203 Show detailed info about advisory with given name.
204 .fi
205 .sp
206 .TP
207 .B \fBdnf5 advisory summary \-\-contains\-pkgs=kernel,kernel\-core \-\-with\-bz\fP
208 .nf
209 Show a summary of advisories containing \fBkernel\fP or \fBkernel\-core\fP packages and referencing any Bugzilla ticket.
210 .fi
211 .sp
212 .TP
213 .B \fBdnf5 advisory list \-\-security \-\-advisory\-severities=important\fP
214 .nf
215 Show a list of security advisories or advisories with \fBimportant\fP severity.
216 .fi
217 .sp
218 .TP
219 .B \fBdnf5 advisory list \-\-json\fP
220 .nf
221 List all advisories in JSON format for programmatic processing.
222 .fi
223 .sp
224 .TP
225 .B \fBdnf5 advisory list \-\-json \-\-with\-cve\fP
226 .nf
227 List advisories with CVE references in JSON format (extended format).
228 .fi
229 .sp
230 .TP
231 .B \fBdnf5 advisory info FEDORA\-2022\-07aa56297a \-\-json\fP
232 .nf
233 Show detailed info about advisory in JSON format.
234 .fi
235 .sp
236 .UNINDENT
237 .SH JSON OUTPUT
238 .INDENT 0.0
239 .IP \(bu 2
240 \fBdnf5 advisory list \-\-json\fP
241 .UNINDENT
242 .sp
243 The command returns a JSON array, each element describing one advisory.
244 .sp
245 \fBBasic format\fP (without \fB\-\-with\-cve\fP or \fB\-\-with\-bz\fP):
246 .INDENT 0.0
247 .IP \(bu 2
248 \fBname\fP (string) \- Advisory identifier.
249 .IP \(bu 2
250 \fBtype\fP (string) \- Advisory type (security, bugfix, enhancement).
251 .IP \(bu 2
252 \fBseverity\fP (string) \- Advisory severity level.
253 .IP \(bu 2
254 \fBnevra\fP (string) \- Package name\-epoch:version\-release.architecture.
255 .IP \(bu 2
256 \fBbuildtime\fP (integer) \- Advisory build time, UNIX time.
257 .UNINDENT
258 .sp
259 \fBExtended format\fP (with \fB\-\-with\-cve\fP or \fB\-\-with\-bz\fP):
260 .INDENT 0.0
261 .IP \(bu 2
262 \fBadvisory_name\fP (string) \- Advisory identifier.
263 .IP \(bu 2
264 \fBadvisory_type\fP (string) \- Advisory type (security, bugfix, enhancement).
265 .IP \(bu 2
266 \fBadvisory_severity\fP (string) \- Advisory severity level.
267 .IP \(bu 2
268 \fBadvisory_buildtime\fP (integer) \- Advisory build time, UNIX time.
269 .IP \(bu 2
270 \fBnevra\fP (string) \- Package name\-epoch:version\-release.architecture.
271 .IP \(bu 2
272 \fBreferences\fP (array) \- List of references (CVE/Bugzilla). Each reference contains:
273 .INDENT 2.0
274 .IP \(bu 2
275 \fBreference_id\fP (string) \- Reference identifier (e.g., CVE\-2024\-1234).
276 .IP \(bu 2
277 \fBreference_type\fP (string) \- Reference type (cve or bugzilla).
278 .UNINDENT
279 .UNINDENT
280 .INDENT 0.0
281 .IP \(bu 2
282 \fBdnf5 advisory info \-\-json\fP
283 .UNINDENT
284 .sp
285 The command returns a JSON array, each element containing detailed advisory information.
286 Each advisory object contains the following fields:
287 .INDENT 0.0
288 .IP \(bu 2
289 \fBName\fP (string) \- Advisory name/identifier.
290 .IP \(bu 2
291 \fBTitle\fP (string) \- Advisory title.
292 .IP \(bu 2
293 \fBType\fP (string) \- Advisory type (security, bugfix, enhancement).
294 .IP \(bu 2
295 \fBSeverity\fP (string) \- Advisory severity level.
296 .IP \(bu 2
297 \fBStatus\fP (string) \- Advisory status.
298 .IP \(bu 2
299 \fBVendor\fP (string) \- Advisory vendor.
300 .IP \(bu 2
301 \fBIssued\fP (integer) \- Advisory issue time, UNIX time.
302 .IP \(bu 2
303 \fBDescription\fP (string) \- Detailed advisory description.
304 .IP \(bu 2
305 \fBMessage\fP (string) \- Advisory message.
306 .IP \(bu 2
307 \fBRights\fP (string) \- Advisory rights/copyright information.
308 .IP \(bu 2
309 \fBreferences\fP (array) \- List of references (CVE, Bugzilla, etc.). Each reference contains:
310 .INDENT 2.0
311 .IP \(bu 2
312 \fBTitle\fP (string) \- Reference title.
313 .IP \(bu 2
314 \fBId\fP (string) \- Reference identifier (e.g., CVE\-2024\-1234).
315 .IP \(bu 2
316 \fBType\fP (string) \- Reference type (cve, bugzilla, etc.).
317 .IP \(bu 2
318 \fBUrl\fP (string) \- Reference URL.
319 .UNINDENT
320 .IP \(bu 2
321 \fBcollections\fP (object) \- Package and module collections affected by the advisory:
322 .INDENT 2.0
323 .IP \(bu 2
324 \fBpackages\fP (array) \- List of affected package NEVRAs (only present if packages exist).
325 .IP \(bu 2
326 \fBmodules\fP (array) \- List of affected module NSVCAs (only present if modules exist).
327 .UNINDENT
328 .UNINDENT
329 .sp
330 For empty results:
331 .INDENT 0.0
332 .IP \(bu 2
333 \fBdnf5 advisory list \-\-json\fP returns \fB[]\fP (empty array).
334 .IP \(bu 2
335 \fBdnf5 advisory info \-\-json\fP returns \fB[]\fP (empty array).
336 .UNINDENT
337 .SH AUTHOR
338 See AUTHORS.md in dnf5 source distribution.
339 .SH COPYRIGHT
340 Contributors to the dnf5 project.
341 .\" Generated by docutils manpage writer.
342 .