Debian Codegraph @

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