Debian Codegraph @

upstream/debian-unstable/man8/dnf5-repoquery.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-REPOQUERY" "8" "May 09, 2026" "" "dnf5"
32 .SH NAME
33 dnf5-repoquery \- Repoquery Command
34 .SH SYNOPSIS
35 .sp
36 \fBdnf5 repoquery [options] [<package\-spec\-NIF>...]\fP
37 .SH DESCRIPTION
38 .sp
39 The \fBrepoquery\fP command in \fBDNF5\fP is used for querying packages by matching
40 various input criteria from the user. Arguments defined in \fBspec\fP list are used
41 as \fB<package\-file\-spec>\fP\&.
42 .SH OPTIONS
43 .INDENT 0.0
44 .TP
45 .B \fB\-\-advisories=ADVISORY_NAME,...\fP
46 .nf
47 Include content contained in advisories with specified name.
48 This is a list option.
49 Expected values are advisory IDs, e.g. \fIFEDORA\-2201\-123\fP\&.
50 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.
51 .fi
52 .sp
53 .UNINDENT
54 .INDENT 0.0
55 .TP
56 .B \fB\-\-advisory\-severities=ADVISORY_SEVERITY,...\fP
57 .nf
58 Include content contained in advisories with specified severity.
59 This is a list option.
60 Accepted values are: \fIcritical\fP, \fIimportant\fP, \fImoderate\fP, \fIlow\fP, \fInone\fP\&.
61 .fi
62 .sp
63 .UNINDENT
64 .INDENT 0.0
65 .TP
66 .B \fB\-\-arch=ARCH,...\fP
67 .nf
68 Limit to packages of these architectures.
69 This is a list option.
70 .fi
71 .sp
72 .TP
73 .B \fB\-\-available\fP
74 .nf
75 Query available packages.
76 This is the default behavior.
77 Can be combined with \fB\-\-installed\fP to query both installed and available packages.
78 .fi
79 .sp
80 .UNINDENT
81 .INDENT 0.0
82 .TP
83 .B \fB\-\-bugfix\fP
84 .nf
85 Include content contained in bugfix advisories.
86 .fi
87 .sp
88 .UNINDENT
89 .INDENT 0.0
90 .TP
91 .B \fB\-\-bzs=BUGZILLA_ID,...\fP
92 .nf
93 Include content contained in advisories that fix a ticket of the given Bugzilla ID.
94 This is a list option.
95 Expected values are numeric IDs, e.g. \fI123123\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\-\-cves=CVE_ID,...\fP
103 .nf
104 Include content contained in advisories that fix a ticket of the given CVE (Common Vulnerabilities and Exposures) ID.
105 This is a list option.
106 Expected values are string IDs in CVE format, e.g. \fICVE\-2201\-0123\fP\&.
107 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.
108 .fi
109 .sp
110 .UNINDENT
111 .INDENT 0.0
112 .TP
113 .B \fB\-\-disable\-modular\-filtering\fP
114 .nf
115 Include packages of inactive module streams.
116 .fi
117 .sp
118 .TP
119 .B \fB\-\-duplicates\fP
120 .nf
121 Limit to installed duplicate packages (i.e. more package versions for the same name and architecture).
122 Installonly packages are excluded from this set.
123 .fi
124 .sp
125 .UNINDENT
126 .INDENT 0.0
127 .TP
128 .B \fB\-\-enhancement\fP
129 .nf
130 Include content contained in enhancement advisories.
131 .fi
132 .sp
133 .UNINDENT
134 .INDENT 0.0
135 .TP
136 .B \fB\-\-exactdeps\fP
137 .nf
138 Limit to packages that require <capability> specified by \-\-whatrequires or \-\-whatdepends.
139 This option is stackable with \-\-whatrequires or \-\-whatdepends only.
140 .fi
141 .sp
142 .TP
143 .B \fB\-\-extras\fP
144 .nf
145 Limit to installed packages that are not present in any available repository.
146 .fi
147 .sp
148 .TP
149 .B \fB\-f, \-\-file=FILE,...\fP
150 .nf
151 Limit to packages that own these files.
152 This is a list option.
153 .fi
154 .sp
155 .TP
156 .B \fB\-\-installed\fP
157 .nf
158 Query installed packages.
159 Can be combined with \fB\-\-available\fP to query both installed and available packages.
160 .fi
161 .sp
162 .UNINDENT
163 .INDENT 0.0
164 .TP
165 .B \fB\-\-installed\-from\-repo=REPO_ID,...\fP
166 .nf
167 Filters installed packages by the ID of the repository they were installed from.
168 .fi
169 .sp
170 .UNINDENT
171 .INDENT 0.0
172 .TP
173 .B \fB\-\-installonly\fP
174 .nf
175 Limit to installed installonly packages.
176 .fi
177 .sp
178 .TP
179 .B \fB\-\-latest\-limit=N\fP
180 .nf
181 Limit to N latest packages for a given name.arch (or all except N latest if N is negative).
182 .fi
183 .sp
184 .TP
185 .B \fB\-\-leaves\fP
186 .nf
187 Limit to groups of installed packages not required by other installed packages.
188 .fi
189 .sp
190 .UNINDENT
191 .INDENT 0.0
192 .TP
193 .B \fB\-\-newpackage\fP
194 .nf
195 Include content contained in newpackage advisories.
196 .fi
197 .sp
198 .UNINDENT
199 .INDENT 0.0
200 .TP
201 .B \fB\-\-providers\-of=PACKAGE_ATTRIBUTE\fP
202 .nf
203 After filtering is finished get selected attribute of packages and output packages that provide it.
204 The outputted packages are limited by \fB\-\-available\fP, \fB\-\-installed\fP and \fB\-\-arch\fP options.
205 Supports: conflicts, depends, enhances, obsoletes, provides, recommends, requires, requires_pre, suggests, supplements.
206 .fi
207 .sp
208 .TP
209 .B \fB\-\-recent\fP
210 .nf
211 Limit to only recently changed packages.
212 .fi
213 .sp
214 .TP
215 .B \fB\-\-recursive\fP
216 .nf
217 This option is stackable with \-\-whatrequires or \-\-providers\-of=requires only.
218 When used with \-\-whatrequires: it extends the output with packages that require anything provided by outputted packages.
219 When used with \-\-providers\-of=requires: it extends the output with packages that provide anything required by outputted packages.
220 It repeats the output extension as long as new packages are being added.
221 The added packages are limited by \fB\-\-available\fP, \fB\-\-installed\fP and \fB\-\-arch\fP options.
222 .fi
223 .sp
224 .UNINDENT
225 .INDENT 0.0
226 .TP
227 .B \fB\-\-security\fP
228 .nf
229 Include content contained in security advisories.
230 .fi
231 .sp
232 .UNINDENT
233 .INDENT 0.0
234 .TP
235 .B \fB\-\-srpm\fP
236 .nf
237 After filtering is finished use packages\(aq corresponding source RPMs for output.
238 Enables source repositories.
239 .fi
240 .sp
241 .TP
242 .B \fB\-\-unneeded\fP
243 .nf
244 Limit to unneeded installed packages (i.e. packages that were installed as dependencies but are no longer needed).
245 This switch lists packages that are going to be removed after executing the \fIautoremove\fP command.
246 .fi
247 .sp
248 .TP
249 .B \fB\-\-upgrades\fP
250 .nf
251 Limit to available packages that provide an upgrade for some already installed package.
252 .fi
253 .sp
254 .TP
255 .B \fB\-\-userinstalled\fP
256 .nf
257 Limit to packages that are not installed as dependencies or weak dependencies.
258 This means limit to packages that were installed at the user request or indirectly as a part of a module profile or comps group. Additionally it returns packages with unknown reason.
259 The result may be influenced by the \(dqexclude\(dq option in the configuration file.
260 To get an exact reason of the installation, use \fB\-\-queryformat \(aq%{name} %{reason}\en\(aq\fP option.
261 .fi
262 .sp
263 .TP
264 .B \fB\-\-whatconflicts=CAPABILITY,...\fP
265 .nf
266 Limit to packages that conflict with any of <capabilities>.
267 This is a list option.
268 .fi
269 .sp
270 .TP
271 .B \fB\-\-whatdepends=CAPABILITY,...\fP
272 .nf
273 Limit to packages that require, enhance, recommend, suggest or supplement any of <capabilities>.
274 This is a list option.
275 .fi
276 .sp
277 .TP
278 .B \fB\-\-whatenhances=CAPABILITY,...\fP
279 .nf
280 Limit to packages that enhance any of <capabilities>. Use \-\-whatdepends if you want to list all depending packages.
281 This is a list option.
282 .fi
283 .sp
284 .TP
285 .B \fB\-\-whatobsoletes=CAPABILITY,...\fP
286 .nf
287 Limit to packages that obsolete any of <capabilities>.
288 This is a list option.
289 .fi
290 .sp
291 .TP
292 .B \fB\-\-whatprovides=CAPABILITY,...\fP
293 .nf
294 Limit to packages that provide any of <capabilities>. Capabilities specifying a file provide \%<#\:file-provides-ref-label> are also matched against file provides.
295 This is a list option.
296 .fi
297 .sp
298 .TP
299 .B \fB\-\-whatrecommends=CAPABILITY,...\fP
300 .nf
301 Limit to packages that recommend any of <capabilities>. Use \-\-whatdepends if you want to list all depending packages.
302 This is a list option.
303 .fi
304 .sp
305 .TP
306 .B \fB\-\-whatrequires=CAPABILITY,...\fP
307 .nf
308 Limit to packages that require any of <capabilities>. Use \-\-whatdepends if you want to list all depending packages.
309 This is a list option.
310 .fi
311 .sp
312 .TP
313 .B \fB\-\-whatsuggests=CAPABILITY,...\fP
314 .nf
315 Limit to packages that suggest any of <capabilities>. Use \-\-whatdepends if you want to list all depending packages.
316 This is a list option.
317 .fi
318 .sp
319 .TP
320 .B \fB\-\-whatsupplements=CAPABILITY,...\fP
321 .nf
322 Limit to packages that supplement any of <capabilities>. Use \-\-whatdepends if you want to list all depending packages.
323 This is a list option.
324 .fi
325 .sp
326 .UNINDENT
327 .SH FORMATTING OPTIONS
328 .sp
329 Set what information is displayed about each package. The following are mutually exclusive, i.e. at most one can be specified. If no formatting option is given, selected packages are displayed in \fB\(dq%{full_nevra}\(dq\fP queryformat.
330 .INDENT 0.0
331 .TP
332 .B \fB\-\-conflicts\fP
333 .nf
334 Like \fB\-\-qf \(dq%{conflicts}\(dq\fP but deduplicated and sorted per line.
335 .fi
336 .sp
337 .TP
338 .B \fB\-\-depends\fP
339 .nf
340 Like \fB\-\-qf \(dq%{depends}\(dq\fP but deduplicated and sorted per line.
341 .fi
342 .sp
343 .TP
344 .B \fB\-\-enhances\fP
345 .nf
346 Like \fB\-\-qf \(dq%{enhances}\(dq\fP but deduplicated and sorted per line.
347 .fi
348 .sp
349 .TP
350 .B \fB\-\-files\fP
351 .nf
352 Like \fB\-\-qf \(dq%{files}\(dq\fP but deduplicated and sorted per line.
353 .fi
354 .sp
355 .TP
356 .B \fB\-\-obsoletes\fP
357 .nf
358 Like \fB\-\-qf \(dq%{obsoletes}\(dq\fP but deduplicated and sorted per line.
359 .fi
360 .sp
361 .TP
362 .B \fB\-\-provides\fP
363 .nf
364 Like \fB\-\-qf \(dq%{provides}\(dq\fP but deduplicated and sorted per line.
365 .fi
366 .sp
367 .TP
368 .B \fB\-\-recommends\fP
369 .nf
370 Like \fB\-\-qf \(dq%{recommends}\(dq\fP but deduplicated and sorted per line.
371 .fi
372 .sp
373 .TP
374 .B \fB\-\-requires\fP
375 .nf
376 Like \fB\-\-qf \(dq%{requires}\(dq\fP but deduplicated and sorted per line.
377 .fi
378 .sp
379 .TP
380 .B \fB\-\-requires\-pre\fP
381 .nf
382 Like \fB\-\-qf \(dq%{requires_pre}\(dq\fP but deduplicated and sorted per line.
383 .fi
384 .sp
385 .TP
386 .B \fB\-\-sourcerpm\fP
387 .nf
388 Like \fB\-\-qf \(dq%{sourcerpm}\(dq\fP but deduplicated and sorted per line.
389 .fi
390 .sp
391 .TP
392 .B \fB\-\-suggests\fP
393 .nf
394 Like \fB\-\-qf \(dq%{suggests}\(dq\fP but deduplicated and sorted per line.
395 .fi
396 .sp
397 .TP
398 .B \fB\-\-supplements\fP
399 .nf
400 Like \fB\-\-qf \(dq%{supplements}\(dq\fP but deduplicated and sorted per line.
401 .fi
402 .sp
403 .TP
404 .B \fB\-\-location\fP
405 .nf
406 Like \fB\-\-qf \(dq%{location}\(dq\fP but deduplicated and sorted per line.
407 .fi
408 .sp
409 .TP
410 .B \fB\-i, \-\-info\fP
411 .nf
412 Show detailed information about the package.
413 .fi
414 .sp
415 .TP
416 .B \fB\-\-changelogs\fP
417 .nf
418 Print the package changelogs.
419 .fi
420 .sp
421 .TP
422 .B \fB\-\-querytags\fP
423 .nf
424 Display available tags for \-\-queryformat.
425 .fi
426 .sp
427 .TP
428 .B \fB\-\-queryformat=<format>\fP
429 .nf
430 Display format for packages. The \fB<format>\fP string can contain tags (\fB%{<tag>}\fP) which are replaced with corresponding attributes of the package.
431 Default is \fB\(dq%{full_nevra}\(dq\fP\&. The \fB<format>\fP string is expanded and deduplicated for each package.
432
433 * \fBarch\fP \- Display architecture of the package.
434 * \fBbuildtime\fP \- Display buildtime of the package in Unix time.
435 * \fBconflicts\fP \- Display capabilities that the package conflicts with. Separated by new lines.
436 * \fBdebug_name\fP \- Display name of debuginfo package of the package.
437 * \fBdepends\fP \- Display capabilities that the package depends on, enhances, recommends, suggests or supplements. Separated by new lines.
438 * \fBdescription\fP \- Display description of the package.
439 * \fBdownloadsize\fP \- Display download size of the package.
440 * \fBenhances\fP \- Display capabilities enhanced by the package. Separated by new lines.
441 * \fBepoch\fP \- Display epoch of the package.
442 * \fBevr\fP \- Display epoch:version\-release of the package. Epoch 0 is omitted.
443 * \fBfiles\fP \- Show files in the package. Separated by new lines.
444 * \fBfrom_repo\fP \- Display id of repository the package is installed from. Empty for not installed packages.
445 * \fBfull_nevra\fP \- Display name\-epoch:version\-release.arch of the package. Even epoch 0 is included.
446 * \fBgroup\fP \- Display group of the package. This is not Comps group.
447 * \fBlocation\fP \- Display location of the package.
448 * \fBinstallsize\fP \- Display install size of the package.
449 * \fBinstalltime\fP \- Display install time of the package.
450 * \fBlicense\fP \- Display license of the package.
451 * \fBname\fP \- Display name of the package.
452 * \fBobsoletes\fP \- Display capabilities obsoleted by the package. Separated by new lines.
453 * \fBpackager\fP \- Display packager of the package.
454 * \fBprereq_ignoreinst\fP \- Display safe to remove requires_pre requirements of an installed package. Empty for not installed packages. Separated by new lines.
455 * \fBprovides\fP \- Display capabilities provided by the package. Separated by new lines.
456 * \fBreason\fP \- Display reason why the packages was installed.
457 * \fBrecommends\fP \- Display capabilities recommended by the package. Separated by new lines.
458 * \fBregular_requires\fP \- Display capabilities required by the package without its \fB%pre\fP, \fB%post\fP, \fB%preun\fP and \fB%postun\fP requirements. Separated by new lines.
459 * \fBrelease\fP \- Display release of the package.
460 * \fBrepoid\fP \- Display id of repository the package is in.
461 * \fBreponame\fP \- Display name of repository the package is in.
462 * \fBrequires\fP \- Display capabilities required by the package (combines regular_requires and requires_pre).
463 * \fBrequires_pre\fP \- For an installed package display capabilities that it depends on to run its \fB%pre\fP, \fB%post\fP, \fB%preun\fP and \fB%postun\fP scripts. For not installed package display just \fB%pre\fP and \fB$post\fP requirements. Separated by new lines.
464 * \fBsource_debug_name\fP \- Display name of debuginfo package for source package of the package.
465 * \fBsource_name\fP \- Display source RPM name of the package.
466 * \fBsourcerpm\fP \- Display source RPM of the package.
467 * \fBsuggests\fP \- Display capabilities suggested by the package. Separated by new lines.
468 * \fBsummary\fP \- Display summary of the package.
469 * \fBsupplements\fP \- Display capabilities supplemented by the package. Separated by new lines.
470 * \fBurl\fP \- Display url of the package.
471 * \fBvendor\fP \- Display vendor of the package.
472 * \fBversion\fP \- Display version of the package.
473
474 The \fB<format>\fP string can also contain \fB\en\fP which will be replaced with a newline character on the output.
475 .fi
476 .sp
477 .UNINDENT
478 .SH EXAMPLES
479 .INDENT 0.0
480 .TP
481 .B \fBdnf5 repoquery /etc/koji.conf\fP
482 .nf
483 List packages which provide the given file.
484 .fi
485 .sp
486 .TP
487 .B \fBdnf5 repoquery *http*\fP
488 .nf
489 List packages containing the \fBhttp\fP inside their name.
490 .fi
491 .sp
492 .TP
493 .B \fBdnf5 repoquery \-\-installed \-\-security\fP
494 .nf
495 List installed packages included in any security advisories.
496 .fi
497 .sp
498 .UNINDENT
499 .SH SEE ALSO
500 .INDENT 0.0
501 .INDENT 3.5
502 .nf
503 \fBdnf5\-advisory(8)\fP, Advisory command \%<#\:advisory-command-ref-label>
504 \fBdnf5\-leaves(8)\fP, Leaves command \%<#\:leaves-command-ref-label>
505 \fBdnf5\-specs(7)\fP, Patterns specification \%<#\:specs-misc-ref-label>
506 .fi
507 .sp
508 .UNINDENT
509 .UNINDENT
510 .SH Author
511 See AUTHORS.md in dnf5 source distribution.
512 .SH Copyright
513 Contributors to the dnf5 project.
514 .\" End of generated man page.