Debian Codegraph @

upstream/debian-trixie/man8/dnf4.8

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