Debian Codegraph @

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