Debian Codegraph @

upstream/debian-unstable/man5/dnf4.conf.5

raw
1 '\" t
2 .\" Man page generated from reStructuredText
3 .\" by the Docutils 0.22.2 manpage writer.
4 .
5 .
6 .nr rst2man-indent-level 0
7 .
8 .de1 rstReportMargin
9 \\$1 \\n[an-margin]
10 level \\n[rst2man-indent-level]
11 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
12 -
13 \\n[rst2man-indent0]
14 \\n[rst2man-indent1]
15 \\n[rst2man-indent2]
16 ..
17 .de1 INDENT
18 .\" .rstReportMargin pre:
19 . RS \\$1
20 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
21 . nr rst2man-indent-level +1
22 .\" .rstReportMargin post:
23 ..
24 .de UNINDENT
25 . RE
26 .\" indent \\n[an-margin]
27 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
28 .nr rst2man-indent-level -1
29 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
30 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
31 ..
32 .TH "DNF4.CONF" "5" "Oct 24, 2025" "4.24.0" "DNF"
33 .SH NAME
34 dnf4.conf \- DNF Configuration Reference
35 .SH DESCRIPTION
36 .sp
37 DNF \%<https://\:github\:.com/\:rpm-software-management/\:dnf/> by default uses the global configuration file at \fB/etc/dnf/dnf.conf\fP and
38 all *.repo files found under \fB/etc/yum.repos.d\fP\&. The latter is typically used
39 for repository configuration and takes precedence over global configuration.
40 .sp
41 The configuration file has INI format consisting of section declaration and
42 \fBname=value\fP options below each on separate line. There are two types of sections
43 in the configuration files: main and repository. Main section defines all global
44 configuration options and should be only one.
45 .sp
46 The repository sections define the configuration for each (remote or local)
47 repository. The section name of the repository in brackets serve as repo ID reference
48 and should be unique across configuration files. The allowed characters of repo ID
49 string are lower and upper case alphabetic letters, digits, \fB\-\fP, \fB_\fP, \fB\&.\fP
50 and \fB:\fP\&. The minimal repository configuration file should aside from repo ID
51 consists of baseurl, metalink
52 or mirrorlist option definition.
53 .SH DISTRIBUTION-SPECIFIC CONFIGURATION
54 .sp
55 Configuration options, namely best and
56 skip_if_unavailable, can be set in the DNF
57 configuration file by your distribution to override the DNF defaults.
58 .SH [MAIN] OPTIONS
59 .INDENT 0.0
60 .TP
61 .B \fBallow_vendor_change\fP
62 boolean
63 .sp
64 If disabled dnf will stick to vendor when upgrading or downgrading rpms.
65 Default is \fBTrue\fP
66 .sp
67 \fBWarning:\fP
68 .INDENT 7.0
69 .INDENT 3.5
70 This option is currently not supported for \fIdowngrade\fP and \fIdistro\-sync\fP commands
71 .UNINDENT
72 .UNINDENT
73 .UNINDENT
74 .INDENT 0.0
75 .TP
76 .B \fBarch\fP
77 string
78 .sp
79 The architecture used for installing packages. By default this is auto\-detected. Often used
80 together with ignorearch option.
81 .UNINDENT
82 .INDENT 0.0
83 .TP
84 .B \fBassumeno\fP
85 boolean
86 .sp
87 If enabled dnf will assume \fBNo\fP where it would normally prompt for
88 confirmation from user input. Default is \fBFalse\fP\&.
89 .UNINDENT
90 .INDENT 0.0
91 .TP
92 .B \fBassumeyes\fP
93 boolean
94 .sp
95 If enabled dnf will assume \fBYes\fP where it would normally prompt for
96 confirmation from user input (see also defaultyes). Default is \fBFalse\fP\&.
97 .UNINDENT
98 .INDENT 0.0
99 .TP
100 .B \fBautocheck_running_kernel\fP
101 boolean
102 .sp
103 Automatic check whether there is installed newer kernel module with security update than currently running kernel. Default is \fBTrue\fP\&.
104 .UNINDENT
105 .INDENT 0.0
106 .TP
107 .B \fBbasearch\fP
108 string
109 .sp
110 The base architecture used for installing packages. By default this is auto\-detected.
111 .UNINDENT
112 .INDENT 0.0
113 .TP
114 .B \fBbest\fP
115 boolean
116 .sp
117 \fBTrue\fP instructs the solver to either use a package with the highest available
118 version or fail. On \fBFalse\fP, do not fail if the latest version cannot be
119 installed and go with the lower version. The default is \fBFalse\fP\&. Note
120 this option in particular can be set in your configuration file by
121 your distribution\&. Also note that the
122 use of the highest available version is only guaranteed for the packages
123 directly requested and not for their dependencies.
124 .UNINDENT
125 .INDENT 0.0
126 .TP
127 .B \fBcachedir\fP
128 string
129 .sp
130 Path to a directory used by various DNF subsystems for storing cache data.
131 Has a reasonable root\-writable default depending on the distribution. DNF
132 needs to be able to create files and directories at this location.
133 .UNINDENT
134 .INDENT 0.0
135 .TP
136 .B \fBcacheonly\fP
137 boolean
138 .sp
139 If set to \fBTrue\fP DNF will run entirely from system cache, will not update
140 the cache and will use it even in case it is expired. Default is \fBFalse\fP\&.
141 .sp
142 API Notes: Must be set before repository objects are created. Plugins must set
143 this in the pre_config hook. Later changes are ignored.
144 .UNINDENT
145 .INDENT 0.0
146 .TP
147 .B \fBcheck_config_file_age\fP
148 boolean
149 .sp
150 Specifies whether dnf should automatically expire metadata of repos, which are older than
151 their corresponding configuration file (usually the dnf.conf file and the foo.repo file).
152 Default is \fBTrue\fP (perform the check). Expire of metadata is also affected by metadata age.
153 See also metadata_expire\&.
154 .UNINDENT
155 .INDENT 0.0
156 .TP
157 .B \fBclean_requirements_on_remove\fP
158 boolean
159 .sp
160 Remove dependencies that are no longer used during \fBdnf remove\fP\&. A package
161 only qualifies for removal via \fBclean_requirements_on_remove\fP if it was
162 installed through DNF but not on explicit user request, i.e. it was
163 pulled in as a dependency. The default is True.
164 (installonlypkgs are never automatically removed.)
165 .UNINDENT
166 .INDENT 0.0
167 .TP
168 .B \fBconfig_file_path\fP
169 string
170 .sp
171 Path to the default main configuration file. Default is \fB/etc/dnf/dnf.conf\fP\&.
172 .UNINDENT
173 .INDENT 0.0
174 .TP
175 .B \fBdebuglevel\fP
176 integer
177 .sp
178 Debug messages output level, in the range 0 to 10. The higher the number the
179 more debug output is put to stdout. Default is 2.
180 .UNINDENT
181 .INDENT 0.0
182 .TP
183 .B \fBdebug_solver\fP
184 boolean
185 .sp
186 Controls whether the libsolv debug files should be created when solving the
187 transaction. The debug files are created in the \fI\&./debugdata\fP directory.
188 Default is \fBFalse\fP\&.
189 .UNINDENT
190 .INDENT 0.0
191 .TP
192 .B \fBdefaultyes\fP
193 boolean
194 .sp
195 If enabled the default answer to user confirmation prompts will be \fBYes\fP\&. Not
196 to be confused with assumeyes which will not prompt at all. Default is \fBFalse\fP\&.
197 .UNINDENT
198 .INDENT 0.0
199 .TP
200 .B \fBdiskspacecheck\fP
201 boolean
202 .sp
203 Controls whether rpm should check available disk space during the transaction.
204 Default is \fBTrue\fP\&.
205 .UNINDENT
206 .INDENT 0.0
207 .TP
208 .B \fBerrorlevel\fP
209 integer
210 .sp
211 Error messages output level, in the range 0 to 10. The higher the number the
212 more error output is put to stderr. Default is 3. This is deprecated in DNF
213 and overwritten by \-\-verbose \%<#\:verbose-options-label> commandline
214 option.
215 .UNINDENT
216 .INDENT 0.0
217 .TP
218 .B \fBexclude_from_weak\fP
219 list
220 .sp
221 Prevent installing packages as weak dependencies (recommends or supplements). The packages can be specified
222 by a name or a glob and separated by a comma. Defaults to \fB[]\fP\&.
223 .UNINDENT
224 .INDENT 0.0
225 .TP
226 .B \fBexclude_from_weak_autodetect\fP
227 boolean
228 .sp
229 If enabled, dnf will autodetect unmet weak dependencies (recommends or supplements) of packages installed on the
230 system. Providers of these weak dependencies will not be installed by dnf as weak dependencies any more (they will
231 still be installed if pulled in as a regular dependency). Defaults to \fBtrue\fP\&.
232 .UNINDENT
233 .INDENT 0.0
234 .TP
235 .B \fBexit_on_lock\fP
236 boolean
237 .sp
238 Should the dnf client exit immediately when something else has the lock. Default is \fBFalse\fP\&.
239 .UNINDENT
240 .INDENT 0.0
241 .TP
242 .B \fBgpgkey_dns_verification\fP
243 boolean
244 .sp
245 Should the dnf attempt to automatically verify GPG verification keys using the DNS
246 system. This option requires the unbound python module (python3\-unbound) to
247 be installed on the client system. This system has two main features. The first
248 one is to check if any of the already installed keys have been revoked. Automatic
249 removal of the key is not yet available, so it is up to the user, to remove
250 revoked keys from the system. The second feature is automatic verification
251 of new keys when a repository is added to the system. In interactive mode, the
252 result is written to the output as a suggestion to the user. In
253 non\-interactive mode (i.e. when \-y is used), this system will automatically
254 accept keys that are available in the DNS and are correctly signed using
255 DNSSEC. It will also accept keys that do not exist in the DNS system and
256 their NON\-existence is cryptographically proven using DNSSEC. This is mainly to
257 preserve backward compatibility.
258 Default is \fBFalse\fP\&.
259 .UNINDENT
260 .INDENT 0.0
261 .TP
262 .B \fBgroup_package_types\fP
263 list
264 .sp
265 List of the following: optional, default, mandatory. Tells dnf which type of packages in groups will
266 be installed when \(aqgroupinstall\(aq is called. Default is: \fBdefault, mandatory\fP\&.
267 .UNINDENT
268 .INDENT 0.0
269 .TP
270 .B \fBignorearch\fP
271 boolean
272 .sp
273 If set to \fBTrue\fP, RPM will allow attempts to install packages incompatible with the CPU\(aqs
274 architecture. Defaults to \fBFalse\fP\&. Often used together with
275 arch option.
276 .UNINDENT
277 .INDENT 0.0
278 .TP
279 .B \fBinstallonlypkgs\fP
280 list
281 .sp
282 List of provide names of packages that should only ever be installed, never
283 upgraded. Kernels in particular fall into this category.
284 These packages are never removed by \fBdnf autoremove\fP even if they were
285 installed as dependencies (see
286 clean_requirements_on_remove
287 for auto removal details).
288 This option append the list values to the default installonlypkgs list used
289 by DNF. The number of kept package versions is regulated
290 by installonly_limit\&.
291 .UNINDENT
292 .INDENT 0.0
293 .TP
294 .B \fBinstallonly_limit\fP
295 integer
296 .sp
297 Number of installonly packages allowed to be installed
298 concurrently. Defaults to 3. The minimal number of installonly packages is 2. Value 0 means
299 unlimited number of installonly packages. Value 1 is explicitly not allowed since it
300 complicates kernel upgrades due to protection of the running kernel from removal.
301 .UNINDENT
302 .INDENT 0.0
303 .TP
304 .B \fBinstallroot\fP
305 string
306 .sp
307 The root of the filesystem for all packaging operations. It requires an absolute path. See also \-\-installroot commandline option\&.
308 .UNINDENT
309 .INDENT 0.0
310 .TP
311 .B \fBinstall_weak_deps\fP
312 boolean
313 .sp
314 When this option is set to True and a new package is about to be
315 installed, all packages linked by weak dependency relation (Recommends or Supplements flags) with this package will be pulled into the transaction.
316 Default is \fBTrue\fP\&.
317 .UNINDENT
318 .INDENT 0.0
319 .TP
320 .B \fBkeepcache\fP
321 boolean
322 .sp
323 Keeps downloaded packages in the cache when set to True. Even if it is set to False and packages have not been
324 installed they will still persist until next successful transaction. The default
325 is \fBFalse\fP\&.
326 .UNINDENT
327 .INDENT 0.0
328 .TP
329 .B \fBlogdir\fP
330 string
331 .sp
332 Directory where the log files will be stored. Default is \fB/var/log\fP\&.
333 .UNINDENT
334 .INDENT 0.0
335 .TP
336 .B \fBlogfilelevel\fP
337 integer
338 .sp
339 Log file messages output level, in the range 0 to 10. The higher the number the
340 more debug output is put to logs. Default is 9.
341 .sp
342 This option controls dnf.log, dnf.librepo.log and hawkey.log. Although dnf.librepo.log
343 and hawkey.log are affected only by setting the logfilelevel to 10.
344 .UNINDENT
345 .INDENT 0.0
346 .TP
347 .B \fBlog_compress\fP
348 boolean
349 .sp
350 When set to \fBTrue\fP, log files are compressed when they are rotated. Default is \fBFalse\fP\&.
351 .UNINDENT
352 .INDENT 0.0
353 .TP
354 .B \fBlog_rotate\fP
355 integer
356 .sp
357 Log files are rotated \fBlog_rotate\fP times before being removed. If \fBlog_rotate\fP
358 is \fB0\fP, the rotation is not performed.
359 Default is \fB4\fP\&.
360 .UNINDENT
361 .INDENT 0.0
362 .TP
363 .B \fBlog_size\fP
364 storage size
365 .sp
366 Log files are rotated when they grow bigger than log_size bytes. If
367 log_size is 0, the rotation is not performed. The default is 1 MB. Valid
368 units are \(aqk\(aq, \(aqM\(aq, \(aqG\(aq.
369 .sp
370 The size applies for individual log files, not the sum of all log files.
371 See also log_rotate\&.
372 .UNINDENT
373 .INDENT 0.0
374 .TP
375 .B \fBmetadata_timer_sync\fP
376 time in seconds
377 .sp
378 The minimal period between two consecutive \fBmakecache timer\fP runs. The
379 command will stop immediately if it\(aqs less than this time period since its
380 last run. Does not affect simple \fBmakecache\fP run. Use \fB0\fP to completely
381 disable automatic metadata synchronizing. The default corresponds to three
382 hours. The value is rounded to the next commenced hour.
383 .UNINDENT
384 .INDENT 0.0
385 .TP
386 .B \fBmodule_obsoletes\fP
387 boolean
388 .sp
389 This option controls whether dnf should apply modular obsoletes when possible. Default is \fBFalse\fP\&.
390 .UNINDENT
391 .INDENT 0.0
392 .TP
393 .B \fBmodule_platform_id\fP
394 string
395 .sp
396 Set this to $name:$stream to override PLATFORM_ID detected from \fB/etc/os\-release\fP\&.
397 It is necessary to perform a system upgrade and switch to a new platform.
398 .UNINDENT
399 .INDENT 0.0
400 .TP
401 .B \fBmodule_stream_switch\fP
402 boolean
403 .sp
404 This option controls whether it\(aqs possible to switch enabled streams of a module. Default is \fBFalse\fP\&.
405 .UNINDENT
406 .INDENT 0.0
407 .TP
408 .B \fBmultilib_policy\fP
409 string
410 .sp
411 Controls how multilib packages are treated during install operations. Can either be \fB\(dqbest\(dq\fP (the default) for
412 the depsolver to prefer packages which best match the system\(aqs architecture, or \fB\(dqall\(dq\fP to install packages for
413 all available architectures.
414 .UNINDENT
415 .INDENT 0.0
416 .TP
417 .B \fBobsoletes\fP
418 boolean
419 .sp
420 This option only has affect during an install/update. It enables
421 dnf\(aqs obsoletes processing logic, which means it makes dnf check whether
422 any dependencies of given package are no longer required and removes them.
423 Useful when doing distribution level upgrades.
424 Default is \(aqtrue\(aq.
425 .sp
426 Command\-line option: \-\-obsoletes \%<#\:obsoletes-option-label>
427 .UNINDENT
428 .INDENT 0.0
429 .TP
430 .B \fBoptional_metadata_types\fP
431 list
432 .sp
433 List of metadata types to be loaded in addition to \fBprimary\fP, \fBmodules\fP, \fBcomps\fP, \fBupdateinfo\fP and \fBpresto\fP,
434 which are loaded always.
435 .sp
436 Note that the list can be extended by individual commands to explicitly request loading specific metadata type.
437 .sp
438 Currently only \fBfilelists\fP value is supported. Default is an empty list.
439 .UNINDENT
440 .INDENT 0.0
441 .TP
442 .B \fBpersistdir\fP
443 string
444 .sp
445 Directory where DNF stores its persistent data between runs. Default is \fB\(dq/var/lib/dnf\(dq\fP\&.
446 .UNINDENT
447 .INDENT 0.0
448 .TP
449 .B \fBpersistence\fP
450 string
451 .sp
452 Whether changes should persist across system reboots. Default is \fBauto\fP\&. Passing \-\-transient \%<#\:transient-option-label> will override this setting to \fBtransient\fP\&. Valid values are:
453 .INDENT 7.0
454 .IP \(bu 2
455 \fBauto\fP: Changes will persist across reboots, unless the target is a running bootc system and the system is already in an unlocked state (i.e. \fB/usr\fP is writable).
456 .IP \(bu 2
457 \fBtransient\fP: Changes will be lost on the next reboot. Only applicable on bootc systems. Beware that changes to \fB/etc\fP and \fB/var\fP will persist, depending on the configuration of your bootc system. See also \%<https://\:bootc-dev\:.github\:.io/\:bootc/\:man/\:bootc-usr-overlay\:.html>\&.
458 .IP \(bu 2
459 \fBpersist\fP: Changes will persist across reboots.
460 .UNINDENT
461 .UNINDENT
462 .INDENT 0.0
463 .TP
464 .B \fBpluginconfpath\fP
465 list
466 .sp
467 List of directories that are searched for plugin configurations to load. All
468 configuration files found in these directories, that are named same as a
469 plugin, are parsed. The default path is \fB/etc/dnf/plugins\fP\&.
470 .UNINDENT
471 .INDENT 0.0
472 .TP
473 .B \fBpluginpath\fP
474 list
475 .sp
476 List of directories that are searched for plugins to load. Plugins found in \fIany of the directories\fP in this configuration option are used. The default contains a Python version\-specific path.
477 .UNINDENT
478 .INDENT 0.0
479 .TP
480 .B \fBplugins\fP
481 boolean
482 .sp
483 Controls whether the plugins are enabled. Default is \fBTrue\fP\&.
484 .UNINDENT
485 .INDENT 0.0
486 .TP
487 .B \fBprotected_packages\fP
488 list
489 .sp
490 List of packages that DNF should never completely remove. They are protected via Obsoletes as well as user/plugin removals.
491 .sp
492 The default is: \fBdnf\fP, \fBglob:/etc/yum/protected.d/*.conf\fP and \fBglob:/etc/dnf/protected.d/*.conf\fP\&. So any packages which should be protected can do so by including a file in \fB/etc/dnf/protected.d\fP with their package name in it.
493 .sp
494 DNF will protect also the package corresponding to the running version of the kernel. See also protect_running_kernel option.
495 .UNINDENT
496 .INDENT 0.0
497 .TP
498 .B \fBprotect_running_kernel\fP
499 boolean
500 .sp
501 Controls whether the package corresponding to the running version of kernel is protected from removal. Default is \fBTrue\fP\&.
502 .UNINDENT
503 .INDENT 0.0
504 .TP
505 .B \fBreleasever\fP
506 string
507 .sp
508 Used for substitution of \fB$releasever\fP in the repository configuration.
509 .sp
510 The \fB$releasever_major\fP and \fB$releasever_minor\fP variables will be automatically derived from \fB$releasever\fP by splitting it on the first \fB\&.\fP\&. For example, if \fB$releasever\fP is set to \fB1.23\fP, then \fB$releasever_major\fP will be \fB1\fP and \fB$releasever_minor\fP will be \fB23\fP\&.
511 .sp
512 \fB$releasever_major\fP and \fB$releasever_minor\fP can also be set by the distribution.
513 .sp
514 See also repo variables\&.
515 .UNINDENT
516 .INDENT 0.0
517 .TP
518 .B \fBreposdir\fP
519 list
520 .sp
521 DNF searches for repository configuration files in the paths specified by
522 \fBreposdir\fP\&. The behavior of \fBreposdir\fP could differ when it is used
523 along with \-\-installroot option.
524 .UNINDENT
525 .INDENT 0.0
526 .TP
527 .B \fBrpmverbosity\fP
528 string
529 .sp
530 RPM debug scriptlet output level. One of: \fBcritical\fP, \fBemergency\fP,
531 \fBerror\fP, \fBwarn\fP, \fBinfo\fP or \fBdebug\fP\&. Default is \fBinfo\fP\&.
532 .UNINDENT
533 .INDENT 0.0
534 .TP
535 .B \fBstrict\fP
536 boolean
537 .sp
538 If disabled, all unavailable packages or packages with broken dependencies given to DNF command will be skipped without raising the error causing the whole operation to fail. Currently works for install command only. The default is True.
539 .UNINDENT
540 .INDENT 0.0
541 .TP
542 .B \fBtsflags\fP
543 list
544 .sp
545 List of strings adding extra flags for the RPM transaction.
546 .TS
547 box center;
548 l|l.
549 T{
550 tsflag value
551 T} T{
552 RPM Transaction Flag
553 T}
554 _
555 T{
556 noscripts
557 T} T{
558 RPMTRANS_FLAG_NOSCRIPTS
559 T}
560 _
561 T{
562 test
563 T} T{
564 RPMTRANS_FLAG_TEST
565 T}
566 _
567 T{
568 notriggers
569 T} T{
570 RPMTRANS_FLAG_NOTRIGGERS
571 T}
572 _
573 T{
574 nodocs
575 T} T{
576 RPMTRANS_FLAG_NODOCS
577 T}
578 _
579 T{
580 justdb
581 T} T{
582 RPMTRANS_FLAG_JUSTDB
583 T}
584 _
585 T{
586 nocontexts
587 T} T{
588 RPMTRANS_FLAG_NOCONTEXTS
589 T}
590 _
591 T{
592 nocaps
593 T} T{
594 RPMTRANS_FLAG_NOCAPS
595 T}
596 _
597 T{
598 nocrypto
599 T} T{
600 RPMTRANS_FLAG_NOFILEDIGEST
601 T}
602 _
603 T{
604 deploops
605 T} T{
606 RPMTRANS_FLAG_DEPLOOPS
607 T}
608 .TE
609 .sp
610 The \fBnocrypto\fP option will also set the \fB_RPMVSF_NOSIGNATURES\fP and
611 \fB_RPMVSF_NODIGESTS\fP VS flags. The \fBtest\fP option provides a transaction check
612 without performing the transaction. It includes downloading of packages, gpg keys check
613 (including permanent import of additional keys if necessary), and rpm check to prevent
614 file conflicts.
615 The \fBnocaps\fP is supported with rpm\-4.14 or later. When \fBnocaps\fP is used but rpm
616 doesn\(aqt support it, DNF only reports it as an invalid tsflag.
617 .UNINDENT
618 .INDENT 0.0
619 .TP
620 .B \fBupgrade_group_objects_upgrade\fP
621 boolean
622 .sp
623 Set this to False to disable the automatic running of \fBgroup upgrade\fP when running the \fBupgrade\fP command. Default is \fBTrue\fP (perform the operation).
624 .UNINDENT
625 .INDENT 0.0
626 .TP
627 .B \fBusr_drift_protected_paths\fP
628 list
629 .sp
630 List of paths that are likely to cause problems when their contents drift with respect to \fB/usr\fP, e.g. \fB/etc/pam.d/*\fP\&. If a transient transaction would modify these paths, DNF aborts the operation and prints an error. Supports globs. Defaults to \fBglob:/etc/dnf/usr\-drift\-protected\-paths.d/*.conf\fP\&. So a list of paths can be protected by creating a \fB\&.conf\fP file in \fB/etc/dnf/usr\-drift\-protected\-paths.d/\fP containing one path (or glob pattern) per line.
631 .sp
632 When using \fBpersistence=transient\fP on bootc systems, a transient overlay is created on \fB/usr\fP, and any changes DNF makes to \fB/usr\fP will be discarded on reboot. However, other paths such as \fB/etc\fP and \fB/var\fP are (often) not backed by a transient overlay, so changes to them will persist across reboots. Usually, this \(dqfilesystem drift\(dq is fine, but it can cause problems in certain situations. For example, a configuration file in \fB/etc\fP that\(aqs shared by multiple packages might reference a \fB\&.so\fP file under \fB/usr/lib64\fP that no longer exists.
633 .UNINDENT
634 .INDENT 0.0
635 .TP
636 .B \fBvarsdir\fP
637 list
638 .sp
639 List of directories where variables definition files are looked for. Defaults to
640 \fB\(dq/etc/dnf/vars\(dq, \(dq/etc/yum/vars\(dq\fP\&. See variable files
641 in Configuration reference.
642 .TP
643 .B \fBzchunk\fP
644 boolean
645 .sp
646 Enables or disables the use of repository metadata compressed using the zchunk format (if available). Default is \fBTrue\fP\&.
647 .UNINDENT
648 .SH [MAIN] OPTIONS - COLORS
649 .INDENT 0.0
650 .TP
651 .B \fBcolor\fP
652 string
653 .sp
654 Controls if DNF uses colored output on the command line.
655 Possible values: \(dqauto\(dq, \(dqnever\(dq, \(dqalways\(dq. Default is \(dqauto\(dq.
656 .UNINDENT
657 .INDENT 0.0
658 .TP
659 .B \fBcolor_list_available_downgrade\fP
660 color
661 .sp
662 Color of available packages that are older than installed packages.
663 The option is used during list operations. Default is magenta.
664 .UNINDENT
665 .INDENT 0.0
666 .TP
667 .B \fBcolor_list_available_install\fP
668 color
669 .sp
670 Color of packages that are available for installation and none of their versions in installed.
671 The option is used during list operations. Default is bold,cyan.
672 .UNINDENT
673 .INDENT 0.0
674 .TP
675 .B \fBcolor_list_available_reinstall\fP
676 color
677 .sp
678 Color of available packages that are identical to installed versions and are available for reinstalls. Default is bold,underline,green.
679 The option is used during list operations.
680 .UNINDENT
681 .INDENT 0.0
682 .TP
683 .B \fBcolor_list_available_upgrade\fP
684 color
685 .sp
686 Color of available packages that are newer than installed packages. Default is bold,blue.
687 The option is used during list operations.
688 .UNINDENT
689 .INDENT 0.0
690 .TP
691 .B \fBcolor_list_installed_extra\fP
692 color
693 .sp
694 Color of installed packages that do not have any version among available packages.
695 The option is used during list operations. Default is bold,red.
696 .UNINDENT
697 .INDENT 0.0
698 .TP
699 .B \fBcolor_list_installed_newer\fP
700 color
701 .sp
702 Color of installed packages that are newer than any version among available packages.
703 The option is used during list operations. Default is bold,yellow.
704 .UNINDENT
705 .INDENT 0.0
706 .TP
707 .B \fBcolor_list_installed_older\fP
708 color
709 .sp
710 Color of installed packages that are older than any version among available packages.
711 The option is used during list operations. Default is yellow.
712 .UNINDENT
713 .INDENT 0.0
714 .TP
715 .B \fBcolor_list_installed_reinstall\fP
716 color
717 .sp
718 Color of installed packages that are among available packages and can be reinstalled.
719 The option is used during list operations. Default is cyan.
720 .UNINDENT
721 .INDENT 0.0
722 .TP
723 .B \fBcolor_search_match\fP
724 color
725 .sp
726 Color of patterns matched in search output. Default is bold,magenta.
727 .UNINDENT
728 .INDENT 0.0
729 .TP
730 .B \fBcolor_update_installed\fP
731 color
732 .sp
733 Color of removed packages. Default is red.
734 This option is used during displaying transactions.
735 .UNINDENT
736 .INDENT 0.0
737 .TP
738 .B \fBcolor_update_local\fP
739 color
740 .sp
741 Color of local packages that are installed from the @commandline repository.
742 This option is used during displaying transactions. Default is green.
743 .UNINDENT
744 .INDENT 0.0
745 .TP
746 .B \fBcolor_update_remote\fP
747 color
748 .sp
749 Color of packages that are installed/upgraded/downgraded from remote repositories.
750 This option is used during displaying transactions. Default is bold,green.
751 .UNINDENT
752 .SH REPO OPTIONS
753 .INDENT 0.0
754 .TP
755 .B \fBbaseurl\fP
756 list
757 .sp
758 List of URLs for the repository. Defaults to \fB[]\fP\&.
759 .sp
760 URLs are tried in the listed order (equivalent to yum\(aqs \(dqfailovermethod=priority\(dq behaviour).
761 .UNINDENT
762 .INDENT 0.0
763 .TP
764 .B \fBcost\fP
765 integer
766 .sp
767 The relative cost of accessing this repository, defaulting to 1000. This
768 value is compared when the priorities of two repositories are the same. The
769 repository with \fIthe lowest cost\fP is picked. It is useful to make the
770 library prefer on\-disk repositories to remote ones.
771 .UNINDENT
772 .INDENT 0.0
773 .TP
774 .B \fBenabled\fP
775 boolean
776 .sp
777 Include this repository as a package source. The default is True.
778 .UNINDENT
779 .INDENT 0.0
780 .TP
781 .B \fBgpgkey\fP
782 list of strings
783 .sp
784 URLs of a GPG key files that can be used for signing metadata and packages of this repository, empty by default. If a file can not be verified using the already imported keys, import of keys from this option is attempted and the keys are then used for verification.
785 .UNINDENT
786 .INDENT 0.0
787 .TP
788 .B \fBmetalink\fP
789 string
790 .sp
791 URL of a metalink for the repository. Defaults to \fBNone\fP\&.
792 .UNINDENT
793 .INDENT 0.0
794 .TP
795 .B \fBmirrorlist\fP
796 string
797 .sp
798 URL of a mirrorlist for the repository. Defaults to \fBNone\fP\&.
799 .UNINDENT
800 .INDENT 0.0
801 .TP
802 .B \fBmodule_hotfixes\fP
803 boolean
804 .sp
805 Set this to True to disable module RPM filtering and make all RPMs from the repository available. The default is False.
806 This allows user to create a repository with cherry\-picked hotfixes that are included in a package set on a modular system.
807 .UNINDENT
808 .INDENT 0.0
809 .TP
810 .B \fBname\fP
811 string
812 .sp
813 A human\-readable name of the repository. Defaults to the ID of the repository.
814 .UNINDENT
815 .INDENT 0.0
816 .TP
817 .B \fBpriority\fP
818 integer
819 .sp
820 The priority value of this repository, default is 99. If there is more than one candidate package for a particular operation, the one from a repo with \fIthe lowest priority value\fP is picked, possibly despite being less convenient otherwise (e.g. by being a lower version).
821 .UNINDENT
822 .INDENT 0.0
823 .TP
824 .B \fBtype\fP
825 string
826 .sp
827 Type of repository metadata. Supported values are: \fBrpm\-md\fP\&.
828 Aliases for \fBrpm\-md\fP: \fBrpm\fP, \fBrepomd\fP, \fBrpmmd\fP, \fByum\fP, \fBYUM\fP\&.
829 .UNINDENT
830 .SH SOURCE AND DEBUGINFO REPOSITORY NAMES
831 .sp
832 For a given repository with an identifier in the form \(dq<ID>\-rpms\(dq, its corresponding source repository is expected to have an identifier in the form \(dq<ID>\-source\-rpms\(dq and debuginfo repository an identifier in the form \(dq<ID>\-debug\-rpms\(dq. Otherwise (if the repository identifier doesn\(aqt have the \(dq\-rpms\(dq suffix), the source repository is expected to have an identifier in the form \(dq<ID>\-source\(dq and debuginfo repository an identifier in the form \(dq<ID>\-debuginfo\(dq.
833 .sp
834 For example, for repository \(dqfedora\(dq, the source repository is \(dqfedora\-source\(dq and debuginfo repository is \(dqfedora\-debuginfo\(dq. For repository \(dqfedora\-rpms\(dq, the source repository is \(dqfedora\-source\-rpms\(dq and debuginfo repository is \(dqfedora\-debug\-rpms\(dq.
835 .SH REPO VARIABLES
836 .sp
837 Right side of every repo option can be enriched by the following variables:
838 .sp
839 \fB$arch\fP
840 .INDENT 0.0
841 .INDENT 3.5
842 Refers to the system’s CPU architecture e.g, aarch64, i586, i686 and x86_64.
843 .UNINDENT
844 .UNINDENT
845 .sp
846 \fB$basearch\fP
847 .INDENT 0.0
848 .INDENT 3.5
849 Refers to the base architecture of the system. For example, i686 and i586 machines
850 both have a base architecture of i386, and AMD64 and Intel64 machines have a base architecture of x86_64.
851 .UNINDENT
852 .UNINDENT
853 .sp
854 \fB$releasever\fP
855 .INDENT 0.0
856 .INDENT 3.5
857 Refers to the release version of operating system which DNF derives from information available in RPMDB.
858 .UNINDENT
859 .UNINDENT
860 .sp
861 \fB$releasever_major\fP
862 .INDENT 0.0
863 .INDENT 3.5
864 Major version of \fB$releasever\fP, i.e. the component of \fB$releasever\fP occurring before the first \fB\&.\fP\&.
865 .UNINDENT
866 .UNINDENT
867 .sp
868 \fB$releasever_minor\fP
869 .INDENT 0.0
870 .INDENT 3.5
871 Minor version of \fB$releasever\fP, i.e. the component of \fB$releasever\fP occurring after the first \fB\&.\fP\&.
872 .UNINDENT
873 .UNINDENT
874 .sp
875 In addition to these hard coded variables, user\-defined ones can also be used. They can be defined either via variable files, or by using special environmental variables. The names of these variables must be prefixed with DNF_VAR_ and they can only consist of alphanumeric characters and underscores:
876 .INDENT 0.0
877 .INDENT 3.5
878 .sp
879 .EX
880 $ DNF_VAR_MY_VARIABLE=value
881 .EE
882 .UNINDENT
883 .UNINDENT
884 .sp
885 To use such variable in your repository configuration remove the prefix. E.g.:
886 .INDENT 0.0
887 .INDENT 3.5
888 .sp
889 .EX
890 [myrepo]
891 baseurl=https://example.site/pub/fedora/$MY_VARIABLE/releases/$releasever
892 .EE
893 .UNINDENT
894 .UNINDENT
895 .sp
896 Note that it is not possible to override the \fBarch\fP and \fBbasearch\fP variables using either variable files or environmental variables.
897 .sp
898 Although users are encouraged to use named variables, the numbered environmental variables \fBDNF0\fP \- \fBDNF9\fP are still supported:
899 .INDENT 0.0
900 .INDENT 3.5
901 .sp
902 .EX
903 $ DNF1=value
904
905 [myrepo]
906 baseurl=https://example.site/pub/fedora/$DNF1/releases/$releasever
907 .EE
908 .UNINDENT
909 .UNINDENT
910 .sp
911 A limited form of shell\-like parameter expansion is supported for variables.
912 .sp
913 \fB${my_variable:\-word}\fP If \fBmy_variable\fP is unset or empty, then \fBword\fP will be substituted. Otherwise, the value of \fBmy_variable\fP will be substituted.
914 .sp
915 \fB${my_variable:+word}\fP If \fBmy_variable\fP is set and not empty, then \fBword\fP will be substituted. Otherwise, the empty string will be substituted.
916 .sp
917 Parameter expansions can be nested up to a maximum depth of 32. For example:
918 .INDENT 0.0
919 .INDENT 3.5
920 .sp
921 .EX
922 ${my_defined_variable:+${my_undefined_variable:\-foobar}}
923 .EE
924 .UNINDENT
925 .UNINDENT
926 .sp
927 will evaluate to \fBfoobar\fP\&.
928 .SH OPTIONS FOR BOTH [MAIN] AND REPO
929 .sp
930 Some options can be applied in either the main section, per repository, or in a
931 combination. The value provided in the main section is used for all repositories
932 as the default value, which repositories can then override in their
933 configuration.
934 .INDENT 0.0
935 .TP
936 .B \fBbandwidth\fP
937 storage size
938 .sp
939 Total bandwidth available for downloading. Meaningful when used with the throttle option\&. Storage size is in bytes by default but can be specified with a unit of storage. Valid units are \(aqk\(aq, \(aqM\(aq, \(aqG\(aq.
940 .UNINDENT
941 .INDENT 0.0
942 .TP
943 .B \fBcountme\fP
944 boolean
945 .sp
946 When enabled, one (and only one) HTTP GET request for the metalink file
947 will be selected at random every week to carry a special URL flag.
948 .sp
949 This flag allows the repository provider to estimate the number of systems
950 consuming the repository, by counting such requests over a week\(aqs time.
951 This method is more accurate than just counting unique IP addresses (which
952 is subject to both overcounting and undercounting due to short DHCP leases
953 and NAT, respectively).
954 .sp
955 This is \fInot\fP an out\-of\-band HTTP request made for this purpose alone.
956 Only requests initiated by DNF during normal operation, such as to check
957 for metadata updates, can get this flag.
958 .sp
959 The flag is a simple \(dqcountme=N\(dq parameter appended to the metalink URL
960 where N is an integer representing the age \(dqbucket\(dq this system belongs to.
961 Four buckets are defined, based on how many full weeks have passed since
962 the installation of a system:
963 .TS
964 box center;
965 l|l.
966 T{
967 bucket
968 T} T{
969 system age
970 T}
971 _
972 T{
973 1
974 T} T{
975 first week
976 T}
977 _
978 T{
979 2
980 T} T{
981 first month (2 \- 4 weeks)
982 T}
983 _
984 T{
985 3
986 T} T{
987 first 6 months (5 \- 24 weeks)
988 T}
989 _
990 T{
991 4
992 T} T{
993 more than 6 months (> 24 weeks)
994 T}
995 .TE
996 .sp
997 This number is meant to help distinguish short\-lived (throwaway) machines
998 from long\-term installs and get a better picture of how systems are used
999 over time.
1000 .sp
1001 To determine a system\(aqs installation time (\(dqepoch\(dq), the \fBmachine\-id(5)\fP
1002 file\(aqs modification time is used as the single source of truth. This file
1003 is semantically tied to the system\(aqs lifetime as it\(aqs typically populated
1004 at installation time or during the first boot by an installer tool or init
1005 system (such as \fBsystemd(1)\fP), respectively, and remains unchanged.
1006 .sp
1007 If the file is empty or missing (such as in containers), the time of the
1008 very first request made using the expanded metalink URL (i.e. with any
1009 repository variables such as \fB$releasever\fP substituted) that carried the
1010 flag is declared as the epoch.
1011 .sp
1012 If no metalink URL is defined for this repository but a mirrorlist URL is,
1013 the latter is used for this purpose instead.
1014 .sp
1015 Default is False.
1016 .UNINDENT
1017 .INDENT 0.0
1018 .TP
1019 .B \fBdeltarpm\fP
1020 boolean
1021 .sp
1022 When enabled, DNF will save bandwidth by downloading much smaller delta RPM
1023 files, rebuilding them to RPM locally. However, this is quite CPU and I/O
1024 intensive. Default is False. It requires \fI/usr/bin/applydeltarpm\fP on the system.
1025 .UNINDENT
1026 .INDENT 0.0
1027 .TP
1028 .B \fBdeltarpm_percentage\fP
1029 integer
1030 .sp
1031 When the relative size of delta vs pkg is larger than this, delta is not used. Default value is 75
1032 (Deltas must be at least 25% smaller than the pkg). Use \fI0\fP to turn off delta rpm processing. Local repositories (with
1033 \%<file://> baseurl) have delta rpms turned off by default.
1034 .UNINDENT
1035 .INDENT 0.0
1036 .TP
1037 .B \fBenablegroups\fP
1038 boolean
1039 .sp
1040 Determines whether DNF will allow the use of package groups for this repository. Default is True (package groups are allowed).
1041 .UNINDENT
1042 .INDENT 0.0
1043 .TP
1044 .B \fBexcludepkgs\fP
1045 list
1046 .sp
1047 Exclude packages of this repository, specified by a name or a glob and
1048 separated by a comma, from all operations.
1049 Can be disabled using \fB\-\-disableexcludes\fP command line switch.
1050 Defaults to \fB[]\fP\&.
1051 .UNINDENT
1052 .INDENT 0.0
1053 .TP
1054 .B \fBfastestmirror\fP
1055 boolean
1056 .sp
1057 If enabled, TCP socket latency is used to find the closest available mirror.
1058 A mirror is then selected at random with less than twice the lowest latency for load balancing purposes.
1059 This overrides the order provided by the mirrorlist/metalink file itself,
1060 and does not take into consideration mirrorlist parameters such as mirror bandwidth nor preferred mirrors for client IP addresses.
1061 .UNINDENT
1062 .INDENT 0.0
1063 .TP
1064 .B \fBgpgcheck\fP
1065 boolean
1066 .sp
1067 Whether to perform GPG signature check on packages found in this repository.
1068 The default is False.
1069 .sp
1070 This option can only be used to strengthen the active RPM security policy set with the \fB%_pkgverify_level\fP macro (see the \fB/usr/lib/rpm/macros\fP file for details).
1071 That means, if the macro is set to \(aqsignature\(aq or \(aqall\(aq and this option is False, it will be overridden to True during DNF runtime, and a warning will be printed.
1072 To squelch the warning, make sure this option is True for every enabled repository, and also enable localpkg_gpgcheck\&.
1073 .UNINDENT
1074 .INDENT 0.0
1075 .TP
1076 .B \fBincludepkgs\fP
1077 list
1078 .sp
1079 Include packages of this repository, specified by a name or a glob and separated by a comma, in all operations.
1080 Inverse of excludepkgs, DNF will exclude any package in the repository that doesn\(aqt match this list. This works in conjunction with \fBexcludepkgs\fP and doesn\(aqt override it, so if you \(aqexcludepkgs=*.i386\(aq and \(aqincludepkgs=python*\(aq then only packages starting with python that do not have an i386 arch will be seen by DNF in this repo.
1081 Can be disabled using \fB\-\-disableexcludes\fP command line switch.
1082 Defaults to \fB[]\fP\&.
1083 .UNINDENT
1084 .INDENT 0.0
1085 .TP
1086 .B \fBip_resolve\fP
1087 IP address type
1088 .sp
1089 Determines how DNF resolves host names. Set this to \(aq4\(aq/\(aqIPv4\(aq or \(aq6\(aq/\(aqIPv6\(aq to resolve to IPv4 or IPv6 addresses only. By default, DNF resolves to either addresses.
1090 .UNINDENT
1091 .INDENT 0.0
1092 .TP
1093 .B \fBlocalpkg_gpgcheck\fP
1094 boolean
1095 .sp
1096 Whether to perform a GPG signature check on local packages (packages in a file, not in a repository).
1097 The default is False.
1098 This option is subject to the active RPM security policy (see gpgcheck for more details).
1099 .UNINDENT
1100 .INDENT 0.0
1101 .TP
1102 .B \fBmax_parallel_downloads\fP
1103 integer
1104 .sp
1105 Maximum number of simultaneous package downloads. Defaults to 3. Maximum of 20.
1106 .UNINDENT
1107 .INDENT 0.0
1108 .TP
1109 .B \fBmetadata_expire\fP
1110 time in seconds
1111 .sp
1112 The period after which the remote repository is checked for metadata update and in the positive
1113 case the local metadata cache is updated. The default corresponds to 48 hours. Set this to
1114 \fB\-1\fP or \fBnever\fP to make the repo never considered expired. Expire of metadata can be also
1115 triggered by change of timestamp of configuration files (\fBdnf.conf\fP, \fB<repo>.repo\fP). See
1116 also check_config_file_age\&.
1117 .UNINDENT
1118 .INDENT 0.0
1119 .TP
1120 .B \fBminrate\fP
1121 storage size
1122 .sp
1123 This sets the low speed threshold in bytes per second. If the server is sending data at the same or slower speed than this value for at least timeout option seconds, DNF aborts the connection. The default is 1000. Valid units are \(aqk\(aq, \(aqM\(aq, \(aqG\(aq.
1124 .UNINDENT
1125 .INDENT 0.0
1126 .TP
1127 .B \fBpassword\fP
1128 string
1129 .sp
1130 The password to use for connecting to a repository with basic HTTP authentication. Empty by default.
1131 .UNINDENT
1132 .INDENT 0.0
1133 .TP
1134 .B \fBproxy\fP
1135 string
1136 .sp
1137 URL of a proxy server to connect through. Set to an empty string in the repository configuration to disable proxy setting inherited from the main section. The expected format of this option is \fB<scheme>://<ip\-or\-hostname>[:port]\fP\&.
1138 (For backward compatibility, \(aq_none_\(aq can be used instead of the empty string.)
1139 .sp
1140 Note: The curl environment variables (such as \fBhttp_proxy\fP) are effective if this option is unset (or \(aq_none_\(aq is set in the repository configuration). See the \fBcurl\fP man page for details.
1141 .UNINDENT
1142 .INDENT 0.0
1143 .TP
1144 .B \fBproxy_username\fP
1145 string
1146 .sp
1147 The username to use for connecting to the proxy server. Empty by default.
1148 .UNINDENT
1149 .INDENT 0.0
1150 .TP
1151 .B \fBproxy_password\fP
1152 string
1153 .sp
1154 The password to use for connecting to the proxy server. Empty by default.
1155 .UNINDENT
1156 .INDENT 0.0
1157 .TP
1158 .B \fBproxy_auth_method\fP
1159 string
1160 .sp
1161 The authentication method used by the proxy server. Valid values are
1162 .TS
1163 box center;
1164 l|l.
1165 T{
1166 method
1167 T} T{
1168 meaning
1169 T}
1170 _
1171 T{
1172 basic
1173 T} T{
1174 HTTP Basic authentication
1175 T}
1176 _
1177 T{
1178 digest
1179 T} T{
1180 HTTP Digest authentication
1181 T}
1182 _
1183 T{
1184 negotiate
1185 T} T{
1186 HTTP Negotiate (SPNEGO) authentication
1187 T}
1188 _
1189 T{
1190 ntlm
1191 T} T{
1192 HTTP NTLM authentication
1193 T}
1194 _
1195 T{
1196 digest_ie
1197 T} T{
1198 HTTP Digest authentication with an IE flavor
1199 T}
1200 _
1201 T{
1202 ntlm_wb
1203 T} T{
1204 NTLM delegating to winbind helper
1205 T}
1206 _
1207 T{
1208 none
1209 T} T{
1210 None auth method
1211 T}
1212 _
1213 T{
1214 any
1215 T} T{
1216 All suitable methods
1217 T}
1218 .TE
1219 .sp
1220 Defaults to \fBany\fP
1221 .UNINDENT
1222 .INDENT 0.0
1223 .TP
1224 .B \fBproxy_sslcacert\fP
1225 string
1226 .sp
1227 Path to the file containing the certificate authorities to verify proxy SSL certificates.
1228 Empty by default \- uses system default.
1229 .UNINDENT
1230 .INDENT 0.0
1231 .TP
1232 .B \fBproxy_sslverify\fP
1233 boolean
1234 .sp
1235 When enabled, proxy SSL certificates are verified. If the client can not be authenticated, connecting fails and the repository is not used any further. If \fBFalse\fP, SSL connections can be used, but certificates are not verified. Default is \fBTrue\fP\&.
1236 .UNINDENT
1237 .INDENT 0.0
1238 .TP
1239 .B \fBproxy_sslclientcert\fP
1240 string
1241 .sp
1242 Path to the SSL client certificate used to connect to proxy server.
1243 Empty by default.
1244 .UNINDENT
1245 .INDENT 0.0
1246 .TP
1247 .B \fBproxy_sslclientkey\fP
1248 string
1249 .sp
1250 Path to the SSL client key used to connect to proxy server.
1251 Empty by default.
1252 .UNINDENT
1253 .INDENT 0.0
1254 .TP
1255 .B \fBrepo_gpgcheck\fP
1256 boolean
1257 .sp
1258 Whether to perform GPG signature check on this repository\(aqs metadata. The default is False.
1259 Note that GPG keys for this check are stored separately from GPG keys used in package signature
1260 verification. Furthermore, they are also stored separately for each repository.
1261 .sp
1262 This means that dnf may ask to import the same key multiple times. For example, when a key was
1263 already imported for package signature verification and this option is turned on, it may be needed
1264 to import it again for the repository.
1265 .UNINDENT
1266 .INDENT 0.0
1267 .TP
1268 .B \fBretries\fP
1269 integer
1270 .sp
1271 Set the number of total retries for downloading packages. The number is
1272 accumulative, so e.g. for \fIretries=10\fP, dnf will fail after any package
1273 download fails for eleventh time. Setting this to \fI0\fP makes dnf try
1274 forever. Default is \fI10\fP\&.
1275 .UNINDENT
1276 .INDENT 0.0
1277 .TP
1278 .B \fBskip_if_unavailable\fP
1279 boolean
1280 .sp
1281 If enabled, DNF will continue running and disable the repository that couldn\(aqt be synchronized
1282 for any reason. This option doesn\(aqt affect skipping of unavailable packages after dependency
1283 resolution. To check inaccessibility of repository use it in combination with
1284 refresh command line option \%<#\:refresh-command-label>\&. The default is \fBFalse\fP\&.
1285 Note this option in particular can be set in your configuration file
1286 by your distribution\&.
1287 .UNINDENT
1288 .INDENT 0.0
1289 .TP
1290 .B \fBsslcacert\fP
1291 string
1292 .sp
1293 Path to the file containing the certificate authorities to verify SSL certificates.
1294 Empty by default \- uses system default.
1295 .UNINDENT
1296 .INDENT 0.0
1297 .TP
1298 .B \fBsslverify\fP
1299 boolean
1300 .sp
1301 When enabled, remote SSL certificates are verified. If the client can not be authenticated, connecting fails and the repository is not used any further. If \fBFalse\fP, SSL connections can be used, but certificates are not verified. Default is \fBTrue\fP\&.
1302 .UNINDENT
1303 .INDENT 0.0
1304 .TP
1305 .B \fBsslverifystatus\fP
1306 boolean
1307 .sp
1308 When enabled, revocation status of the server certificate is verified using the \(dqCertificate Status Request\(dq TLS extension (aka. OCSP stapling). Default is \fBFalse\fP\&.
1309 .UNINDENT
1310 .INDENT 0.0
1311 .TP
1312 .B \fBsslclientcert\fP
1313 string
1314 .sp
1315 Path to the SSL client certificate used to connect to remote sites.
1316 Empty by default.
1317 .UNINDENT
1318 .INDENT 0.0
1319 .TP
1320 .B \fBsslclientkey\fP
1321 string
1322 .sp
1323 Path to the SSL client key used to connect to remote sites.
1324 Empty by default.
1325 .UNINDENT
1326 .INDENT 0.0
1327 .TP
1328 .B \fBthrottle\fP
1329 storage size
1330 .sp
1331 Limits the downloading speed. It might be an absolute value or a percentage, relative to the value of the bandwidth option option. \fB0\fP means no throttling (the default). The absolute value is in bytes by default but can be specified with a unit of storage. Valid units are \(aqk\(aq, \(aqM\(aq, \(aqG\(aq.
1332 .UNINDENT
1333 .INDENT 0.0
1334 .TP
1335 .B \fBtimeout\fP
1336 time in seconds
1337 .sp
1338 Number of seconds to wait for a connection before timing out. Used in combination with minrate option option. Defaults to 30 seconds.
1339 .UNINDENT
1340 .INDENT 0.0
1341 .TP
1342 .B \fBusername\fP
1343 string
1344 .sp
1345 The username to use for connecting to repo with basic HTTP authentication. Empty by default.
1346 .UNINDENT
1347 .INDENT 0.0
1348 .TP
1349 .B \fBuser_agent\fP
1350 string
1351 .sp
1352 The User\-Agent string to include in HTTP requests sent by DNF.
1353 Defaults to
1354 .INDENT 7.0
1355 .INDENT 3.5
1356 .sp
1357 .EX
1358 libdnf (NAME VERSION_ID; VARIANT_ID; OS.BASEARCH)
1359 .EE
1360 .UNINDENT
1361 .UNINDENT
1362 .sp
1363 where NAME, VERSION_ID and VARIANT_ID are OS identifiers read from the
1364 \fBos\-release(5)\fP file, and OS and BASEARCH are the canonical OS
1365 name and base architecture, respectively.
1366 Example:
1367 .INDENT 7.0
1368 .INDENT 3.5
1369 .sp
1370 .EX
1371 libdnf (Fedora 31; server; Linux.x86_64)
1372 .EE
1373 .UNINDENT
1374 .UNINDENT
1375 .UNINDENT
1376 .SH TYPES OF OPTIONS
1377 .INDENT 0.0
1378 .TP
1379 .B \fBboolean\fP
1380 This is a data type with only two possible values.
1381 .sp
1382 One of following options can be used: 1, 0, True, False, yes, no
1383 .UNINDENT
1384 .INDENT 0.0
1385 .TP
1386 .B \fBinteger\fP
1387 It is a whole number that can be written without a fractional component.
1388 .UNINDENT
1389 .INDENT 0.0
1390 .TP
1391 .B \fBlist\fP
1392 It is an option that could represent one or more strings separated by space or comma characters.
1393 .UNINDENT
1394 .INDENT 0.0
1395 .TP
1396 .B \fBstring\fP
1397 It is a sequence of symbols or digits without any whitespace character.
1398 .UNINDENT
1399 .INDENT 0.0
1400 .TP
1401 .B \fBcolor\fP
1402 A string describing color and modifiers separated with a comma, for example \(dqred,bold\(dq.
1403 .INDENT 7.0
1404 .IP \(bu 2
1405 Colors: black, blue, cyan, green, magenta, red, white, yellow
1406 .IP \(bu 2
1407 Modifiers: bold, blink, dim, normal, reverse, underline
1408 .UNINDENT
1409 .UNINDENT
1410 .SH FILES
1411 .INDENT 0.0
1412 .TP
1413 .B \fBCache Files\fP
1414 /var/cache/dnf
1415 .UNINDENT
1416 .INDENT 0.0
1417 .TP
1418 .B \fBMain Configuration File\fP
1419 /etc/dnf/dnf.conf
1420 .UNINDENT
1421 .INDENT 0.0
1422 .TP
1423 .B \fBRepository\fP
1424 /etc/yum.repos.d/
1425 .UNINDENT
1426 .INDENT 0.0
1427 .TP
1428 .B \fBVariables\fP
1429 Any properly named file in /etc/dnf/vars is turned into a variable named after the filename (or
1430 overrides any of the above variables but those set from commandline). Filenames may contain only
1431 alphanumeric characters and underscores and be in lowercase.
1432 Variables are also read from /etc/yum/vars for YUM compatibility reasons.
1433 .UNINDENT
1434 .SH SEE ALSO
1435 .INDENT 0.0
1436 .IP \(bu 2
1437 \fBdnf(8)\fP, DNF Command Reference \%<#\:command-ref-label>
1438 .UNINDENT
1439 .SH Author
1440 See AUTHORS in DNF source distribution.
1441 .SH Copyright
1442 2012-2020, Red Hat, Licensed under GPLv2+
1443 .\" End of generated man page.