Debian Codegraph @

upstream/debian-unstable/man8/dnf4.8

raw
1 .\" Man page generated from reStructuredText
2 .\" by the Docutils 0.22.2 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 "DNF4" "8" "Oct 24, 2025" "4.24.0" "DNF"
32 .SH NAME
33 dnf4 \- DNF Command Reference
34 .SH SYNOPSIS
35 .sp
36 \fBdnf [options] <command> [<args>...]\fP
37 .SH DESCRIPTION
38 .sp
39 DNF \%<https://\:github\:.com/\:rpm-software-management/\:dnf/> is the next upcoming major version of YUM \%<http://\:yum\:.baseurl\:.org/>, a package manager for RPM\-based Linux
40 distributions. It roughly maintains CLI compatibility with YUM and defines a strict API for
41 extensions and plugins.
42 .sp
43 Plugins can modify or extend features of DNF or provide additional CLI commands on top of those
44 mentioned below. If you know the name of such a command (including commands mentioned below), you
45 may find/install the package which provides it using the appropriate virtual provide in the form of
46 \fBdnf\-command(<alias>)\fP, where \fB<alias>\fP is the name of the command; e.g. \fBdnf install
47 \(aqdnf\-command(versionlock)\(aq\fP installs a \fBversionlock\fP plugin. This approach also applies to
48 specifying dependencies of packages that require a particular DNF command.
49 .sp
50 Return values:
51 .INDENT 0.0
52 .IP \(bu 2
53 \fB0\fP : Operation was successful.
54 .IP \(bu 2
55 \fB1\fP : An error occurred, which was handled by dnf.
56 .IP \(bu 2
57 \fB3\fP : An unknown unhandled error occurred during operation.
58 .IP \(bu 2
59 \fB100\fP: See check\-update
60 .IP \(bu 2
61 \fB200\fP: There was a problem with acquiring or releasing of locks.
62 .UNINDENT
63 .sp
64 Available commands:
65 .INDENT 0.0
66 .IP \(bu 2
67 alias
68 .IP \(bu 2
69 autoremove
70 .IP \(bu 2
71 check
72 .IP \(bu 2
73 check\-update
74 .IP \(bu 2
75 clean
76 .IP \(bu 2
77 deplist
78 .IP \(bu 2
79 distro\-sync
80 .IP \(bu 2
81 downgrade
82 .IP \(bu 2
83 group
84 .IP \(bu 2
85 help
86 .IP \(bu 2
87 history
88 .IP \(bu 2
89 info
90 .IP \(bu 2
91 install
92 .IP \(bu 2
93 list
94 .IP \(bu 2
95 makecache
96 .IP \(bu 2
97 mark
98 .IP \(bu 2
99 module
100 .IP \(bu 2
101 provides
102 .IP \(bu 2
103 reinstall
104 .IP \(bu 2
105 remove
106 .IP \(bu 2
107 repoinfo
108 .IP \(bu 2
109 repolist
110 .IP \(bu 2
111 repoquery
112 .IP \(bu 2
113 repository\-packages
114 .IP \(bu 2
115 search
116 .IP \(bu 2
117 shell
118 .IP \(bu 2
119 swap
120 .IP \(bu 2
121 updateinfo
122 .IP \(bu 2
123 upgrade
124 .IP \(bu 2
125 upgrade\-minimal
126 .UNINDENT
127 .sp
128 Additional information:
129 .INDENT 0.0
130 .IP \(bu 2
131 Options
132 .IP \(bu 2
133 Specifying Packages
134 .IP \(bu 2
135 Specifying Provides
136 .IP \(bu 2
137 Specifying File Provides
138 .IP \(bu 2
139 Specifying Groups
140 .IP \(bu 2
141 Specifying Transactions
142 .IP \(bu 2
143 Metadata Synchronization
144 .IP \(bu 2
145 Configuration Files Replacement Policy
146 .IP \(bu 2
147 Files
148 .IP \(bu 2
149 See Also
150 .UNINDENT
151 .SH OPTIONS
152 .INDENT 0.0
153 .TP
154 .B \fB\-4\fP
155 Resolve to IPv4 addresses only.
156 .TP
157 .B \fB\-6\fP
158 Resolve to IPv6 addresses only.
159 .TP
160 .B \fB\-\-advisory=<advisory>, \-\-advisories=<advisory>\fP
161 Include packages corresponding to the advisory ID, Eg. FEDORA\-2201\-123.
162 Applicable for the \fBinstall\fP, \fBrepoquery\fP, \fBupdateinfo\fP, \fBupgrade\fP and \fBoffline\-upgrade\fP (dnf\-plugins\-core) commands.
163 .TP
164 .B \fB\-\-allowerasing\fP
165 Allow erasing of installed packages to resolve dependencies. This option could be used as an alternative to the \fByum swap\fP command where packages to remove are not explicitly defined.
166 .TP
167 .B \fB\-\-assumeno\fP
168 Automatically answer no for all questions.
169 .TP
170 .B \fB\-b, \-\-best\fP
171 Try the best available package versions in transactions. Specifically during dnf upgrade, which by default skips over updates that can not be installed for dependency reasons, the switch forces DNF to only consider the latest packages. When running into packages with broken dependencies, DNF will fail giving a reason why the latest version can not be installed.
172 .sp
173 Note that the use of the newest available version is only guaranteed for
174 the packages directly requested (e.g. as a command line arguments), and the
175 solver may use older versions of dependencies to meet their requirements.
176 .TP
177 .B \fB\-\-bugfix\fP
178 Include packages that fix a bugfix issue.
179 Applicable for the \fBinstall\fP, \fBrepoquery\fP, \fBupdateinfo\fP, \fBupgrade\fP and \fBoffline\-upgrade\fP (dnf\-plugins\-core) commands.
180 .TP
181 .B \fB\-\-bz=<bugzilla>, \-\-bzs=<bugzilla>\fP
182 Include packages that fix a Bugzilla ID, Eg. 123123.
183 Applicable for the \fBinstall\fP, \fBrepoquery\fP, \fBupdateinfo\fP, \fBupgrade\fP and \fBoffline\-upgrade\fP (dnf\-plugins\-core) commands.
184 .TP
185 .B \fB\-C, \-\-cacheonly\fP
186 Run entirely from system cache, don\(aqt update the cache and use it even in case it is expired.
187 .sp
188 DNF uses a separate cache for each user under which it executes. The cache for the root user is called the system cache. This switch allows a regular user read\-only access to the system cache, which usually is more fresh than the user\(aqs and thus he does not have to wait for metadata sync.
189 .TP
190 .B \fB\-\-color=<color>\fP
191 Control whether color is used in terminal output. Valid values are \fBalways\fP, \fBnever\fP and \fBauto\fP (default).
192 .TP
193 .B \fB\-\-comment=<comment>\fP
194 Add a comment to the transaction history.
195 .TP
196 .B \fB\-c <config file>, \-\-config=<config file>\fP
197 Configuration file location.
198 .TP
199 .B \fB\-\-cve=<cves>, \-\-cves=<cves>\fP
200 Include packages that fix a CVE (Common Vulnerabilities and Exposures) ID
201 (\%<http://\:cve\:.mitre\:.org/\:about/>), Eg. CVE\-2201\-0123.
202 Applicable for the \fBinstall\fP, \fBrepoquery\fP, \fBupdateinfo\fP, \fBupgrade\fP and \fBoffline\-upgrade\fP (dnf\-plugins\-core) commands.
203 .TP
204 .B \fB\-d <debug level>, \-\-debuglevel=<debug level>\fP
205 Debugging output level. This is an integer value between 0 (no additional information strings) and 10 (shows all debugging information, even that not understandable to the user), default is 2. Deprecated, use \fB\-v\fP instead.
206 .TP
207 .B \fB\-\-debugsolver\fP
208 Dump data aiding in dependency solver debugging into \fB\&./debugdata\fP\&.
209 .UNINDENT
210 .INDENT 0.0
211 .TP
212 .B \fB\-\-disableexcludes={all|main|<repoid>}, \-\-disableexcludepkgs={all|main|<repoid>}\fP
213 Disable \fBexcludepkgs\fP and \fBincludepkgs\fP configuration options. Takes one of the following three options:
214 .INDENT 7.0
215 .IP \(bu 2
216 \fBall\fP, disables all \fBexcludepkgs\fP and \fBincludepkgs\fP configurations
217 .IP \(bu 2
218 \fBmain\fP, disables \fBexcludepkgs\fP and \fBincludepkgs\fP defined in the \fB[main]\fP section
219 .IP \(bu 2
220 \fBrepoid\fP, disables \fBexcludepkgs\fP and \fBincludepkgs\fP defined for the given repository
221 .UNINDENT
222 .sp
223 Note that the \-\-exclude option appends to the \fB[main]\fP \fBexcludepkgs\fP configuration and therefore is disabled when \fBmain\fP or \fBall\fP is specified.
224 .TP
225 .B \fB\-\-disable, \-\-set\-disabled\fP
226 Disable specified repositories (automatically saves). The option has to be used together with the
227 \fBconfig\-manager\fP command (dnf\-plugins\-core).
228 .UNINDENT
229 .INDENT 0.0
230 .TP
231 .B \fB\-\-disableplugin=<plugin names>\fP
232 Disable the listed plugins specified by names or globs.
233 .TP
234 .B \fB\-\-disablerepo=<repoid>\fP
235 Temporarily disable active repositories for the purpose of the current dnf command.
236 Accepts an id, a comma\-separated list of ids, or a glob of ids. This option can be
237 specified multiple times, but is mutually exclusive with \fB\-\-repo\fP\&.
238 .TP
239 .B \fB\-\-downloaddir=<path>, \-\-destdir=<path>\fP
240 Redirect downloaded packages to provided directory. The option has to be used together with the \-\-downloadonly command line option, with the
241 \fBdownload\fP, \fBmodulesync\fP, \fBreposync\fP or \fBsystem\-upgrade\fP commands (dnf\-plugins\-core).
242 .UNINDENT
243 .INDENT 0.0
244 .TP
245 .B \fB\-\-downloadonly\fP
246 Download the resolved package set without performing any rpm transaction (install/upgrade/erase).
247 .sp
248 Packages are removed after the next successful transaction. This applies also when used together
249 with \fB\-\-destdir\fP option as the directory is considered as a part of the DNF cache. To persist
250 the packages, use the \fBdownload\fP command instead.
251 .TP
252 .B \fB\-e <error level>, \-\-errorlevel=<error level>\fP
253 Error output level. This is an integer value between 0 (no error output) and
254 10 (shows all error messages), default is 3. Deprecated, use \fB\-v\fP instead.
255 .TP
256 .B \fB\-\-enable, \-\-set\-enabled\fP
257 Enable specified repositories (automatically saves). The option has to be used together with the
258 \fBconfig\-manager\fP command (dnf\-plugins\-core).
259 .TP
260 .B \fB\-\-enableplugin=<plugin names>\fP
261 Enable the listed plugins specified by names or globs.
262 .TP
263 .B \fB\-\-enablerepo=<repoid>\fP
264 Temporarily enable additional repositories for the purpose of the current dnf command.
265 Accepts an id, a comma\-separated list of ids, or a glob of ids. This option can be
266 specified multiple times.
267 .TP
268 .B \fB\-\-enhancement\fP
269 Include enhancement relevant packages.
270 Applicable for the \fBinstall\fP, \fBrepoquery\fP, \fBupdateinfo\fP, \fBupgrade\fP and \fBoffline\-upgrade\fP (dnf\-plugins\-core) commands.
271 .UNINDENT
272 .INDENT 0.0
273 .TP
274 .B \fB\-x <package\-file\-spec>, \-\-exclude=<package\-file\-spec>\fP
275 Exclude packages specified by \fB<package\-file\-spec>\fP from the operation.
276 .TP
277 .B \fB\-\-excludepkgs=<package\-file\-spec>\fP
278 Deprecated option. It was replaced by the \-\-exclude option.
279 .TP
280 .B \fB\-\-forcearch=<arch>\fP
281 Force the use of an architecture. Any architecture can be specified.
282 However, use of an architecture not supported natively by your CPU will
283 require emulation of some kind. This is usually through QEMU. The behavior of \fB\-\-forcearch\fP
284 can be configured by using the arch \%<#\:arch-label> and ignorearch \%<#\:ignorearch-label>
285 configuration options with values \fB<arch>\fP and \fBTrue\fP respectively.
286 .TP
287 .B \fB\-h, \-\-help, \-\-help\-cmd\fP
288 Show the help.
289 .UNINDENT
290 .INDENT 0.0
291 .TP
292 .B \fB\-\-installroot=<path>\fP
293 Specifies an alternative installroot, relative to where all packages will be
294 installed. Think of this like doing \fBchroot <root> dnf\fP, except using
295 \fB\-\-installroot\fP allows dnf to work before the chroot is created. It requires absolute path.
296 .UNINDENT
297 .INDENT 0.0
298 .IP \(bu 2
299 \fIcachedir\fP, \fIlog files\fP, \fIreleasever\fP, and \fIgpgkey\fP are taken from or
300 stored in the installroot. \fIGpgkeys\fP are imported into the installroot from
301 a path relative to the host which can be specified in the repository section
302 of configuration files.
303 .IP \(bu 2
304 \fIconfiguration file\fP and reposdir \%<#\:reposdir-label> are searched inside the installroot first. If
305 they are not present, they are taken from the host system.
306 Note: When a path is specified within a command line argument
307 (\fB\-\-config=<config file>\fP in case of \fIconfiguration file\fP and
308 \fB\-\-setopt=reposdir=<reposdir>\fP for \fIreposdir\fP) then this path is always
309 relative to the host with no exceptions.
310 .IP \(bu 2
311 \fIvars\fP are taken from the host system or installroot according to reposdir \%<#\:reposdir-label>
312 \&. When \fIreposdir\fP path is specified within a command line argument, vars are taken from the
313 installroot. When varsdir \%<#\:varsdir-options-label> paths are specified within a command line
314 argument (\fB\-\-setopt=varsdir=<reposdir>\fP) then those path are always relative to the host with no
315 exceptions.
316 .IP \(bu 2
317 The \fIpluginpath\fP and \fIpluginconfpath\fP are relative to the host.
318 .UNINDENT
319 .INDENT 0.0
320 .INDENT 3.5
321 Note: You may also want to use the command\-line option
322 \fB\-\-releasever=<release>\fP when creating the installroot, otherwise the
323 \fI$releasever\fP value is taken from the rpmdb within the installroot (and thus
324 it is empty at the time of creation and the transaction will fail). If \fB\-\-releasever=/\fP is used, the
325 releasever will be detected from the host (\fB/\fP) system. The new installroot path at the time of creation
326 does not contain the \fIrepository\fP, \fIreleasever\fP and \fIdnf.conf\fP files.
327 .sp
328 On a modular system you may also want to use the
329 \fB\-\-setopt=module_platform_id=<module_platform_name:stream>\fP command\-line option when creating the installroot,
330 otherwise the module_platform_id \%<#\:module-platform-id-label> value will be taken from the
331 \fB/etc/os\-release\fP file within the installroot (and thus it will be empty at the time of creation, the modular
332 dependency could be unsatisfied and modules content could be excluded).
333 .sp
334 Installroot examples:
335 .INDENT 0.0
336 .TP
337 .B \fBdnf \-\-installroot=<installroot> \-\-releasever=<release> install system\-release\fP
338 Permanently sets the \fBreleasever\fP of the system in the
339 \fB<installroot>\fP directory to \fB<release>\fP\&.
340 .TP
341 .B \fBdnf \-\-installroot=<installroot> \-\-setopt=reposdir=<path> \-\-config /path/dnf.conf upgrade\fP
342 Upgrades packages inside the installroot from a repository described by
343 \fB\-\-setopt\fP using configuration from \fB/path/dnf.conf\fP\&.
344 .UNINDENT
345 .UNINDENT
346 .UNINDENT
347 .INDENT 0.0
348 .TP
349 .B \fB\-\-newpackage\fP
350 Include newpackage relevant packages.
351 Applicable for the \fBinstall\fP, \fBrepoquery\fP, \fBupdateinfo\fP, \fBupgrade\fP and \fBoffline\-upgrade\fP (dnf\-plugins\-core) commands.
352 .TP
353 .B \fB\-\-noautoremove\fP
354 Disable removal of dependencies that are no longer used. It sets
355 clean_requirements_on_remove \%<#\:clean-requirements-on-remove-label> configuration option to \fBFalse\fP\&.
356 .TP
357 .B \fB\-\-nobest\fP
358 Set best option to \fBFalse\fP, so that transactions are not limited to best candidates only.
359 .TP
360 .B \fB\-\-nodocs\fP
361 Do not install documentation. Sets the rpm flag \(aqRPMTRANS_FLAG_NODOCS\(aq.
362 .TP
363 .B \fB\-\-nogpgcheck\fP
364 Skip checking GPG signatures on packages (if RPM policy allows).
365 .TP
366 .B \fB\-\-noplugins\fP
367 Disable all plugins.
368 .UNINDENT
369 .INDENT 0.0
370 .TP
371 .B \fB\-\-obsoletes\fP
372 This option has an effect on an install/update, it enables
373 dnf\(aqs obsoletes processing logic. For more information see the
374 obsoletes \%<#\:obsoletes-conf-option-label> option.
375 .sp
376 This option also displays capabilities that the package obsoletes when used together with the repoquery command.
377 .sp
378 Configuration Option: obsoletes \%<#\:obsoletes-conf-option-label>
379 .TP
380 .B \fB\-q, \-\-quiet\fP
381 In combination with a non\-interactive command, shows just the relevant content. Suppresses messages notifying about the current state or actions of DNF.
382 .TP
383 .B \fB\-R <minutes>, \-\-randomwait=<minutes>\fP
384 Maximum command wait time.
385 .UNINDENT
386 .INDENT 0.0
387 .TP
388 .B \fB\-\-refresh\fP
389 Set metadata as expired before running the command.
390 .TP
391 .B \fB\-\-releasever=<release>\fP
392 Configure DNF as if the distribution release was \fB<release>\fP\&. This can
393 affect cache paths, values in configuration files and mirrorlist URLs.
394 .TP
395 .B \fB\-\-releasever_major=<major version>\fP
396 Override the releasever_major variable, which is usually automatically
397 detected or taken from the part of \fB$releasever\fP before the first \fB\&.\fP\&.
398 This option does not affect the \fB$releasever\fP variable.
399 .TP
400 .B \fB\-\-releasever_minor=<minor version>\fP
401 Override the releasever_minor variable, which is usually automatically
402 detected or taken from the part of \fB$releasever\fP after the first \fB\&.\fP\&.
403 This option does not affect the \fB$releasever\fP variable.
404 .UNINDENT
405 .INDENT 0.0
406 .TP
407 .B \fB\-\-repofrompath <repo>,<path/url>\fP
408 Specify a repository to add to the repositories for this query.
409 This option can be used multiple times.
410 .UNINDENT
411 .INDENT 0.0
412 .IP \(bu 2
413 The repository label is specified by \fB<repo>\fP\&.
414 .IP \(bu 2
415 The path or url to the repository is specified by \fB<path/url>\fP\&.
416 It is the same path as a baseurl and can be also enriched by the
417 repo variables \%<#\:repo-variables-label>\&.
418 .IP \(bu 2
419 The configuration for the repository can be adjusted using \-\-setopt=<repo>.<option>=<value>.
420 .IP \(bu 2
421 If you want to view only packages from this repository, combine this
422 with the \fB\-\-repo=<repo>\fP or \fB\-\-disablerepo=\(dq*\(dq\fP switches.
423 .UNINDENT
424 .INDENT 0.0
425 .TP
426 .B \fB\-\-repo=<repoid>, \-\-repoid=<repoid>\fP
427 Enable just specific repositories by an id or a glob. Can be used multiple
428 times with accumulative effect. It is basically a shortcut for
429 \fB\-\-disablerepo=\(dq*\(dq \-\-enablerepo=<repoid>\fP and is mutually exclusive with
430 the \fB\-\-disablerepo\fP option.
431 .TP
432 .B \fB\-\-rpmverbosity=<name>\fP
433 RPM debug scriptlet output level. Sets the debug level to \fB<name>\fP for RPM scriptlets.
434 For available levels, see the \fBrpmverbosity\fP configuration option.
435 .TP
436 .B \fB\-\-sec\-severity=<severity>, \-\-secseverity=<severity>\fP
437 Includes packages that provide a fix for an issue of the specified severity.
438 Applicable for the \fBinstall\fP, \fBrepoquery\fP, \fBupdateinfo\fP, \fBupgrade\fP and \fBoffline\-upgrade\fP (dnf\-plugins\-core) commands.
439 .TP
440 .B \fB\-\-security\fP
441 Includes packages that provide a fix for a security issue.
442 Applicable for the \fBinstall\fP, \fBrepoquery\fP, \fBupdateinfo\fP, \fBupgrade\fP and \fBoffline\-upgrade\fP (dnf\-plugins\-core) commands.
443 .UNINDENT
444 .INDENT 0.0
445 .TP
446 .B \fB\-\-setopt=<option>=<value>\fP
447 Override a configuration option from the configuration file. To override configuration options for repositories, use
448 \fBrepoid.option\fP for the \fB<option>\fP\&. Values for configuration options like \fBexcludepkgs\fP, \fBincludepkgs\fP,
449 \fBinstallonlypkgs\fP and \fBtsflags\fP are appended to the original value, they do not override it. However, specifying
450 an empty value (e.g. \fB\-\-setopt=tsflags=\fP) will clear the option.
451 .UNINDENT
452 .INDENT 0.0
453 .TP
454 .B \fB\-\-skip\-broken\fP
455 Resolve depsolve problems by removing packages that are causing problems from the transaction.
456 It is an alias for the strict \%<#\:strict-label> configuration option with value \fBFalse\fP\&.
457 Additionally, with the enable and
458 disable module subcommands it allows one to perform an action even in case of
459 broken modular dependencies.
460 .TP
461 .B \fB\-\-showduplicates\fP
462 Show duplicate packages in repositories. Applicable for the list and search commands.
463 .UNINDENT
464 .INDENT 0.0
465 .TP
466 .B \fB\-\-transient\fP
467 Applicable only on bootc (bootable containers) systems. Perform transactions using a transient overlay which will be lost on the next reboot. See also the persistence \%<#\:persistence-label> configuration option.
468 .UNINDENT
469 .INDENT 0.0
470 .TP
471 .B \fB\-v, \-\-verbose\fP
472 Verbose operation, show debug messages.
473 .TP
474 .B \fB\-\-version\fP
475 Show DNF version and exit.
476 .TP
477 .B \fB\-y, \-\-assumeyes\fP
478 Automatically answer yes for all questions.
479 .UNINDENT
480 .sp
481 List options are comma\-separated. Command\-line options override respective settings from configuration files.
482 .SH COMMANDS
483 .sp
484 For an explanation of \fB<package\-spec>\fP, \fB<package\-file\-spec>\fP and \fB<package\-name\-spec>\fP see
485 Specifying Packages\&.
486 .sp
487 For an explanation of \fB<provide\-spec>\fP see Specifying Provides\&.
488 .sp
489 For an explanation of \fB<group\-spec>\fP see Specifying Groups\&.
490 .sp
491 For an explanation of \fB<module\-spec>\fP see Specifying Modules\&.
492 .sp
493 For an explanation of \fB<transaction\-spec>\fP see Specifying Transactions\&.
494 .SS Alias Command
495 .nf
496 Command: \fBalias\fP
497 .fi
498 .sp
499 .sp
500 Allows the user to define and manage a list of aliases (in the form \fB<name=value>\fP),
501 which can be then used as dnf commands to abbreviate longer command sequences. For examples on using
502 the alias command, see Alias Examples\&. For examples on the alias
503 processing, see Alias Processing Examples\&.
504 .sp
505 To use an alias (name=value), the name must be placed as the first \(dqcommand\(dq (e.g. the first argument
506 that is not an option). It is then replaced by its value and the resulting sequence is again searched
507 for aliases. The alias processing stops when the first found command is not a name of any alias.
508 .sp
509 In case the processing would result in an infinite recursion, the original arguments are used instead.
510 .sp
511 Also, like in shell aliases, if the result starts with a \fB\e\fP, the alias processing will stop.
512 .sp
513 All aliases are defined in configuration files in the \fB/etc/dnf/aliases.d/\fP directory in the [aliases] section,
514 and aliases created by the alias command are written to the \fBUSER.conf\fP file. In case of conflicts,
515 the \fBUSER.conf\fP has the highest priority, and alphabetical ordering is used for the rest of the
516 configuration files.
517 .sp
518 Optionally, there is the \fBenabled\fP option in the \fB[main]\fP section defaulting to True. This can be set for each
519 file separately in the respective file, or globally for all aliases in the \fBALIASES.conf\fP file.
520 .sp
521 \fBdnf alias [options] [list] [<name>...]\fP
522 .INDENT 0.0
523 .INDENT 3.5
524 List aliases with their final result. The \fB[<alias>...]\fP parameter further limits the result to only those aliases matching it.
525 .UNINDENT
526 .UNINDENT
527 .sp
528 \fBdnf alias [options] add <name=value>...\fP
529 .INDENT 0.0
530 .INDENT 3.5
531 Create new aliases.
532 .UNINDENT
533 .UNINDENT
534 .sp
535 \fBdnf alias [options] delete <name>...\fP
536 .INDENT 0.0
537 .INDENT 3.5
538 Delete aliases.
539 .UNINDENT
540 .UNINDENT
541 .SS Alias Examples
542 .INDENT 0.0
543 .TP
544 .B \fBdnf alias list\fP
545 Lists all defined aliases.
546 .TP
547 .B \fBdnf alias add rm=remove\fP
548 Adds a new command alias called \fBrm\fP which works the same as the \fBremove\fP command.
549 .TP
550 .B \fBdnf alias add upgrade=\(dq\eupgrade \-\-skip\-broken \-\-disableexcludes=all \-\-obsoletes\(dq\fP
551 Adds a new command alias called \fBupgrade\fP which works the same as the \fBupgrade\fP command,
552 with additional options. Note that the original \fBupgrade\fP command is prefixed with a \fB\e\fP
553 to prevent an infinite loop in alias processing.
554 .UNINDENT
555 .SS Alias Processing Examples
556 .sp
557 If there are defined aliases \fBin=install\fP and \fBFORCE=\(dq\-\-skip\-broken \-\-disableexcludes=all\(dq\fP:
558 .INDENT 0.0
559 .IP \(bu 2
560 \fBdnf FORCE in\fP will be replaced with \fBdnf \-\-skip\-broken \-\-disableexcludes=all install\fP
561 .IP \(bu 2
562 \fBdnf in FORCE\fP will be replaced with \fBdnf install FORCE\fP (which will fail)
563 .UNINDENT
564 .sp
565 If there is defined alias \fBin=install\fP:
566 .INDENT 0.0
567 .IP \(bu 2
568 \fBdnf in\fP will be replaced with \fBdnf install\fP
569 .IP \(bu 2
570 \fBdnf \-\-repo updates in\fP will be replaced with \fBdnf \-\-repo updates in\fP (which will fail)
571 .UNINDENT
572 .SS Autoremove Command
573 .nf
574 Command: \fBautoremove\fP
575 Aliases for explicit NEVRA matching: \fBautoremove\-n\fP, \fBautoremove\-na\fP, \fBautoremove\-nevra\fP
576 .fi
577 .sp
578 .sp
579 \fBdnf [options] autoremove\fP
580 .INDENT 0.0
581 .INDENT 3.5
582 Removes all packages from the system that were originally installed as dependencies of user\-installed packages, but which are no longer required by any such package.
583 .UNINDENT
584 .UNINDENT
585 .sp
586 \fBdnf [options] autoremove <spec>...\fP
587 .INDENT 0.0
588 .INDENT 3.5
589 This is an alias for the Remove Command command with clean_requirements_on_remove set to
590 \fBTrue\fP\&. It removes the specified packages from the system along with any packages depending on the
591 packages being removed. Each \fB<spec>\fP can be either a \fB<package\-spec>\fP, which specifies a
592 package directly, or a \fB@<group\-spec>\fP, which specifies an (environment) group which contains
593 it. It also removes any dependencies that are no longer needed.
594 .UNINDENT
595 .UNINDENT
596 .sp
597 There are also a few specific autoremove commands \fBautoremove\-n\fP, \fBautoremove\-na\fP and
598 \fBautoremove\-nevra\fP that allow the specification of an exact argument in the NEVRA
599 (name\-epoch:version\-release.architecture) format.
600 .sp
601 This command by default does not force a sync of expired metadata. See also Metadata Synchronization\&.
602 .SS Check Command
603 .nf
604 Command: \fBcheck\fP
605 .fi
606 .sp
607 .sp
608 \fBdnf [options] check [\-\-dependencies] [\-\-duplicates] [\-\-obsoleted] [\-\-provides]\fP
609 .INDENT 0.0
610 .INDENT 3.5
611 Checks the local packagedb and produces information on any problems it
612 finds. You can limit the checks to be performed by using the \fB\-\-dependencies\fP,
613 \fB\-\-duplicates\fP, \fB\-\-obsoleted\fP and \fB\-\-provides\fP options (the default is to
614 check everything).
615 .UNINDENT
616 .UNINDENT
617 .SS Check\-Update Command
618 .nf
619 Command: \fBcheck\-update\fP
620 Aliases: \fBcheck\-upgrade\fP
621 .fi
622 .sp
623 .INDENT 0.0
624 .TP
625 .B \fBdnf [options] check\-update [\-\-changelogs] [<package\-file\-spec>...]\fP
626 Non\-interactively checks if updates of the specified packages are available. If no \fB<package\-file\-spec>\fP is given, checks whether any updates at all are available for your system. DNF exit code will be 100 when there are updates available and a list of the updates will be printed, 0 if not and 1 if an error occurs. If \fB\-\-changelogs\fP option is specified, also changelog delta of packages about to be updated is printed.
627 .sp
628 Please note that having a specific newer version available for an installed package (and reported by \fBcheck\-update\fP) does not imply that subsequent \fBdnf upgrade\fP will install it. The difference is that \fBdnf upgrade\fP has restrictions (like package dependencies being satisfied) to take into account.
629 .sp
630 The output is affected by the autocheck_running_kernel \%<#\:autocheck-running-kernel-label> configuration option.
631 .UNINDENT
632 .SS Clean Command
633 .nf
634 Command: \fBclean\fP
635 .fi
636 .sp
637 .sp
638 Performs cleanup of temporary files kept for repositories. This includes any
639 such data left behind from disabled or removed repositories as well as for
640 different distribution release versions.
641 .INDENT 0.0
642 .TP
643 .B \fBdnf clean dbcache\fP
644 Removes cache files generated from the repository metadata. This forces DNF
645 to regenerate the cache files the next time it is run.
646 .TP
647 .B \fBdnf clean expire\-cache\fP
648 Marks the repository metadata expired. DNF will re\-validate the cache for
649 each repository the next time it is used.
650 .TP
651 .B \fBdnf clean metadata\fP
652 Removes repository metadata. Those are the files which DNF uses to determine
653 the remote availability of packages. Using this option will make DNF
654 download all the metadata the next time it is run.
655 .TP
656 .B \fBdnf clean packages\fP
657 Removes any cached packages from the system.
658 .TP
659 .B \fBdnf clean all\fP
660 Does all of the above.
661 .UNINDENT
662 .SS Deplist Command
663 .INDENT 0.0
664 .TP
665 .B \fBdnf [options] deplist [<select\-options>] [<query\-options>] [<package\-spec>]\fP
666 Deprecated alias for dnf repoquery \-\-deplist\&.
667 .UNINDENT
668 .SS Distro\-Sync Command
669 .nf
670 Command: \fBdistro\-sync\fP
671 Aliases: \fBdsync\fP
672 Deprecated aliases: \fBdistrosync\fP, \fBdistribution\-synchronization\fP
673 .fi
674 .sp
675 .INDENT 0.0
676 .TP
677 .B \fBdnf distro\-sync [<package\-spec>...]\fP
678 As necessary upgrades, downgrades or keeps selected installed packages to match
679 the latest version available from any enabled repository. If no package is given, all installed packages are considered.
680 .sp
681 See also Configuration Files Replacement Policy\&.
682 .UNINDENT
683 .SS Downgrade Command
684 .nf
685 Command: \fBdowngrade\fP
686 Aliases: \fBdg\fP
687 .fi
688 .sp
689 .INDENT 0.0
690 .TP
691 .B \fBdnf [options] downgrade <package\-spec>...\fP
692 Downgrades the specified packages to the highest installable package of all known lower versions
693 if possible. When version is given and is lower than version of installed package then it
694 downgrades to target version.
695 .UNINDENT
696 .SS Group Command
697 .nf
698 Command: \fBgroup\fP
699 Aliases: \fBgrp\fP
700 Deprecated aliases: \fBgroups\fP, \fBgrouplist\fP, \fBgroupinstall\fP, \fBgroupupdate\fP, \fBgroupremove\fP, \fBgrouperase\fP, \fBgroupinfo\fP
701 .fi
702 .sp
703 .sp
704 Groups are virtual collections of packages. DNF keeps track of groups that the user selected (\(dqmarked\(dq) installed and can manipulate the comprising packages with simple commands.
705 .INDENT 0.0
706 .TP
707 .B \fBdnf [options] group [summary] <group\-spec>\fP
708 Display overview of how many groups are installed and available. With a
709 spec, limit the output to the matching groups. \fBsummary\fP is the default
710 groups subcommand.
711 .TP
712 .B \fBdnf [options] group info <group\-spec>\fP
713 Display package lists of a group. Shows which packages are installed or
714 available from a repository when \fB\-v\fP is used.
715 .TP
716 .B \fBdnf [options] group install [\-\-with\-optional] <group\-spec>...\fP
717 Mark the specified group installed and install packages it contains. Also
718 include \fIoptional\fP packages of the group if \fB\-\-with\-optional\fP is
719 specified. All \fIMandatory\fP and \fIDefault\fP packages will be installed whenever possible.
720 Conditional packages are installed if they meet their requirement.
721 If the group is already (partially) installed, the command installs the missing packages from the group.
722 Depending on the value of obsoletes configuration option \%<#\:obsoletes-conf-option-label> group installation takes obsoletes into account.
723 .UNINDENT
724 .INDENT 0.0
725 .TP
726 .B \fBdnf [options] group list <group\-spec>...\fP
727 List all matching groups, either among installed or available groups. If
728 nothing is specified, list all known groups. \fB\-\-installed\fP and \fB\-\-available\fP options narrow down the requested list.
729 Records are ordered by the \fIdisplay_order\fP tag defined in comps.xml file.
730 Provides a list of all hidden groups by using option \fB\-\-hidden\fP\&.
731 Provides group IDs when the \fB\-v\fP or \fB\-\-ids\fP options are used.
732 .TP
733 .B \fBdnf [options] group remove <group\-spec>...\fP
734 Mark the group removed and remove those packages in the group from the system which do not belong to another installed group and were not installed explicitly by the user.
735 .TP
736 .B \fBdnf [options] group upgrade <group\-spec>...\fP
737 Upgrades the packages from the group and upgrades the group itself. The latter comprises of installing packages that were added to the group by the distribution and removing packages that got removed from the group as far as they were not installed explicitly by the user.
738 .UNINDENT
739 .sp
740 Groups can also be marked installed or removed without physically manipulating any packages:
741 .INDENT 0.0
742 .TP
743 .B \fBdnf [options] group mark install <group\-spec>...\fP
744 Mark the specified group installed. No packages will be installed by this command, but the group is then considered installed.
745 .TP
746 .B \fBdnf [options] group mark remove <group\-spec>...\fP
747 Mark the specified group removed. No packages will be removed by this command.
748 .UNINDENT
749 .sp
750 See also Configuration Files Replacement Policy\&.
751 .SS Help Command
752 .nf
753 Command: \fBhelp\fP
754 .fi
755 .sp
756 .INDENT 0.0
757 .TP
758 .B \fBdnf help [<command>]\fP
759 Displays the help text for all commands. If given a command name then only
760 displays help for that particular command.
761 .UNINDENT
762 .SS History Command
763 .nf
764 Command: \fBhistory\fP
765 Aliases: \fBhist\fP
766 .fi
767 .sp
768 .sp
769 The history command allows the user to view what has happened in past
770 transactions and act according to this information (assuming the
771 \fBhistory_record\fP configuration option is set).
772 .INDENT 0.0
773 .TP
774 .B \fBdnf history [list] [\-\-reverse] [<spec>...]\fP
775 The default history action is listing information about given transactions
776 in a table. Each \fB<spec>\fP can be either a \fB<transaction\-spec>\fP, which
777 specifies a transaction directly, or a \fB<transaction\-spec>..<transaction\-spec>\fP,
778 which specifies a range of transactions, or a \fB<package\-name\-spec>\fP,
779 which specifies a transaction by a package which it manipulated. When no
780 transaction is specified, list all known transactions.
781 .sp
782 Note that transient transactions (see \-\-transient) will be listed even though they do not make
783 persistent changes to files under \fB/usr\fP or to the RPM database.
784 .sp
785 The \(dqAction(s)\(dq column lists each type of action taken in the transaction. The possible values are:
786 .INDENT 7.0
787 .IP \(bu 2
788 Install (I): a new package was installed on the system
789 .IP \(bu 2
790 Downgrade (D): an older version of a package replaced the previously\-installed version
791 .IP \(bu 2
792 Obsolete (O): an obsolete package was replaced by a new package
793 .IP \(bu 2
794 Upgrade (U): a newer version of the package replaced the previously\-installed version
795 .IP \(bu 2
796 Remove (E): a package was removed from the system
797 .IP \(bu 2
798 Reinstall (R): a package was reinstalled with the same version
799 .IP \(bu 2
800 Reason change (C): a package was kept in the system but its reason for being installed changed
801 .UNINDENT
802 .sp
803 The \(dqAltered\(dq column lists the number of actions taken in each transaction, possibly followed by one or two of the following symbols:
804 .INDENT 7.0
805 .IP \(bu 2
806 \fB>\fP: The RPM database was changed, outside DNF, after the transaction
807 .IP \(bu 2
808 \fB<\fP: The RPM database was changed, outside DNF, before the transaction
809 .IP \(bu 2
810 \fB*\fP: The transaction aborted before completion
811 .IP \(bu 2
812 \fB#\fP: The transaction completed, but with a non\-zero status
813 .IP \(bu 2
814 \fBE\fP: The transaction completed successfully, but had warning/error output
815 .UNINDENT
816 .INDENT 7.0
817 .TP
818 .B \fB\-\-reverse\fP
819 The order of \fBhistory list\fP output is printed in reverse order.
820 .UNINDENT
821 .TP
822 .B \fBdnf history info [<spec>...]\fP
823 Describe the given transactions. The meaning of \fB<spec>\fP is the same as
824 in the History List Command\&. When no
825 transaction is specified, describe what happened during the latest
826 transaction.
827 .UNINDENT
828 .INDENT 0.0
829 .TP
830 .B \fBdnf history redo <transaction\-spec>|<package\-file\-spec>\fP
831 Repeat the specified transaction. Uses the last transaction (with the highest ID)
832 if more than one transaction for given <package\-file\-spec> is found. If it is not possible
833 to redo some operations due to the current state of RPMDB, it will not redo the transaction.
834 .UNINDENT
835 .INDENT 0.0
836 .TP
837 .B \fBdnf history replay [\-\-ignore\-installed] [\-\-ignore\-extras] [\-\-skip\-unavailable] <filename>\fP
838 Replay a transaction stored in file \fB<filename>\fP by History Store
839 Command\&. The replay will perform the exact
840 same operations on the packages as in the original transaction and will
841 return with an error if case of any differences in installed packages or
842 their versions. See also the Transaction JSON Format specification \%<#\:transaction-json-label> of the
843 file format.
844 .INDENT 7.0
845 .TP
846 .B \fB\-\-ignore\-installed\fP
847 Don\(aqt check for the installed packages being in the same state as those
848 recorded in the transaction. E.g. in case there is an upgrade
849 \fBfoo\-1.0\fP \-> \fBfoo\-2.0\fP stored in the transaction, but there is
850 \fBfoo\-1.1\fP installed on the target system.
851 .TP
852 .B \fB\-\-ignore\-extras\fP
853 Don\(aqt check for extra packages pulled into the transaction on the
854 target system. E.g. the target system may not have some dependency,
855 which was installed on the source system. The replay errors out on this
856 by default, as the transaction would not be the same.
857 .TP
858 .B \fB\-\-skip\-unavailable\fP
859 In case some packages stored in the transaction are not available on
860 the target system, skip them instead of erroring out.
861 .UNINDENT
862 .TP
863 .B \fBdnf history rollback <transaction\-spec>|<package\-file\-spec>\fP
864 Undo all transactions performed after the specified transaction. Uses the last transaction
865 (with the highest ID) if more than one transaction for given <package\-file\-spec> is found.
866 If it is not possible to undo some transactions due to the current state of RPMDB, it will not undo
867 any transaction.
868 .UNINDENT
869 .INDENT 0.0
870 .TP
871 .B \fBdnf history store [\-\-output <output\-file>] <transaction\-spec>\fP
872 Store a transaction specified by \fB<transaction\-spec>\fP\&. The transaction
873 can later be replayed by the History Replay Command\&.
874 .sp
875 Warning: The stored transaction format is considered unstable and may
876 change at any time. It will work if the same version of dnf is used to
877 store and replay (or between versions as long as it stays the same).
878 .sp
879 \fB\-o <output\-file>, \-\-output=<output\-file>\fP
880 Store the serialized transaction into \fB<output\-file\fP\&. Default is \fBtransaction.json\fP\&.
881 .TP
882 .B \fBdnf history undo <transaction\-spec>|<package\-file\-spec>\fP
883 Perform the opposite operation to all operations performed in the specified transaction.
884 Uses the last transaction (with the highest ID) if more than one transaction for given
885 <package\-file\-spec> is found. If it is not possible to undo some operations due to
886 the current state of RPMDB, it will not undo the transaction.
887 .TP
888 .B \fBdnf history userinstalled\fP
889 Show all packages installed by user, installed from a group or a module profile, and packages
890 installed outside of DNF. I.e. it lists packages that will stay on the system when
891 Autoremove Command or Remove Command along with
892 \fIclean_requirements_on_remove\fP configuration option set to True is executed. Note the same
893 results can be accomplished with \fBdnf repoquery \-\-userinstalled\fP, and the repoquery
894 command is more powerful in formatting of the output.
895 .UNINDENT
896 .sp
897 This command by default does not force a sync of expired metadata, except for
898 the redo, rollback, and undo subcommands.
899 See also Metadata Synchronization
900 and Configuration Files Replacement Policy\&.
901 .SS Info Command
902 .nf
903 Command: \fBinfo\fP
904 Aliases: \fBif\fP
905 .fi
906 .sp
907 .INDENT 0.0
908 .TP
909 .B \fBdnf [options] info [<package\-file\-spec>...]\fP
910 Lists description and summary information about installed and available packages.
911 .UNINDENT
912 .sp
913 The info command limits the displayed packages the same way as the list command\&.
914 .sp
915 This command by default does not force a sync of expired metadata. See also Metadata Synchronization\&.
916 .SS Install Command
917 .nf
918 Command: \fBinstall\fP
919 Aliases: \fBin\fP
920 Aliases for explicit NEVRA matching: \fBinstall\-n\fP, \fBinstall\-na\fP, \fBinstall\-nevra\fP
921 Deprecated aliases: \fBlocalinstall\fP
922 .fi
923 .sp
924 .INDENT 0.0
925 .TP
926 .B \fBdnf [options] install <spec>...\fP
927 Makes sure that the given packages and their dependencies are installed
928 on the system. Each \fB<spec>\fP can be either a <package\-spec>,
929 or a @<module\-spec>, or a @<group\-spec>\&.
930 See Install Examples\&.
931 If a given package or provide cannot be (and is not already) installed,
932 the exit code will be non\-zero.
933 If the \fB<spec>\fP matches both a @<module\-spec> and
934 a @<group\-spec>, only the module is installed.
935 .sp
936 When <package\-spec> to specify the exact version
937 of the package is given, DNF will install the desired version, no matter which
938 version of the package is already installed. The former version of the package
939 will be removed in the case of non\-installonly package.
940 .sp
941 On the other hand if <package\-spec> specifies only a name,
942 DNF also takes into account packages obsoleting it when picking which package to install.
943 This behaviour is specific to the install command.
944 Note that this can lead to seemingly unexpected results if a package has multiple versions and
945 some older version is being obsoleted. It creates a split in the upgrade\-path and both ways
946 are considered correct, the resulting package is picked simply by lexicographical order.
947 .UNINDENT
948 .sp
949 There are also a few specific install commands \fBinstall\-n\fP, \fBinstall\-na\fP and
950 \fBinstall\-nevra\fP that allow the specification of an exact argument in the NEVRA format. As a consequence, <spec>
951 will be not matched with provides and file provides.
952 .sp
953 See also Configuration Files Replacement Policy\&.
954 .SS Install Examples
955 .INDENT 0.0
956 .TP
957 .B \fBdnf install tito\fP
958 Install the \fBtito\fP package (tito is the package name).
959 .TP
960 .B \fBdnf install ~/Downloads/tito\-0.6.2\-1.fc22.noarch.rpm\fP
961 Install a local rpm file tito\-0.6.2\-1.fc22.noarch.rpm from the ~/Downloads/
962 directory.
963 .TP
964 .B \fBdnf install tito\-0.5.6\-1.fc22\fP
965 Install the package with a specific version. If the package is already installed it
966 will automatically try to downgrade or upgrade to the specific version.
967 .TP
968 .B \fBdnf \-\-best install tito\fP
969 Install the latest available version of the package. If the package is already installed it
970 will try to automatically upgrade to the latest version. If the latest version
971 of the package cannot be installed, the installation will fail.
972 .TP
973 .B \fBdnf install vim\fP
974 DNF will automatically recognize that vim is not a package name, but
975 will look up and install a package that provides vim with all the required
976 dependencies. Note: Package name match has precedence over package provides
977 match.
978 .TP
979 .B \fBdnf install https://kojipkgs.fedoraproject.org//packages/tito/0.6.0/1.fc22/noarch/tito\-0.6.0\-1.fc22.noarch.rpm\fP
980 Install a package directly from a URL.
981 .TP
982 .B \fBdnf install \(aq@docker\(aq\fP
983 Install all default profiles of module \(aqdocker\(aq and their RPMs. Module streams get enabled accordingly.
984 .TP
985 .B \fBdnf install \(aq@Web Server\(aq\fP
986 Install the \(aqWeb Server\(aq environmental group.
987 .TP
988 .B \fBdnf install /usr/bin/rpmsign\fP
989 Install a package that provides the /usr/bin/rpmsign file.
990 .TP
991 .B \fBdnf \-y install tito \-\-setopt=install_weak_deps=False\fP
992 Install the \fBtito\fP package (tito is the package name) without weak deps. Weak deps are not required for
993 core functionality of the package, but they enhance the original package (like extended
994 documentation, plugins, additional functions, etc.).
995 .TP
996 .B \fBdnf install \-\-advisory=FEDORA\-2018\-b7b99fe852 \e*\fP
997 Install all packages that belong to the \(dqFEDORA\-2018\-b7b99fe852\(dq advisory.
998 .UNINDENT
999 .SS List Command
1000 .nf
1001 Command: \fBlist\fP
1002 Aliases: \fBls\fP
1003 .fi
1004 .sp
1005 .sp
1006 Prints lists of packages depending on the packages\(aq relation to the
1007 system. A package is \fBinstalled\fP if it is present in the RPMDB, and it is \fBavailable\fP
1008 if it is not installed but is present in a repository that DNF knows about.
1009 .sp
1010 The list command also limits the displayed packages according to specific criteria,
1011 e.g. to only those that update an installed package (respecting the repository
1012 priority \%<#\:repo-priority-label>). The exclude \%<#\:exclude-label> option in the configuration file can influence the
1013 result, but if the \-\-disableexcludes command line
1014 option is used, it ensures that all installed packages will be listed.
1015 .INDENT 0.0
1016 .TP
1017 .B \fBdnf [options] list [\-\-all] [<package\-file\-spec>...]\fP
1018 Lists all packages, present in the RPMDB, in a repository or both.
1019 .TP
1020 .B \fBdnf [options] list \-\-installed [<package\-file\-spec>...]\fP
1021 Lists installed packages.
1022 .TP
1023 .B \fBdnf [options] list \-\-available [<package\-file\-spec>...]\fP
1024 Lists available packages.
1025 .TP
1026 .B \fBdnf [options] list \-\-extras [<package\-file\-spec>...]\fP
1027 Lists extras, that is packages installed on the system that are not
1028 available in any known repository.
1029 .TP
1030 .B \fBdnf [options] list \-\-obsoletes [<package\-file\-spec>...]\fP
1031 List packages installed on the system that are obsoleted by packages in
1032 any known repository.
1033 .TP
1034 .B \fBdnf [options] list \-\-recent [<package\-file\-spec>...]\fP
1035 List packages recently added into the repositories.
1036 .TP
1037 .B \fBdnf [options] list \-\-upgrades [<package\-file\-spec>...]\fP
1038 List upgrades available for the installed packages.
1039 .TP
1040 .B \fBdnf [options] list \-\-autoremove\fP
1041 List packages which will be removed by the \fBdnf autoremove\fP command.
1042 .UNINDENT
1043 .sp
1044 This command by default does not force a sync of expired metadata. See also Metadata Synchronization\&.
1045 .SS Makecache Command
1046 .nf
1047 Command: \fBmakecache\fP
1048 Aliases: \fBmc\fP
1049 .fi
1050 .sp
1051 .INDENT 0.0
1052 .TP
1053 .B \fBdnf [options] makecache\fP
1054 Downloads and caches metadata for enabled repositories. Tries to
1055 avoid downloading whenever possible (e.g. when the local metadata hasn\(aqt
1056 expired yet or when the metadata timestamp hasn\(aqt changed).
1057 .TP
1058 .B \fBdnf [options] makecache \-\-timer\fP
1059 Like plain \fBmakecache\fP, but instructs DNF to be more resource\-aware,
1060 meaning it will not do anything if running on battery power, it will terminate
1061 immediately if it\(aqs too soon after the last successful \fBmakecache\fP run
1062 (see \fBdnf.conf(5)\fP, metadata_timer_sync \%<#\:metadata-timer-sync-label>), and if the first mirror in a repository mirrorlist fails,
1063 it will not try to synchronize the metadata from more mirrors for that repository.
1064 .UNINDENT
1065 .SS Mark Command
1066 .nf
1067 Command: \fBmark\fP
1068 .fi
1069 .sp
1070 .INDENT 0.0
1071 .TP
1072 .B \fBdnf mark install <package\-spec>...\fP
1073 Marks the specified packages as installed by user. This can be useful if any package was installed as a dependency and is desired to stay on the system when Autoremove Command or Remove Command along with \fIclean_requirements_on_remove\fP configuration option set to \fBTrue\fP is executed.
1074 .TP
1075 .B \fBdnf mark remove <package\-spec>...\fP
1076 Unmarks the specified packages as installed by user. Whenever you as a user don\(aqt need a specific package you can mark it for removal. The package stays installed on the system but will be removed when Autoremove Command or Remove Command along with \fIclean_requirements_on_remove\fP configuration option set to \fBTrue\fP is executed. You should use this operation instead of Remove Command if you\(aqre not sure whether the package is a requirement of other user installed packages on the system.
1077 .TP
1078 .B \fBdnf mark group <package\-spec>...\fP
1079 Marks the specified packages as installed by group. This can be useful if any package was
1080 installed as a dependency or a user and is desired to be protected and handled as a group
1081 member like during group remove.
1082 .UNINDENT
1083 .SS Module Command
1084 .nf
1085 Command: \fBmodule\fP
1086 .fi
1087 .sp
1088 .sp
1089 \fBWarning:\fP
1090 .INDENT 0.0
1091 .INDENT 3.5
1092 Modularity is deprecated, and functionality will be removed in a future release of DNF5.
1093 .UNINDENT
1094 .UNINDENT
1095 .sp
1096 Modularity overview is available at man page dnf.modularity(7) \%<#\:modularity-label>\&.
1097 Module subcommands take <module\-spec>\&... arguments that specify modules or profiles.
1098 .INDENT 0.0
1099 .TP
1100 .B \fBdnf [options] module install <module\-spec>...\fP
1101 Install module profiles, including their packages.
1102 In case no profile was provided, all default profiles get installed.
1103 Module streams get enabled accordingly.
1104 .sp
1105 This command cannot be used for switching module streams. Use the
1106 dnf module switch\-to command for that.
1107 .TP
1108 .B \fBdnf [options] module update <module\-spec>...\fP
1109 Update packages associated with an active module stream, optionally restricted to a profile.
1110 If the \fIprofile_name\fP is provided, only the packages referenced by that profile will be updated.
1111 .UNINDENT
1112 .INDENT 0.0
1113 .TP
1114 .B \fBdnf [options] module switch\-to <module\-spec>...\fP
1115 Switch to or enable a module stream, change versions of installed packages to versions provided
1116 by the new stream, and remove packages from the old stream that are no longer available. It also
1117 updates installed profiles if they are available for the new stream. When a profile was
1118 provided, it installs that profile and does not update any already installed profiles.
1119 .sp
1120 This command can be used as a stronger version of the
1121 dnf module enable command, which not only enables modules,
1122 but also does a \fIdistrosync\fP to all modular packages in the enabled modules.
1123 .sp
1124 It can also be used as a stronger version of the
1125 dnf module install command, but it requires to specify
1126 profiles that are supposed to be installed, because \fIswitch\-to\fP command does not use \fIdefault
1127 profiles\fP\&. The \fIswitch\-to\fP command doesn\(aqt only install profiles, it also makes a \fIdistrosync\fP
1128 to all modular packages in the installed module.
1129 .TP
1130 .B \fBdnf [options] module remove <module\-spec>...\fP
1131 Remove installed module profiles, including packages that were installed with the
1132 dnf module install command. Will not remove packages
1133 required by other installed module profiles or by other user\-installed packages.
1134 In case no profile was provided, all installed profiles get removed.
1135 .TP
1136 .B \fBdnf [options] module remove \-\-all <module\-spec>...\fP
1137 Remove installed module profiles, including packages that were installed with the
1138 dnf module install command.
1139 With \-\-all option it additionally removes all packages whose names are provided by specified
1140 modules. Packages required by other installed module profiles and packages whose names are also
1141 provided by any other module are not removed.
1142 .UNINDENT
1143 .INDENT 0.0
1144 .TP
1145 .B \fBdnf [options] module enable <module\-spec>...\fP
1146 Enable a module stream and make the stream RPMs available in the package set.
1147 .sp
1148 Modular dependencies are resolved, dependencies checked and also recursively enabled. In case
1149 of modular dependency issue the operation will be rejected. To perform the action anyway please use
1150 \-\-skip\-broken option.
1151 .sp
1152 This command cannot be used for switching module streams. Use the
1153 dnf module switch\-to command for that.
1154 .UNINDENT
1155 .INDENT 0.0
1156 .TP
1157 .B \fBdnf [options] module disable <module\-name>...\fP
1158 Disable a module. All related module streams will become unavailable.
1159 Consequently, all installed profiles will be removed and the module RPMs
1160 will become unavailable in the package set. In case of modular
1161 dependency issue the operation will be rejected. To perform the action anyway please use \-\-skip\-broken option.
1162 .UNINDENT
1163 .INDENT 0.0
1164 .TP
1165 .B \fBdnf [options] module reset <module\-name>...\fP
1166 Reset module state so it\(aqs no longer enabled or disabled.
1167 Consequently, all installed profiles will be removed and
1168 only RPMs from the default stream will be available in the package set.
1169 .UNINDENT
1170 .INDENT 0.0
1171 .TP
1172 .B \fBdnf [options] module provides <package\-name\-spec>...\fP
1173 Lists all modular packages matching \fB<package\-name\-spec>\fP from all modules (including disabled), along with the modules and streams they belong to.
1174 .TP
1175 .B \fBdnf [options] module list [\-\-all] [module_name...]\fP
1176 Lists all module streams, their profiles and states (enabled, disabled, default).
1177 .TP
1178 .B \fBdnf [options] module list \-\-enabled [module_name...]\fP
1179 Lists module streams that are enabled.
1180 .TP
1181 .B \fBdnf [options] module list \-\-disabled [module_name...]\fP
1182 Lists module streams that are disabled.
1183 .TP
1184 .B \fBdnf [options] module list \-\-installed [module_name...]\fP
1185 List module streams with installed profiles.
1186 .TP
1187 .B \fBdnf [options] module info <module\-spec>...\fP
1188 Print detailed information about given module stream.
1189 .TP
1190 .B \fBdnf [options] module info \-\-profile <module\-spec>...\fP
1191 Print detailed information about given module profiles.
1192 .TP
1193 .B \fBdnf [options] module repoquery <module\-spec>...\fP
1194 List all available packages belonging to selected modules.
1195 .TP
1196 .B \fBdnf [options] module repoquery \-\-available <module\-spec>...\fP
1197 List all available packages belonging to selected modules.
1198 .TP
1199 .B \fBdnf [options] module repoquery \-\-installed <module\-spec>...\fP
1200 List all installed packages with same name like packages belonging to selected modules.
1201 .UNINDENT
1202 .SS Provides Command
1203 .nf
1204 Command: \fBprovides\fP
1205 Aliases: \fBprov\fP, \fBwhatprovides\fP, \fBwp\fP
1206 .fi
1207 .sp
1208 .INDENT 0.0
1209 .TP
1210 .B \fBdnf [options] provides <provide\-spec>\fP
1211 Finds the packages providing the given \fB<provide\-spec>\fP\&. This is useful
1212 when one knows a filename and wants to find what package (installed or not)
1213 provides this file.
1214 The \fB<provide\-spec>\fP is gradually looked for at following locations:
1215 .INDENT 7.0
1216 .IP 1. 3
1217 The \fB<provide\-spec>\fP is matched with all file provides of any available package:
1218 .INDENT 3.0
1219 .INDENT 3.5
1220 .sp
1221 .EX
1222 $ dnf provides /usr/bin/gzip
1223 gzip\-1.9\-9.fc29.x86_64 : The GNU data compression program
1224 Matched from:
1225 Filename : /usr/bin/gzip
1226 .EE
1227 .UNINDENT
1228 .UNINDENT
1229 .IP 2. 3
1230 Then all provides of all available packages are searched:
1231 .INDENT 3.0
1232 .INDENT 3.5
1233 .sp
1234 .EX
1235 $ dnf provides \(dqgzip(x86\-64)\(dq
1236 gzip\-1.9\-9.fc29.x86_64 : The GNU data compression program
1237 Matched from:
1238 Provide : gzip(x86\-64) = 1.9\-9.fc29
1239 .EE
1240 .UNINDENT
1241 .UNINDENT
1242 .IP 3. 3
1243 DNF assumes that the \fB<provide\-spec>\fP is a system command, prepends it with \fB/usr/bin/\fP, \fB/usr/sbin/\fP prefixes (one at a time) and does the file provides search again. For legacy reasons (packages that didn\(aqt do UsrMove) also \fB/bin\fP and \fB/sbin\fP prefixes are being searched:
1244 .INDENT 3.0
1245 .INDENT 3.5
1246 .sp
1247 .EX
1248 $ dnf provides zless
1249 gzip\-1.9\-9.fc29.x86_64 : The GNU data compression program
1250 Matched from:
1251 Filename : /usr/bin/zless
1252 .EE
1253 .UNINDENT
1254 .UNINDENT
1255 .IP 4. 3
1256 If this last step also fails, DNF returns \(dqError: No Matches found\(dq.
1257 .UNINDENT
1258 .UNINDENT
1259 .sp
1260 This command by default does not force a sync of expired metadata. See also Metadata Synchronization\&.
1261 .SS Reinstall Command
1262 .nf
1263 Command: \fBreinstall\fP
1264 Aliases: \fBrei\fP
1265 .fi
1266 .sp
1267 .INDENT 0.0
1268 .TP
1269 .B \fBdnf [options] reinstall <package\-spec>...\fP
1270 Installs the specified packages, fails if some of the packages are either
1271 not installed or not available (i.e. there is no repository where to
1272 download the same RPM).
1273 .UNINDENT
1274 .SS Remove Command
1275 .nf
1276 Command: \fBremove\fP
1277 Aliases: \fBrm\fP
1278 Aliases for explicit NEVRA matching: \fBremove\-n\fP, \fBremove\-na\fP, \fBremove\-nevra\fP
1279 Deprecated aliases: \fBerase\fP, \fBerase\-n\fP, \fBerase\-na\fP, \fBerase\-nevra\fP
1280 .fi
1281 .sp
1282 .INDENT 0.0
1283 .TP
1284 .B \fBdnf [options] remove <package\-spec>...\fP
1285 Removes the specified packages from the system along with any packages depending on the packages being removed. Each \fB<spec>\fP can be either a \fB<package\-spec>\fP, which specifies a package directly, or a \fB@<group\-spec>\fP, which specifies an (environment) group which contains it. If \fBclean_requirements_on_remove\fP is enabled (the default), also removes any dependencies that are no longer needed.
1286 .TP
1287 .B \fBdnf [options] remove \-\-duplicates\fP
1288 Removes older versions of duplicate packages. To ensure the integrity of the system it
1289 reinstalls the newest package. In some cases the command cannot resolve conflicts. In such cases
1290 the dnf shell command with \fBremove \-\-duplicates\fP and \fBupgrade\fP
1291 dnf\-shell sub\-commands could help.
1292 .TP
1293 .B \fBdnf [options] remove \-\-oldinstallonly\fP
1294 Removes old installonly packages, keeping only latest versions and version of running kernel.
1295 .UNINDENT
1296 .sp
1297 There are also a few specific remove commands \fBremove\-n\fP, \fBremove\-na\fP and \fBremove\-nevra\fP
1298 that allow the specification of an exact argument in the NEVRA format. As a consequence, <spec>
1299 will be not matched with provides and file provides.
1300 .SS Remove Examples
1301 .INDENT 0.0
1302 .TP
1303 .B \fBdnf remove acpi tito\fP
1304 Remove the \fBacpi\fP and \fBtito\fP packages.
1305 .TP
1306 .B \fBdnf remove $(dnf repoquery \-\-extras \-\-exclude=tito,acpi)\fP
1307 Remove packages not present in any repository, but don\(aqt remove the \fBtito\fP
1308 and \fBacpi\fP packages (they still might be removed if they depend on some of the removed packages).
1309 .TP
1310 .B \fBdnf remove \-\-duplicates\fP
1311 Remove older versions of duplicated packages (an equivalent of yum\(aqs \fIpackage\-cleanup \-\-cleandups\fP).
1312 .UNINDENT
1313 .SS Repoinfo Command
1314 .nf
1315 Command: \fBrepoinfo\fP
1316 .fi
1317 .sp
1318 .sp
1319 An alias for the repolist command
1320 that provides more detailed information like \fBdnf repolist \-v\fP\&.
1321 .SS Repolist Command
1322 .nf
1323 Command: \fBrepolist\fP
1324 .fi
1325 .sp
1326 .INDENT 0.0
1327 .TP
1328 .B \fBdnf [options] repolist [\-\-enabled|\-\-disabled|\-\-all]\fP
1329 Depending on the exact command lists enabled, disabled or all known
1330 repositories. Lists all enabled repositories by default. Provides more
1331 detailed information when \fB\-v\fP option is used.
1332 .UNINDENT
1333 .sp
1334 This command by default does not force a sync of expired metadata. See also Metadata Synchronization\&.
1335 .SS Repoquery Command
1336 .nf
1337 Command: \fBrepoquery\fP
1338 Aliases: \fBrq\fP
1339 Aliases for explicit NEVRA matching: \fBrepoquery\-n\fP, \fBrepoquery\-na\fP, \fBrepoquery\-nevra\fP
1340 .fi
1341 .sp
1342 .INDENT 0.0
1343 .TP
1344 .B \fBdnf [options] repoquery [<select\-options>] [<query\-options>] [<package\-file\-spec>]\fP
1345 Searches available DNF repositories for selected packages and displays the requested information about them. It
1346 is an equivalent of \fBrpm \-q\fP for remote repositories.
1347 .TP
1348 .B \fBdnf [options] repoquery \-\-groupmember <package\-spec>...\fP
1349 List groups that contain <package\-spec>.
1350 .TP
1351 .B \fBdnf [options] repoquery \-\-querytags\fP
1352 Provides the list of tags recognized by the \-\-queryformat repoquery option.
1353 .UNINDENT
1354 .sp
1355 There are also a few specific repoquery commands \fBrepoquery\-n\fP, \fBrepoquery\-na\fP and \fBrepoquery\-nevra\fP
1356 that allow the specification of an exact argument in the NEVRA format (does not affect arguments of options like \-\-whatprovides <arg>, ...).
1357 As a consequence, <spec> will be not matched with file provides.
1358 .SS Select Options
1359 .sp
1360 Together with \fB<package\-file\-spec>\fP, control what packages are displayed in the output. If \fB<package\-file\-spec>\fP is given, limits the resulting set of
1361 packages to those matching the specification. All packages are considered if no \fB<package\-file\-spec>\fP is specified.
1362 .INDENT 0.0
1363 .TP
1364 .B \fB<package\-file\-spec>\fP
1365 Package specification in the NEVRA format (name[\-[epoch:]version[\-release]][.arch]) or a file provide. See Specifying Packages\&.
1366 .TP
1367 .B \fB\-a\fP, \fB\-\-all\fP
1368 Query all packages (for rpmquery compatibility, also a shorthand for repoquery \(aq*\(aq or repoquery
1369 without arguments).
1370 .TP
1371 .B \fB\-\-arch <arch>[,<arch>...], \-\-archlist <arch>[,<arch>...]\fP
1372 Limit the resulting set only to packages of selected architectures (default is all
1373 architectures). In some cases the result is affected by the basearch of the running system, therefore
1374 to run repoquery for an arch incompatible with your system use the \fB\-\-forcearch=<arch>\fP
1375 option to change the basearch.
1376 .TP
1377 .B \fB\-\-duplicates\fP
1378 Limit the resulting set to installed duplicate packages (i.e. more package versions
1379 for the same name and architecture). Installonly packages are excluded from this set.
1380 .TP
1381 .B \fB\-\-unneeded\fP
1382 Limit the resulting set to leaves packages that were installed as dependencies so they are no longer needed. This
1383 switch lists packages that are going to be removed after executing the \fBdnf autoremove\fP command.
1384 .TP
1385 .B \fB\-\-available\fP
1386 Limit the resulting set to available packages only (set by default).
1387 .TP
1388 .B \fB\-\-disable\-modular\-filtering\fP
1389 Disables filtering of modular packages, so that packages of inactive module streams are included in the result.
1390 .TP
1391 .B \fB\-\-extras\fP
1392 Limit the resulting set to packages that are not present in any of the available repositories.
1393 .TP
1394 .B \fB\-f <file>\fP, \fB\-\-file <file>\fP
1395 Limit the resulting set only to the package that owns \fB<file>\fP\&.
1396 .TP
1397 .B \fB\-\-installed\fP
1398 Limit the resulting set to installed packages only. The exclude \%<#\:exclude-label> option in the configuration file
1399 might influence the result, but if the command line option \-\-disableexcludes is used, it ensures that all installed packages will be listed.
1400 .TP
1401 .B \fB\-\-installonly\fP
1402 Limit the resulting set to installed installonly packages.
1403 .TP
1404 .B \fB\-\-latest\-limit <number>\fP
1405 Limit the resulting set to <number> of latest packages for every package name and architecture.
1406 If <number> is negative, skip <number> of latest packages. For a negative <number> use the
1407 \fB\-\-latest\-limit=<number>\fP syntax.
1408 .TP
1409 .B \fB\-\-recent\fP
1410 Limit the resulting set to packages that were recently edited.
1411 .TP
1412 .B \fB\-\-repo <repoid>\fP
1413 Limit the resulting set only to packages from a repository identified by \fB<repoid>\fP\&.
1414 Can be used multiple times with accumulative effect.
1415 .TP
1416 .B \fB\-\-unsatisfied\fP
1417 Report unsatisfied dependencies among installed packages (i.e. missing requires and
1418 existing conflicts).
1419 .TP
1420 .B \fB\-\-upgrades\fP
1421 Limit the resulting set to packages that provide an upgrade for some already installed package.
1422 .TP
1423 .B \fB\-\-userinstalled\fP
1424 Limit the resulting set to packages installed by the user. The exclude \%<#\:exclude-label> option
1425 in the configuration file might influence the result, but if the command line option \-\-disableexcludes is used, it ensures that all installed packages will be listed.
1426 .UNINDENT
1427 .INDENT 0.0
1428 .TP
1429 .B \fB\-\-whatdepends <capability>[,<capability>...]\fP
1430 Limit the resulting set only to packages that require, enhance, recommend, suggest or
1431 supplement any of \fB<capabilities>\fP\&.
1432 .TP
1433 .B \fB\-\-whatconflicts <capability>[,<capability>...]\fP
1434 Limit the resulting set only to packages that conflict with any of \fB<capabilities>\fP\&.
1435 .TP
1436 .B \fB\-\-whatenhances <capability>[,<capability>...]\fP
1437 Limit the resulting set only to packages that enhance any of \fB<capabilities>\fP\&. Use \-\-whatdepends if you want to list all depending packages.
1438 .TP
1439 .B \fB\-\-whatobsoletes <capability>[,<capability>...]\fP
1440 Limit the resulting set only to packages that obsolete any of \fB<capabilities>\fP\&.
1441 .TP
1442 .B \fB\-\-whatprovides <capability>[,<capability>...]\fP
1443 Limit the resulting set only to packages that provide any of \fB<capabilities>\fP\&.
1444 .TP
1445 .B \fB\-\-whatrecommends <capability>[,<capability>...]\fP
1446 Limit the resulting set only to packages that recommend any of \fB<capabilities>\fP\&. Use \-\-whatdepends if you want to list all depending packages.
1447 .TP
1448 .B \fB\-\-whatrequires <capability>[,<capability>...]\fP
1449 Limit the resulting set only to packages that require any of \fB<capabilities>\fP\&. Use \-\-whatdepends if you want to list all depending packages.
1450 .TP
1451 .B \fB\-\-whatsuggests <capability>[,<capability>...]\fP
1452 Limit the resulting set only to packages that suggest any of \fB<capabilities>\fP\&. Use \-\-whatdepends if you want to list all depending packages.
1453 .TP
1454 .B \fB\-\-whatsupplements <capability>[,<capability>...]\fP
1455 Limit the resulting set only to packages that supplement any of \fB<capabilities>\fP\&. Use \-\-whatdepends if you want to list all depending packages.
1456 .TP
1457 .B \fB\-\-alldeps\fP
1458 This option is stackable with \fB\-\-whatrequires\fP or \-\-whatdepends only. Additionally it adds all packages requiring
1459 the package features to the result set (used as default).
1460 .TP
1461 .B \fB\-\-exactdeps\fP
1462 This option is stackable with \fB\-\-whatrequires\fP or \-\-whatdepends only. Limit the resulting set only to packages
1463 that require \fB<capability>\fP specified by \-\-whatrequires.
1464 .TP
1465 .B \fB\-\-srpm\fP
1466 Operate on the corresponding source RPM.
1467 .UNINDENT
1468 .SS Query Options
1469 .sp
1470 Set what information is displayed about each package.
1471 .sp
1472 The following are mutually exclusive, i.e. at most one can be specified. If no query option is given, matching packages
1473 are displayed in the standard NEVRA notation.
1474 .INDENT 0.0
1475 .TP
1476 .B \fB\-i, \-\-info\fP
1477 Show detailed information about the package.
1478 .TP
1479 .B \fB\-l, \-\-list\fP
1480 Show the list of files in the package.
1481 .TP
1482 .B \fB\-s, \-\-source\fP
1483 Show the package source RPM name.
1484 .TP
1485 .B \fB\-\-changelogs\fP
1486 Print the package changelogs.
1487 .TP
1488 .B \fB\-\-conflicts\fP
1489 Display capabilities that the package conflicts with. Same as \fB\-\-qf \(dq%{conflicts}\fP\&.
1490 .TP
1491 .B \fB\-\-depends\fP
1492 Display capabilities that the package depends on, enhances, recommends, suggests or
1493 supplements.
1494 .TP
1495 .B \fB\-\-enhances\fP
1496 Display capabilities enhanced by the package. Same as \fB\-\-qf \(dq%{enhances}\(dq\(dq\fP\&.
1497 .TP
1498 .B \fB\-\-location\fP
1499 Show a location where the package could be downloaded from.
1500 .TP
1501 .B \fB\-\-obsoletes\fP
1502 Display capabilities that the package obsoletes. Same as \fB\-\-qf \(dq%{obsoletes}\(dq\fP\&.
1503 .TP
1504 .B \fB\-\-provides\fP
1505 Display capabilities provided by the package. Same as \fB\-\-qf \(dq%{provides}\(dq\fP\&.
1506 .TP
1507 .B \fB\-\-recommends\fP
1508 Display capabilities recommended by the package. Same as \fB\-\-qf \(dq%{recommends}\(dq\fP\&.
1509 .TP
1510 .B \fB\-\-requires\fP
1511 Display capabilities that the package depends on. Same as \fB\-\-qf \(dq%{requires}\(dq\fP\&.
1512 .TP
1513 .B \fB\-\-requires\-pre\fP
1514 Display capabilities that the package depends on for running a \fB%pre\fP script.
1515 Same as \fB\-\-qf \(dq%{requires\-pre}\(dq\fP\&.
1516 .TP
1517 .B \fB\-\-suggests\fP
1518 Display capabilities suggested by the package. Same as \fB\-\-qf \(dq%{suggests}\(dq\fP\&.
1519 .TP
1520 .B \fB\-\-supplements\fP
1521 Display capabilities supplemented by the package. Same as \fB\-\-qf \(dq%{supplements}\(dq\fP\&.
1522 .TP
1523 .B \fB\-\-tree\fP
1524 Display a recursive tree of packages with capabilities specified by one of the following supplementary options:
1525 \fB\-\-whatrequires\fP, \fB\-\-requires\fP, \fB\-\-conflicts\fP, \fB\-\-enhances\fP, \fB\-\-suggests\fP, \fB\-\-provides\fP,
1526 \fB\-\-supplements\fP, \fB\-\-recommends\fP\&.
1527 .UNINDENT
1528 .INDENT 0.0
1529 .TP
1530 .B \fB\-\-deplist\fP
1531 Produce a list of all direct dependencies and what packages provide those
1532 dependencies for the given packages. The result only shows the newest
1533 providers (which can be changed by using \-\-verbose).
1534 .TP
1535 .B \fB\-\-nvr\fP
1536 Show found packages in the name\-version\-release format. Same as
1537 \fB\-\-qf \(dq%{name}\-%{version}\-%{release}\(dq\fP\&.
1538 .TP
1539 .B \fB\-\-nevra\fP
1540 Show found packages in the name\-epoch:version\-release.architecture format. Same as
1541 \fB\-\-qf \(dq%{name}\-%{epoch}:%{version}\-%{release}.%{arch}\(dq\fP (default).
1542 .TP
1543 .B \fB\-\-envra\fP
1544 Show found packages in the epoch:name\-version\-release.architecture format. Same as
1545 \fB\-\-qf \(dq%{epoch}:%{name}\-%{version}\-%{release}.%{arch}\(dq\fP
1546 .UNINDENT
1547 .INDENT 0.0
1548 .TP
1549 .B \fB\-\-qf <format>\fP, \fB\-\-queryformat <format>\fP
1550 Custom display format. \fB<format>\fP is the string to output for each matched package. Every occurrence of
1551 \fB%{<tag>}\fP within is replaced by the corresponding attribute of the package. The list of recognized tags can be displayed
1552 by running \fBdnf repoquery \-\-querytags\fP\&.
1553 .TP
1554 .B \fB\-\-recursive\fP
1555 Query packages recursively. Has to be used with \fB\-\-whatrequires <REQ>\fP
1556 (optionally with \fB\-\-alldeps\fP, but not with \fB\-\-exactdeps\fP) or with
1557 \fB\-\-requires <REQ> \-\-resolve\fP\&.
1558 .TP
1559 .B \fB\-\-resolve\fP
1560 resolve capabilities to originating package(s).
1561 .UNINDENT
1562 .SS Repoquery Examples
1563 .INDENT 0.0
1564 .TP
1565 .B \fBdnf repoquery \(aqlight*\(aq\fP
1566 Display NEVRAs of all available packages matching \fBlight*\fP
1567 .TP
1568 .B \fBdnf repoquery\-na \(aqlight*.noarch\(aq\fP
1569 Display NEVRAs of all available packages matching name \fBlight*\fP and architecture \fBnoarch\fP (accepts only arguments in the \(dq<name>.<arch>\(dq format)
1570 .TP
1571 .B \fBdnf repoquery \-\-requires lighttpd\fP
1572 Display requires of all lighttpd packages
1573 .TP
1574 .B \fBdnf repoquery \-\-requires python \-\-resolve\fP
1575 Display packages providing the requires of python packages
1576 .TP
1577 .B \fBdnf repoquery \-\-source lighttpd\fP
1578 Display source rpm of lighttpd package
1579 .TP
1580 .B \fBdnf repoquery \-\-file /etc/lighttpd/lighttpd.conf\fP
1581 Display package name that owns the given file
1582 .TP
1583 .B \fBdnf repoquery \-\-queryformat \(aq%{name}.%{arch} : %{reponame}\(aq lighttpd\fP
1584 Display name, architecture and the containing repository of all lighttpd packages
1585 .TP
1586 .B \fBdnf repoquery \-\-whatprovides webserver\fP
1587 Display all available packages providing \(dqwebserver\(dq
1588 .TP
1589 .B \fBdnf repoquery \-\-whatprovides webserver \-\-arch i686\fP
1590 Display all available packages providing \(dqwebserver\(dq but only for \(dqi686\(dq architecture
1591 .TP
1592 .B \fBdnf repoquery \-\-duplicates\fP
1593 Display duplicate packages
1594 .TP
1595 .B \fBdnf repoquery \-\-disablerepo=\(dq*\(dq \-\-enablerepo=\(dq*\-source\(dq \-\-arch=src \-\-whatrequires <provide>\fP
1596 Display source packages that require a <provide> for a build
1597 .UNINDENT
1598 .SS Repository\-Packages Command
1599 .nf
1600 Command: \fBrepository\-packages\fP
1601 Deprecated aliases: \fBrepo\-pkgs\fP, \fBrepo\-packages\fP, \fBrepository\-pkgs\fP
1602 .fi
1603 .sp
1604 .sp
1605 The repository\-packages command allows the user to run commands on top of all packages in the repository named \fB<repoid>\fP\&. However, any dependency resolution takes into account packages from all enabled repositories. The \fB<package\-file\-spec>\fP and \fB<package\-spec>\fP specifications further limit the candidates to only those packages matching at least one of them.
1606 .sp
1607 The \fBinfo\fP subcommand lists description and summary information about packages depending on the packages\(aq relation to the repository. The \fBlist\fP subcommand just prints lists of those packages.
1608 .INDENT 0.0
1609 .TP
1610 .B \fBdnf [options] repository\-packages <repoid> check\-update [<package\-file\-spec>...]\fP
1611 Non\-interactively checks if updates of the specified packages in the repository are available. DNF exit code will be 100 when there are updates available and a list of the updates will be printed.
1612 .TP
1613 .B \fBdnf [options] repository\-packages <repoid> info [\-\-all] [<package\-file\-spec>...]\fP
1614 List all related packages.
1615 .TP
1616 .B \fBdnf [options] repository\-packages <repoid> info \-\-installed [<package\-file\-spec>...]\fP
1617 List packages installed from the repository.
1618 .TP
1619 .B \fBdnf [options] repository\-packages <repoid> info \-\-available [<package\-file\-spec>...]\fP
1620 List packages available in the repository but not currently installed on the system.
1621 .TP
1622 .B \fBdnf [options] repository\-packages <repoid> info \-\-extras [<package\-file\-specs>...]\fP
1623 List packages installed from the repository that are not available in any repository.
1624 .TP
1625 .B \fBdnf [options] repository\-packages <repoid> info \-\-obsoletes [<package\-file\-spec>...]\fP
1626 List packages in the repository that obsolete packages installed on the system.
1627 .TP
1628 .B \fBdnf [options] repository\-packages <repoid> info \-\-recent [<package\-file\-spec>...]\fP
1629 List packages recently added into the repository.
1630 .TP
1631 .B \fBdnf [options] repository\-packages <repoid> info \-\-upgrades [<package\-file\-spec>...]\fP
1632 List packages in the repository that upgrade packages installed on the system.
1633 .TP
1634 .B \fBdnf [options] repository\-packages <repoid> install [<package\-spec>...]\fP
1635 Install packages matching \fB<package\-spec>\fP from the repository. If \fB<package\-spec>\fP isn\(aqt specified at all, install all packages from the repository.
1636 .TP
1637 .B \fBdnf [options] repository\-packages <repoid> list [\-\-all] [<package\-file\-spec>...]\fP
1638 List all related packages.
1639 .TP
1640 .B \fBdnf [options] repository\-packages <repoid> list \-\-installed [<package\-file\-spec>...]\fP
1641 List packages installed from the repository.
1642 .TP
1643 .B \fBdnf [options] repository\-packages <repoid> list \-\-available [<package\-file\-spec>...]\fP
1644 List packages available in the repository but not currently installed on the system.
1645 .TP
1646 .B \fBdnf [options] repository\-packages <repoid> list \-\-extras [<package\-file\-spec>...]\fP
1647 List packages installed from the repository that are not available in any repository.
1648 .TP
1649 .B \fBdnf [options] repository\-packages <repoid> list \-\-obsoletes [<package\-file\-spec>...]\fP
1650 List packages in the repository that obsolete packages installed on the system.
1651 .TP
1652 .B \fBdnf [options] repository\-packages <repoid> list \-\-recent [<package\-file\-spec>...]\fP
1653 List packages recently added into the repository.
1654 .TP
1655 .B \fBdnf [options] repository\-packages <repoid> list \-\-upgrades [<package\-file\-spec>...]\fP
1656 List packages in the repository that upgrade packages installed on the system.
1657 .TP
1658 .B \fBdnf [options] repository\-packages <repoid> move\-to [<package\-spec>...]\fP
1659 Reinstall all those packages that are available in the repository.
1660 .TP
1661 .B \fBdnf [options] repository\-packages <repoid> reinstall [<package\-spec>...]\fP
1662 Run the \fBreinstall\-old\fP subcommand. If it fails, run the \fBmove\-to\fP subcommand.
1663 .TP
1664 .B \fBdnf [options] repository\-packages <repoid> reinstall\-old [<package\-spec>...]\fP
1665 Reinstall all those packages that were installed from the repository and simultaneously are available in the repository.
1666 .TP
1667 .B \fBdnf [options] repository\-packages <repoid> remove [<package\-spec>...]\fP
1668 Remove all packages installed from the repository along with any packages depending on the packages being removed. If \fBclean_requirements_on_remove\fP is enabled (the default) also removes any dependencies that are no longer needed.
1669 .TP
1670 .B \fBdnf [options] repository\-packages <repoid> remove\-or\-distro\-sync [<package\-spec>...]\fP
1671 Select all packages installed from the repository. Upgrade, downgrade or keep those of them that are available in another repository to match the latest version available there and remove the others along with any packages depending on the packages being removed. If \fBclean_requirements_on_remove\fP is enabled (the default) also removes any dependencies that are no longer needed.
1672 .TP
1673 .B \fBdnf [options] repository\-packages <repoid> remove\-or\-reinstall [<package\-spec>...]\fP
1674 Select all packages installed from the repository. Reinstall those of them that are available in another repository and remove the others along with any packages depending on the packages being removed. If \fBclean_requirements_on_remove\fP is enabled (the default) also removes any dependencies that are no longer needed.
1675 .TP
1676 .B \fBdnf [options] repository\-packages <repoid> upgrade [<package\-spec>...]\fP
1677 Update all packages to the highest resolvable version available in the repository.
1678 When versions are specified in the \fB<package\-spec>\fP, update to these versions.
1679 .TP
1680 .B \fBdnf [options] repository\-packages <repoid> upgrade\-to [<package\-specs>...]\fP
1681 A deprecated alias for the upgrade subcommand.
1682 .UNINDENT
1683 .SS Search Command
1684 .nf
1685 Command: \fBsearch\fP
1686 Aliases: \fBse\fP
1687 .fi
1688 .sp
1689 .INDENT 0.0
1690 .TP
1691 .B \fBdnf [options] search [\-\-all] <keywords>...\fP
1692 Search package metadata for keywords. Keywords are matched as case\-insensitive substrings, globbing is supported.
1693 By default lists packages that match all requested keys (AND operation). Keys are searched in package names and summaries.
1694 If the \fB\-\-all\fP option is used, lists packages that match at least one of the keys (an OR operation).
1695 In addition the keys are searched in the package descriptions and URLs.
1696 The result is sorted from the most relevant results to the least.
1697 .UNINDENT
1698 .sp
1699 This command by default does not force a sync of expired metadata. See also Metadata Synchronization\&.
1700 .SS Shell Command
1701 .nf
1702 Command: \fBshell\fP
1703 Aliases: \fBsh\fP
1704 .fi
1705 .sp
1706 .INDENT 0.0
1707 .TP
1708 .B \fBdnf [options] shell [filename]\fP
1709 Open an interactive shell for conducting multiple commands during a single execution of DNF. These commands can be issued manually
1710 or passed to DNF from a file. The commands are much the same as the normal DNF command line options. There are a few additional
1711 commands documented below.
1712 .INDENT 7.0
1713 .TP
1714 .B \fBconfig [conf\-option] [value]\fP
1715 .INDENT 7.0
1716 .IP \(bu 2
1717 Set a configuration option to a requested value. If no value is given it prints the current value.
1718 .UNINDENT
1719 .TP
1720 .B \fBrepo [list|enable|disable] [repo\-id]\fP
1721 .INDENT 7.0
1722 .IP \(bu 2
1723 list: list repositories and their status
1724 .IP \(bu 2
1725 enable: enable repository
1726 .IP \(bu 2
1727 disable: disable repository
1728 .UNINDENT
1729 .TP
1730 .B \fBtransaction [list|reset|solve|run]\fP
1731 .INDENT 7.0
1732 .IP \(bu 2
1733 list: resolve and list the content of the transaction
1734 .IP \(bu 2
1735 reset: reset the transaction
1736 .IP \(bu 2
1737 run: resolve and run the transaction
1738 .UNINDENT
1739 .UNINDENT
1740 .sp
1741 Note that all local packages must be used in the first shell transaction subcommand (e.g.
1742 \fIinstall /tmp/nodejs\-1\-1.x86_64.rpm /tmp/acpi\-1\-1.noarch.rpm\fP) otherwise an error will occur.
1743 Any \fIdisable\fP, \fIenable\fP, and \fIreset\fP module operations (e.g. \fImodule enable nodejs\fP) must also
1744 be performed before any other shell transaction subcommand is used.
1745 .UNINDENT
1746 .SS Swap Command
1747 .nf
1748 Command: \fBswap\fP
1749 .fi
1750 .sp
1751 .sp
1752 \fBdnf [options] swap <remove\-spec> <install\-spec>\fP
1753 .INDENT 0.0
1754 .INDENT 3.5
1755 Remove \fBremove\-spec\fP and install \fBinstall\-spec\fP in one transaction. Each \fB<spec>\fP can be either a
1756 <package\-spec>, which specifies a package directly, or a
1757 \fB@<group\-spec>\fP, which specifies an (environment) group which contains it. Automatic
1758 conflict solving is provided in DNF by the \-\-allowerasing option that provides the functionality of the swap
1759 command automatically.
1760 .UNINDENT
1761 .UNINDENT
1762 .SS Updateinfo Command
1763 .nf
1764 Command: \fBupdateinfo\fP
1765 Aliases: \fBupif\fP
1766 Deprecated aliases: \fBlist\-updateinfo\fP, \fBlist\-security\fP, \fBlist\-sec\fP, \fBinfo\-updateinfo\fP, \fBinfo\-security\fP, \fBinfo\-sec\fP, \fBsummary\-updateinfo\fP
1767 .fi
1768 .sp
1769 .INDENT 0.0
1770 .TP
1771 .B \fBdnf [options] updateinfo [\-\-summary|\-\-list|\-\-info] [<availability>] [<spec>...]\fP
1772 Display information about update advisories.
1773 .sp
1774 Depending on the output type, DNF displays just counts of advisory types
1775 (omitted or \fB\-\-summary\fP), list of advisories (\fB\-\-list\fP) or detailed
1776 information (\fB\-\-info\fP). The \fB\-v\fP option extends the output. When
1777 used with \fB\-\-info\fP, the information is even more detailed. When used
1778 with \fB\-\-list\fP, an additional column with date of the last advisory update
1779 is added.
1780 .sp
1781 \fB<availability>\fP specifies whether advisories about newer versions of
1782 installed packages (omitted or \fB\-\-available\fP), advisories about equal and
1783 older versions of installed packages (\fB\-\-installed\fP), advisories about
1784 newer versions of those installed packages for which a newer version is
1785 available (\fB\-\-updates\fP) or advisories about any versions of installed
1786 packages (\fB\-\-all\fP) are taken into account. Most of the time, \fB\-\-available\fP
1787 and \fB\-\-updates\fP displays the same output. The outputs differ only in the
1788 cases when an advisory refers to a newer version but there is no enabled
1789 repository which contains any newer version.
1790 .sp
1791 Note, that \fB\-\-available\fP takes only the latest installed versions of
1792 packages into account. In case of the kernel packages (when multiple
1793 version could be installed simultaneously) also packages of the currently
1794 running version of kernel are added.
1795 .sp
1796 To print only advisories referencing a CVE or a bugzilla use \fB\-\-with\-cve\fP or
1797 \fB\-\-with\-bz\fP options. When these switches are used also the output
1798 of the \fB\-\-list\fP is altered \- the ID of the CVE or the bugzilla is printed
1799 instead of the one of the advisory.
1800 .sp
1801 If given and if neither ID, type (\fBbugfix\fP, \fBenhancement\fP,
1802 \fBsecurity\fP/\fBsec\fP) nor a package name of an advisory matches
1803 \fB<spec>\fP, the advisory is not taken into account. The matching is
1804 case\-sensitive and in the case of advisory IDs and package names, globbing
1805 is supported.
1806 .sp
1807 Output of the \fB\-\-summary\fP option is affected by the autocheck_running_kernel \%<#\:autocheck-running-kernel-label> configuration option.
1808 .UNINDENT
1809 .SS Upgrade Command
1810 .nf
1811 Command: \fBupgrade\fP
1812 Aliases: \fBup\fP
1813 Deprecated aliases: \fBupdate\fP, \fBupgrade\-to\fP, \fBupdate\-to\fP, \fBlocalupdate\fP
1814 .fi
1815 .sp
1816 .INDENT 0.0
1817 .TP
1818 .B \fBdnf [options] upgrade\fP
1819 Updates each package to the latest version that is both available and
1820 resolvable.
1821 .TP
1822 .B \fBdnf [options] upgrade <package\-spec>...\fP
1823 Updates each specified package to the latest available version. Updates
1824 dependencies as necessary. When versions are specified in the
1825 \fB<package\-spec>\fP, update to these versions.
1826 .TP
1827 .B \fBdnf [options] upgrade @<spec>...\fP
1828 Alias for the \fIdnf module update\fP command.
1829 .UNINDENT
1830 .sp
1831 If the main \fBobsoletes\fP configure option is true or the \fB\-\-obsoletes\fP flag
1832 is present, dnf will include package obsoletes in its calculations.
1833 For more information see obsoletes \%<#\:obsoletes-conf-option-label>\&.
1834 .sp
1835 See also Configuration Files Replacement Policy\&.
1836 .SS Upgrade\-Minimal Command
1837 .nf
1838 Command: \fBupgrade\-minimal\fP
1839 Aliases: \fBup\-min\fP
1840 Deprecated aliases: \fBupdate\-minimal\fP
1841 .fi
1842 .sp
1843 .INDENT 0.0
1844 .TP
1845 .B \fBdnf [options] upgrade\-minimal\fP
1846 Updates each package to the nearest available version that provides
1847 a bugfix, enhancement or a fix for a security issue (security).
1848 .TP
1849 .B \fBdnf [options] upgrade\-minimal <package\-spec>...\fP
1850 Updates each specified package to the nearest available version that provides
1851 a bugfix, enhancement or a fix for security issue (security). Updates
1852 dependencies as necessary.
1853 .UNINDENT
1854 .SH SPECIFYING PACKAGES
1855 .sp
1856 Many commands take a \fB<package\-spec>\fP parameter that selects a package for
1857 the operation. The \fB<package\-spec>\fP argument is matched against package
1858 NEVRAs, provides and file provides.
1859 .sp
1860 \fB<package\-file\-spec>\fP is similar to \fB<package\-spec>\fP, except provides
1861 matching is not performed. Therefore, \fB<package\-file\-spec>\fP is matched only
1862 against NEVRAs and file provides.
1863 .sp
1864 \fB<package\-name\-spec>\fP is matched against NEVRAs only.
1865 .SS Globs
1866 .sp
1867 Package specification supports the same glob pattern matching that shell does,
1868 in all three above mentioned packages it matches against (NEVRAs, provides and
1869 file provides).
1870 .sp
1871 The following patterns are supported:
1872 .INDENT 0.0
1873 .TP
1874 .B \fB*\fP
1875 Matches any number of characters.
1876 .TP
1877 .B \fB?\fP
1878 Matches any single character.
1879 .TP
1880 .B \fB[]\fP
1881 Matches any one of the enclosed characters. A pair of characters separated
1882 by a hyphen denotes a range expression; any character that falls between
1883 those two characters, inclusive, is matched. If the first character
1884 following the \fB[\fP is a \fB!\fP or a \fB^\fP then any character not enclosed
1885 is matched.
1886 .UNINDENT
1887 .sp
1888 Note: Curly brackets (\fB{}\fP) are not supported. You can still use them in
1889 shells that support them and let the shell do the expansion, but if quoted or
1890 escaped, dnf will not expand them.
1891 .SS NEVRA Matching
1892 .sp
1893 When matching against NEVRAs, partial matching is supported. DNF tries to match
1894 the spec against the following list of NEVRA forms (in decreasing order of
1895 priority):
1896 .INDENT 0.0
1897 .IP \(bu 2
1898 \fBname\-[epoch:]version\-release.arch\fP
1899 .IP \(bu 2
1900 \fBname.arch\fP
1901 .IP \(bu 2
1902 \fBname\fP
1903 .IP \(bu 2
1904 \fBname\-[epoch:]version\-release\fP
1905 .IP \(bu 2
1906 \fBname\-[epoch:]version\fP
1907 .UNINDENT
1908 .sp
1909 Note that \fBname\fP can in general contain dashes (e.g. \fBpackage\-with\-dashes\fP).
1910 .sp
1911 The first form that matches any packages is used and the remaining forms are
1912 not tried. If none of the forms match any packages, an attempt is made to match
1913 the \fB<package\-spec>\fP against full package NEVRAs. This is only relevant
1914 if globs are present in the \fB<package\-spec>\fP\&.
1915 .sp
1916 \fB<package\-spec>\fP matches NEVRAs the same way \fB<package\-name\-spec>\fP does,
1917 but in case matching NEVRAs fails, it attempts to match against provides and
1918 file provides of packages as well.
1919 .sp
1920 You can specify globs as part of any of the five NEVRA components. You can also
1921 specify a glob pattern to match over multiple NEVRA components (in other words,
1922 to match across the NEVRA separators). In that case, however, you need to write
1923 the spec to match against full package NEVRAs, as it is not possible to split
1924 such spec into NEVRA forms.
1925 .SS Specifying NEVRA Matching Explicitly
1926 .sp
1927 Some commands (\fBautoremove\fP, \fBinstall\fP, \fBremove\fP and \fBrepoquery\fP) also
1928 have aliases with suffixes \fB\-n\fP, \fB\-na\fP and \fB\-nevra\fP that allow to
1929 explicitly specify how to parse the arguments:
1930 .INDENT 0.0
1931 .IP \(bu 2
1932 Command \fBinstall\-n\fP only matches against \fBname\fP\&.
1933 .IP \(bu 2
1934 Command \fBinstall\-na\fP only matches against \fBname.arch\fP\&.
1935 .IP \(bu 2
1936 Command \fBinstall\-nevra\fP only matches against \fBname\-[epoch:]version\-release.arch\fP\&.
1937 .UNINDENT
1938 .SH SPECIFYING PROVIDES
1939 .sp
1940 \fB<provide\-spec>\fP in command descriptions means the command operates on
1941 packages providing the given spec. This can either be an explicit provide, an
1942 implicit provide (i.e. name of the package) or a file provide. The selection is
1943 case\-sensitive and globbing is supported.
1944 .SS Specifying File Provides
1945 .sp
1946 If a spec starts with either \fB/\fP or \fB*/\fP, it is considered as a potential file provide.
1947 .SH SPECIFYING GROUPS
1948 .sp
1949 \fB<group\-spec>\fP allows one to select (environment) groups a particular operation should work
1950 on. It is a case insensitive string (supporting globbing characters) that is
1951 matched against a group\(aqs ID, canonical name and name translated into the
1952 current LC_MESSAGES locale (if possible).
1953 .SH SPECIFYING MODULES
1954 .sp
1955 \fB<module\-spec>\fP allows one to select modules or profiles a particular operation should work
1956 on.
1957 .sp
1958 It is in the form of \fBNAME:STREAM:VERSION:CONTEXT:ARCH/PROFILE\fP and supported partial forms are the following:
1959 .INDENT 0.0
1960 .IP \(bu 2
1961 \fBNAME\fP
1962 .IP \(bu 2
1963 \fBNAME:STREAM\fP
1964 .IP \(bu 2
1965 \fBNAME:STREAM:VERSION\fP
1966 .IP \(bu 2
1967 \fBNAME:STREAM:VERSION:CONTEXT\fP
1968 .IP \(bu 2
1969 all above combinations with \fB::ARCH\fP (e.g. \fBNAME::ARCH\fP)
1970 .IP \(bu 2
1971 \fBNAME:STREAM:VERSION:CONTEXT:ARCH\fP
1972 .IP \(bu 2
1973 all above combinations with \fB/PROFILE\fP (e.g. \fBNAME/PROFILE\fP)
1974 .UNINDENT
1975 .sp
1976 In case stream is not specified, the enabled or the default stream is used, in this order. In case profile is not specified, the system default profile or the \(aqdefault\(aq profile is used.
1977 .SH SPECIFYING TRANSACTIONS
1978 .sp
1979 \fB<transaction\-spec>\fP can be in one of several forms. If it is an integer, it
1980 specifies a transaction ID. Specifying \fBlast\fP is the same as specifying the ID
1981 of the most recent transaction. The last form is \fBlast\-<offset>\fP, where
1982 \fB<offset>\fP is a positive integer. It specifies offset\-th transaction preceding
1983 the most recent transaction.
1984 .SH PACKAGE FILTERING
1985 .sp
1986 Package filtering filters packages out from the available package set, making them invisible to most
1987 of dnf commands. They cannot be used in a transaction. Packages can be filtered out by either
1988 Exclude Filtering or Modular Filtering.
1989 .SS Exclude Filtering
1990 .sp
1991 Exclude Filtering is a mechanism used by a user or by a DNF plugin to modify the set of available
1992 packages. Exclude Filtering can be modified by either includepkgs \%<#\:include-label> or
1993 excludepkgs \%<#\:exclude-label> configuration options in
1994 configuration files \%<#\:conf-ref-label>\&. The \-\-disableexcludes
1995 command line option can be used to override excludes from configuration files. In addition to
1996 user\-configured excludes, plugins can also extend the set of excluded packages. To disable excludes
1997 from a DNF plugin you can use the \-\-disableplugin command line option.
1998 .sp
1999 To disable all excludes for e.g. the install command you can use the following combination
2000 of command line options:
2001 .sp
2002 \fBdnf \-\-disableexcludes=all \-\-disableplugin=\(dq*\(dq install bash\fP
2003 .SS Modular Filtering
2004 .sp
2005 Please see the modularity documentation \%<#\:modularity-label> for details on how Modular
2006 Filtering works.
2007 .sp
2008 With modularity, only RPM packages from \fBactive\fP module streams are included in the available
2009 package set. RPM packages from \fBinactive\fP module streams, as well as non\-modular packages with
2010 the same name or provides as a package from an \fBactive\fP module stream, are filtered out. Modular
2011 filtering is not applied to packages added from the command line, installed packages, or packages
2012 from repositories with \fBmodule_hotfixes=true\fP in their \fB\&.repo\fP file.
2013 .sp
2014 Disabling of modular filtering is not recommended, because it could cause the system to get into
2015 a broken state. To disable modular filtering for a particular repository, specify
2016 \fBmodule_hotfixes=true\fP in the \fB\&.repo\fP file or use \fB\-\-setopt=<repo_id>.module_hotfixes=true\fP\&.
2017 .sp
2018 To discover the module which contains an excluded package use
2019 dnf module provides\&.
2020 .SH METADATA SYNCHRONIZATION
2021 .sp
2022 Correct operation of DNF depends on having access to up\-to\-date data from all enabled repositories but contacting remote mirrors on every operation considerably slows it down and costs bandwidth for both the client and the repository provider. The metadata_expire \%<#\:metadata-expire-label> (see \fBdnf.conf(5)\fP) repository configuration option is used by DNF to determine whether a particular local copy of repository data is due to be re\-synced. It is crucial that the repository providers set the option well, namely to a value where it is guaranteed that if particular metadata was available in time \fBT\fP on the server, then all packages it references will still be available for download from the server in time \fBT + metadata_expire\fP\&.
2023 .sp
2024 To further reduce the bandwidth load, some of the commands where having up\-to\-date metadata is not critical (e.g. the \fBlist\fP command) do not look at whether a repository is expired and whenever any version of it is locally available to the user\(aqs account, it will be used. For non\-root use, see also the \fB\-\-cacheonly\fP switch. Note that in all situations the user can force synchronization of all enabled repositories with the \fB\-\-refresh\fP switch.
2025 .SH CONFIGURATION FILES REPLACEMENT POLICY
2026 .sp
2027 The updated packages could replace the old modified configuration files
2028 with the new ones or keep the older files. Neither of the files are actually replaced.
2029 To the conflicting ones RPM gives additional suffix to the origin name. Which file
2030 should maintain the true name after transaction is not controlled by package manager
2031 but is specified by each package itself, following packaging guideline.
2032 .SH FILES
2033 .INDENT 0.0
2034 .TP
2035 .B \fBCache Files\fP
2036 /var/cache/dnf
2037 .TP
2038 .B \fBMain Configuration\fP
2039 /etc/dnf/dnf.conf
2040 .TP
2041 .B \fBRepository\fP
2042 /etc/yum.repos.d/
2043 .UNINDENT
2044 .SH SEE ALSO
2045 .INDENT 0.0
2046 .IP \(bu 2
2047 \fBdnf.conf(5)\fP, DNF Configuration Reference \%<#\:conf-ref-label>
2048 .IP \(bu 2
2049 \fBdnf\-PLUGIN(8)\fP for documentation on DNF plugins.
2050 .IP \(bu 2
2051 \fBdnf.modularity(7)\fP, Modularity overview \%<#\:modularity-label>\&.
2052 .IP \(bu 2
2053 \fBdnf\-transaction\-json(5)\fP, Stored Transaction JSON Format Specification \%<#\:transaction-json-label>\&.
2054 .IP \(bu 2
2055 DNF \%<https://\:github\:.com/\:rpm-software-management/\:dnf/> project homepage (\%<https://\:github\:.com/\:rpm-software-management/\:dnf/>)
2056 .IP \(bu 2
2057 How to report a bug (\%<https://\:github\:.com/\:rpm-software-management/\:dnf/\:wiki/\:Bug-Reporting>)
2058 .IP \(bu 2
2059 YUM \%<http://\:yum\:.baseurl\:.org/> project homepage (\%<http://\:yum\:.baseurl\:.org/>)
2060 .UNINDENT
2061 .SH Author
2062 See AUTHORS in DNF source distribution.
2063 .SH Copyright
2064 2012-2020, Red Hat, Licensed under GPLv2+
2065 .\" End of generated man page.