|
Packit Service |
21c75c |
..
|
|
Packit Service |
21c75c |
Copyright (C) 2014-2018 Red Hat, Inc.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
This copyrighted material is made available to anyone wishing to use,
|
|
Packit Service |
21c75c |
modify, copy, or redistribute it subject to the terms and conditions of
|
|
Packit Service |
21c75c |
the GNU General Public License v.2, or (at your option) any later version.
|
|
Packit Service |
21c75c |
This program is distributed in the hope that it will be useful, but WITHOUT
|
|
Packit Service |
21c75c |
ANY WARRANTY expressed or implied, including the implied warranties of
|
|
Packit Service |
21c75c |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
|
|
Packit Service |
21c75c |
Public License for more details. You should have received a copy of the
|
|
Packit Service |
21c75c |
GNU General Public License along with this program; if not, write to the
|
|
Packit Service |
21c75c |
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
|
Packit Service |
21c75c |
02110-1301, USA. Any Red Hat trademarks that are incorporated in the
|
|
Packit Service |
21c75c |
source code or documentation are not subject to the GNU General Public
|
|
Packit Service |
21c75c |
License and may only be used or replicated with the express permission of
|
|
Packit Service |
21c75c |
Red Hat, Inc.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _conf_ref-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
#############################
|
|
Packit Service |
21c75c |
DNF Configuration Reference
|
|
Packit Service |
21c75c |
#############################
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
=============
|
|
Packit Service |
21c75c |
Description
|
|
Packit Service |
21c75c |
=============
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
`DNF`_ by default uses the global configuration file at ``/etc/dnf/dnf.conf`` and
|
|
Packit Service |
21c75c |
all \*.repo files found under ``/etc/yum.repos.d``. The latter is typically used
|
|
Packit Service |
21c75c |
for repository configuration and takes precedence over global configuration.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The configuration file has INI format consisting of section declaration and
|
|
Packit Service |
21c75c |
``name=value`` options below each on separate line. There are two types of sections
|
|
Packit Service |
21c75c |
in the configuration files: main and repository. Main section defines all global
|
|
Packit Service |
21c75c |
configuration options and should be only one.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The repository sections define the configuration for each (remote or local)
|
|
Packit Service |
21c75c |
repository. The section name of the repository in brackets serve as repo ID reference
|
|
Packit Service |
21c75c |
and should be unique across configuration files. The allowed characters of repo ID
|
|
Packit Service |
21c75c |
string are lower and upper case alphabetic letters, digits, ``-``, ``_``, ``.``
|
|
Packit Service |
21c75c |
and ``:``. The minimal repository configuration file should aside from repo ID
|
|
Packit Service |
21c75c |
consists of :ref:`baseurl <baseurl-label>`, :ref:`metalink <metalink-label>`
|
|
Packit Service |
21c75c |
or :ref:`mirrorlist <mirrorlist-label>` option definition.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _conf_distribution_specific-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
=====================================
|
|
Packit Service |
21c75c |
Distribution-Specific Configuration
|
|
Packit Service |
21c75c |
=====================================
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Configuration options, namely :ref:`best <best-label>` and
|
|
Packit Service |
21c75c |
:ref:`skip_if_unavailable <skip_if_unavailable-label>`, can be set in the DNF
|
|
Packit Service |
21c75c |
configuration file by your distribution to override the DNF defaults.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _conf_main_options-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
================
|
|
Packit Service |
21c75c |
[main] Options
|
|
Packit Service |
21c75c |
================
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _allow_vendor_change-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``allow_vendor_change``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
If disabled dnf will stick to vendor when upgrading or downgrading rpms.
|
|
Packit Service |
21c75c |
Default is ``True``
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. WARNING:: This option is currently not supported for `downgrade` and `distro-sync` commands
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _arch-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``arch``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The architecture used for installing packages. By default this is auto-detected. Often used
|
|
Packit Service |
21c75c |
together with :ref:`ignorearch <ignorearch-label>` option.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _assumeno-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``assumeno``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
If enabled dnf will assume ``No`` where it would normally prompt for
|
|
Packit Service |
21c75c |
confirmation from user input. Default is ``False``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _assumeyes-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``assumeyes``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
If enabled dnf will assume ``Yes`` where it would normally prompt for
|
|
Packit Service |
21c75c |
confirmation from user input (see also :ref:`defaultyes <defaultyes-label>`). Default is ``False``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _autocheck_running_kernel-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``autocheck_running_kernel``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Automatic check whether there is installed newer kernel module with security update than currently running kernel. Default is ``True``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``basearch``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The base architecture used for installing packages. By default this is auto-detected.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _best-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``best``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``True`` instructs the solver to either use a package with the highest available
|
|
Packit Service |
21c75c |
version or fail. On ``False``, do not fail if the latest version cannot be
|
|
Packit Service |
21c75c |
installed and go with the lower version. The default is ``False``. Note
|
|
Packit Service |
21c75c |
this option in particular :ref:`can be set in your configuration file by
|
|
Packit Service |
21c75c |
your distribution <conf_distribution_specific-label>`.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``cachedir``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Path to a directory used by various DNF subsystems for storing cache data.
|
|
Packit Service |
21c75c |
Has a reasonable root-writable default depending on the distribution. DNF
|
|
Packit Service |
21c75c |
needs to be able to create files and directories at this location.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``cacheonly``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
If set to ``True`` DNF will run entirely from system cache, will not update
|
|
Packit Service |
21c75c |
the cache and will use it even in case it is expired. Default is ``False``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _check_config_file_age-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``check_config_file_age``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Specifies whether dnf should automatically expire metadata of repos, which are older than
|
|
Packit Service |
21c75c |
their corresponding configuration file (usually the dnf.conf file and the foo.repo file).
|
|
Packit Service |
21c75c |
Default is ``True`` (perform the check). Expire of metadata is also affected by metadata age.
|
|
Packit Service |
21c75c |
See also :ref:`metadata_expire <metadata_expire-label>`.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _clean_requirements_on_remove-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``clean_requirements_on_remove``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Remove dependencies that are no longer used during ``dnf remove``. A package
|
|
Packit Service |
21c75c |
only qualifies for removal via ``clean_requirements_on_remove`` if it was
|
|
Packit Service |
21c75c |
installed through DNF but not on explicit user request, i.e. it was
|
|
Packit Service |
21c75c |
pulled in as a dependency. The default is True.
|
|
Packit Service |
21c75c |
(:ref:`installonlypkgs <installonlypkgs-label>` are never automatically removed.)
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``config_file_path``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Path to the default main configuration file. Default is ``/etc/dnf/dnf.conf``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``debuglevel``
|
|
Packit Service |
21c75c |
:ref:`integer <integer-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Debug messages output level, in the range 0 to 10. The higher the number the
|
|
Packit Service |
21c75c |
more debug output is put to stdout. Default is 2.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``debug_solver``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Controls whether the libsolv debug files should be created when solving the
|
|
Packit Service |
21c75c |
transaction. The debug files are created in the `./debugdata` directory.
|
|
Packit Service |
21c75c |
Default is ``False``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _defaultyes-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``defaultyes``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
If enabled the default answer to user confirmation prompts will be ``Yes``. Not
|
|
Packit Service |
21c75c |
to be confused with :ref:`assumeyes <assumeyes-label>` which will not prompt at all. Default is ``False``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``diskspacecheck``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Controls wheather rpm shoud check available disk space during the transaction.
|
|
Packit Service |
21c75c |
Default is ``True``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``errorlevel``
|
|
Packit Service |
21c75c |
:ref:`integer <integer-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Error messages output level, in the range 0 to 10. The higher the number the
|
|
Packit Service |
21c75c |
more error output is put to stderr. Default is 3. This is deprecated in DNF
|
|
Packit Service |
21c75c |
and overwritten by \-\ :ref:`-verbose <verbose_options-label>` commandline
|
|
Packit Service |
21c75c |
option.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``exit_on_lock``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Should the dnf client exit immediately when something else has the lock. Default is ``False``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``gpgkey_dns_verification``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Should the dnf attempt to automatically verify GPG verification keys using the DNS
|
|
Packit Service |
21c75c |
system. This option requires libunbound to be installed on the client system. This
|
|
Packit Service |
21c75c |
system has two main features. The first one is to check if any of the already
|
|
Packit Service |
21c75c |
installed keys have been revoked. Automatic removal of the key is not yet available,
|
|
Packit Service |
21c75c |
so it is up to the user, to remove revoked keys from the system. The second feature is
|
|
Packit Service |
21c75c |
automatic verification of new keys when a repository is added to the system. In
|
|
Packit Service |
21c75c |
interactive mode, the result is written to the output as a suggestion to the user. In
|
|
Packit Service |
21c75c |
non-interactive mode (i.e. when -y is used), this system will automatically accept
|
|
Packit Service |
21c75c |
keys that are available in the DNS and are correctly signed using DNSSEC. It will also
|
|
Packit Service |
21c75c |
accept keys that do not exist in the DNS system and their NON-existence is
|
|
Packit Service |
21c75c |
cryptographically proven using DNSSEC. This is mainly to preserve backward
|
|
Packit Service |
21c75c |
compatibility.
|
|
Packit Service |
21c75c |
Default is ``False``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``group_package_types``
|
|
Packit Service |
21c75c |
:ref:`list <list-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
List of the following: optional, default, mandatory. Tells dnf which type of packages in groups will
|
|
Packit Service |
21c75c |
be installed when 'groupinstall' is called. Default is: ``default, mandatory``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _ignorearch-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``ignorearch``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
If set to ``True``, RPM will allow attempts to install packages incompatible with the CPU's
|
|
Packit Service |
21c75c |
architecture. Defaults to ``False``. Often used together with
|
|
Packit Service |
21c75c |
:ref:`arch <arch-label>` option.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _installonlypkgs-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``installonlypkgs``
|
|
Packit Service |
21c75c |
:ref:`list <list-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
List of provide names of packages that should only ever be installed, never
|
|
Packit Service |
21c75c |
upgraded. Kernels in particular fall into this category.
|
|
Packit Service |
21c75c |
These packages are never removed by ``dnf autoremove`` even if they were
|
|
Packit Service |
21c75c |
installed as dependencies (see
|
|
Packit Service |
21c75c |
:ref:`clean_requirements_on_remove <clean_requirements_on_remove-label>`
|
|
Packit Service |
21c75c |
for auto removal details).
|
|
Packit Service |
21c75c |
This option append the list values to the default installonlypkgs list used
|
|
Packit Service |
21c75c |
by DNF. The number of kept package versions is regulated
|
|
Packit Service |
21c75c |
by :ref:`installonly_limit <installonly-limit-label>`.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _installonly-limit-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``installonly_limit``
|
|
Packit Service |
21c75c |
:ref:`integer <integer-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Number of :ref:`installonly packages <installonlypkgs-label>` allowed to be installed
|
|
Packit Service |
21c75c |
concurrently. Defaults to 3. The minimal number of installonly packages is 2. Value 0 or 1 means
|
|
Packit Service |
21c75c |
unlimited number of installonly packages.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``installroot``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The root of the filesystem for all packaging operations. It requires an absolute path. See also :ref:`--installroot commandline option <installroot-label>`.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``install_weak_deps``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
When this option is set to True and a new package is about to be
|
|
Packit Service |
21c75c |
installed, all packages linked by weak dependency relation (Recommends or Supplements flags) with this package will be pulled into the transaction.
|
|
Packit Service |
21c75c |
Default is ``True``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _keepcache-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``keepcache``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Keeps downloaded packages in the cache when set to True. Even if it is set to False and packages have not been
|
|
Packit Service |
21c75c |
installed they will still persist until next successful transaction. The default
|
|
Packit Service |
21c75c |
is ``False``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``logdir``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Directory where the log files will be stored. Default is ``/var/log``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``logfilelevel``
|
|
Packit Service |
21c75c |
:ref:`integer <integer-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Log file messages output level, in the range 0 to 10. The higher the number the
|
|
Packit Service |
21c75c |
more debug output is put to logs. Default is 9.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
This option controls dnf.log, dnf.librepo.log and hawkey.log. Although dnf.librepo.log
|
|
Packit Service |
21c75c |
and hawkey.log are affected only by setting the logfilelevel to 10.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``log_compress``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
When set to ``True``, log files are compressed when they are rotated. Default is ``False``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _log_rotate-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``log_rotate``
|
|
Packit Service |
21c75c |
:ref:`integer <integer-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Log files are rotated ``log_rotate`` times before being removed. If ``log_rotate``
|
|
Packit Service |
21c75c |
is ``0``, the rotation is not performed.
|
|
Packit Service |
21c75c |
Default is ``4``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _log_size-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``log_size``
|
|
Packit Service |
21c75c |
storage size
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Log files are rotated when they grow bigger than log_size bytes. If
|
|
Packit Service |
21c75c |
log_size is 0, the rotation is not performed. The default is 1 MB. Valid
|
|
Packit Service |
21c75c |
units are 'k', 'M', 'G'.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The size applies for individual log files, not the sum of all log files.
|
|
Packit Service |
21c75c |
See also :ref:`log_rotate <log_rotate-label>`.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _metadata_timer_sync-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``metadata_timer_sync``
|
|
Packit Service |
21c75c |
time in seconds
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The minimal period between two consecutive ``makecache timer`` runs. The
|
|
Packit Service |
21c75c |
command will stop immediately if it's less than this time period since its
|
|
Packit Service |
21c75c |
last run. Does not affect simple ``makecache`` run. Use ``0`` to completely
|
|
Packit Service |
21c75c |
disable automatic metadata synchronizing. The default corresponds to three
|
|
Packit Service |
21c75c |
hours. The value is rounded to the next commenced hour.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _module_platform_id-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``module_platform_id``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Set this to $name:$stream to override PLATFORM_ID detected from ``/etc/os-release``.
|
|
Packit Service |
21c75c |
It is necessary to perform a system upgrade and switch to a new platform.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``multilib_policy``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Controls how multilib packages are treated during install operations. Can either be ``"best"`` (the default) for the depsolver to prefer packages which best match the system's architecture, or ``"all"`` to install all available packages with compatible architectures.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _obsoletes_conf_option-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``obsoletes``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
This option only has affect during an install/update. It enables
|
|
Packit Service |
21c75c |
dnf's obsoletes processing logic, which means it makes dnf check whether
|
|
Packit Service |
21c75c |
any dependencies of given package are no longer required and removes them.
|
|
Packit Service |
21c75c |
Useful when doing distribution level upgrades.
|
|
Packit Service |
21c75c |
Default is 'true'.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Command-line option: :ref:`--obsoletes <obsoletes_option-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``persistdir``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Directory where DNF stores its persistent data between runs. Default is ``"/var/lib/dnf"``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``pluginconfpath``
|
|
Packit Service |
21c75c |
:ref:`list <list-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
List of directories that are searched for plugin configurations to load. All
|
|
Packit Service |
21c75c |
configuration files found in these directories, that are named same as a
|
|
Packit Service |
21c75c |
plugin, are parsed. The default path is ``/etc/dnf/plugins``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _pluginpath-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``pluginpath``
|
|
Packit Service |
21c75c |
:ref:`list <list-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
List of directories that are searched for plugins to load. Plugins found in *any of the directories* in this configuration option are used. The default contains a Python version-specific path.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``plugins``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Controls whether the plugins are enabled. Default is ``True``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``protected_packages``
|
|
Packit Service |
21c75c |
:ref:`list <list-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
List of packages that DNF should never completely remove. They are protected via Obsoletes as well as user/plugin removals.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The default is: ``dnf``, ``glob:/etc/yum/protected.d/*.conf`` and ``glob:/etc/dnf/protected.d/*.conf``. So any packages which should be protected can do so by including a file in ``/etc/dnf/protected.d`` with their package name in it.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
DNF will protect also the package corresponding to the running version of the kernel. See also :ref:`protect_running_kernel <protect_running_kernel-label>` option.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _protect_running_kernel-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``protect_running_kernel``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Controls whether the package corresponding to the running version of kernel is protected from removal. Default is ``True``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``releasever``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Used for substitution of ``$releasever`` in the repository configuration.
|
|
Packit Service |
21c75c |
See also :ref:`repo variables <repo-variables-label>`.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _reposdir-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``reposdir``
|
|
Packit Service |
21c75c |
:ref:`list <list-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
DNF searches for repository configuration files in the paths specified by
|
|
Packit Service |
21c75c |
``reposdir``. The behavior of ``reposdir`` could differ when it is used
|
|
Packit Service |
21c75c |
along with \-\ :ref:`-installroot <installroot-label>` option.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``rpmverbosity``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
RPM debug scriptlet output level. One of: ``critical``, ``emergency``,
|
|
Packit Service |
21c75c |
``error``, ``warn``, ``info`` or ``debug``. Default is ``info``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _strict-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``strict``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
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.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``tsflags``
|
|
Packit Service |
21c75c |
:ref:`list <list-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
List of strings adding extra flags for the RPM transaction.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
============ ===========================
|
|
Packit Service |
21c75c |
tsflag value RPM Transaction Flag
|
|
Packit Service |
21c75c |
============ ===========================
|
|
Packit Service |
21c75c |
noscripts RPMTRANS_FLAG_NOSCRIPTS
|
|
Packit Service |
21c75c |
test RPMTRANS_FLAG_TEST
|
|
Packit Service |
21c75c |
notriggers RPMTRANS_FLAG_NOTRIGGERS
|
|
Packit Service |
21c75c |
nodocs RPMTRANS_FLAG_NODOCS
|
|
Packit Service |
21c75c |
justdb RPMTRANS_FLAG_JUSTDB
|
|
Packit Service |
21c75c |
nocontexts RPMTRANS_FLAG_NOCONTEXTS
|
|
Packit Service |
21c75c |
nocaps RPMTRANS_FLAG_NOCAPS
|
|
Packit Service |
21c75c |
nocrypto RPMTRANS_FLAG_NOFILEDIGEST
|
|
Packit Service |
21c75c |
============ ===========================
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The ``nocrypto`` option will also set the ``_RPMVSF_NOSIGNATURES`` and
|
|
Packit Service |
21c75c |
``_RPMVSF_NODIGESTS`` VS flags. The ``test`` option provides a transaction check
|
|
Packit Service |
21c75c |
without performing the transaction. It includes downloading of packages, gpg keys check
|
|
Packit Service |
21c75c |
(including permanent import of additional keys if necessary), and rpm check to prevent
|
|
Packit Service |
21c75c |
file conflicts.
|
|
Packit Service |
21c75c |
The ``nocaps`` is supported with rpm-4.14 or later. When ``nocaps`` is used but rpm
|
|
Packit Service |
21c75c |
doesn't support it, DNF only reports it as an invalid tsflag.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``upgrade_group_objects_upgrade``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Set this to False to disable the automatic running of ``group upgrade`` when running the ``upgrade`` command. Default is ``True`` (perform the operation).
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _varsdir_options-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``varsdir``
|
|
Packit Service |
21c75c |
:ref:`list <list-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
List of directories where variables definition files are looked for. Defaults to
|
|
Packit Service |
21c75c |
``"/etc/dnf/vars", "/etc/yum/vars"``. See :ref:`variable files <varfiles-label>`
|
|
Packit Service |
21c75c |
in Configuration reference.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _conf_repo_options-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``zchunk``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Enables or disables the use of repository metadata compressed using the zchunk format (if available). Default is ``True``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _conf_main_options-colors-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
=========================
|
|
Packit Service |
21c75c |
[main] Options - Colors
|
|
Packit Service |
21c75c |
=========================
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Controls if DNF uses colored output on the command line.
|
|
Packit Service |
21c75c |
Possible values: "auto", "never", "always". Default is "auto".
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color_list_available_downgrade``
|
|
Packit Service |
21c75c |
:ref:`color <color-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Color of available packages that are older than installed packages.
|
|
Packit Service |
21c75c |
The option is used during list operations.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color_list_available_install``
|
|
Packit Service |
21c75c |
:ref:`color <color-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Color of packages that are available for installation and none of their versions in installed.
|
|
Packit Service |
21c75c |
The option is used during list operations.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color_list_available_reinstall``
|
|
Packit Service |
21c75c |
:ref:`color <color-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Color of available packages that are identical to installed versions and are available for reinstalls.
|
|
Packit Service |
21c75c |
The option is used during list operations.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color_list_available_upgrade``
|
|
Packit Service |
21c75c |
:ref:`color <color-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Color of available packages that are newer than installed packages.
|
|
Packit Service |
21c75c |
The option is used during list operations.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color_list_installed_extra``
|
|
Packit Service |
21c75c |
:ref:`color <color-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Color of installed packages that do not have any version among available packages.
|
|
Packit Service |
21c75c |
The option is used during list operations.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color_list_installed_newer``
|
|
Packit Service |
21c75c |
:ref:`color <color-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Color of installed packages that are newer than any version among available packages.
|
|
Packit Service |
21c75c |
The option is used during list operations.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color_list_installed_older``
|
|
Packit Service |
21c75c |
:ref:`color <color-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Color of installed packages that are older than any version among available packages.
|
|
Packit Service |
21c75c |
The option is used during list operations.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color_list_installed_reinstall``
|
|
Packit Service |
21c75c |
:ref:`color <color-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Color of installed packages that are among available packages and can be reinstalled.
|
|
Packit Service |
21c75c |
The option is used during list operations.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color_search_match``
|
|
Packit Service |
21c75c |
:ref:`color <color-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Color of patterns matched in search output.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color_update_installed``
|
|
Packit Service |
21c75c |
:ref:`color <color-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Color of removed packages.
|
|
Packit Service |
21c75c |
This option is used during displaying transactions.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color_update_local``
|
|
Packit Service |
21c75c |
:ref:`color <color-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Color of local packages that are installed from the @commandline repository.
|
|
Packit Service |
21c75c |
This option is used during displaying transactions.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color_update_remote``
|
|
Packit Service |
21c75c |
:ref:`color <color-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Color of packages that are installed/upgraded/downgraded from remote repositories.
|
|
Packit Service |
21c75c |
This option is used during displaying transactions.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
==============
|
|
Packit Service |
21c75c |
Repo Options
|
|
Packit Service |
21c75c |
==============
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _baseurl-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``baseurl``
|
|
Packit Service |
21c75c |
:ref:`list <list-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
List of URLs for the repository. Defaults to ``[]``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _repo_cost-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``cost``
|
|
Packit Service |
21c75c |
:ref:`integer <integer-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The relative cost of accessing this repository, defaulting to 1000. This
|
|
Packit Service |
21c75c |
value is compared when the priorities of two repositories are the same. The
|
|
Packit Service |
21c75c |
repository with *the lowest cost* is picked. It is useful to make the
|
|
Packit Service |
21c75c |
library prefer on-disk repositories to remote ones.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``enabled``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Include this repository as a package source. The default is True.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _repo_gpgkey-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``gpgkey``
|
|
Packit Service |
21c75c |
:ref:`list <list-label>` of strings
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
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.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _metalink-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``metalink``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
URL of a metalink for the repository. Defaults to ``None``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _mirrorlist-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``mirrorlist``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
URL of a mirrorlist for the repository. Defaults to ``None``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _module_hotfixes-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``module_hotfixes``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Set this to True to disable module RPM filtering and make all RPMs from the repository available. The default is False.
|
|
Packit Service |
21c75c |
This allows user to create a repository with cherry-picked hotfixes that are included in a package set on a modular system.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _repo_name-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``name``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
A human-readable name of the repository. Defaults to the ID of the repository.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _repo_priority-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``priority``
|
|
Packit Service |
21c75c |
:ref:`integer <integer-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
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 *the lowest priority value* is picked, possibly despite being less convenient otherwise (e.g. by being a lower version).
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``type``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Type of repository metadata. Supported values are: ``rpm-md``.
|
|
Packit Service |
21c75c |
Aliases for ``rpm-md``: ``rpm``, ``repomd``, ``rpmmd``, ``yum``, ``YUM``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _repo-variables-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
================
|
|
Packit Service |
21c75c |
Repo Variables
|
|
Packit Service |
21c75c |
================
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Right side of every repo option can be enriched by the following variables:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``$arch``
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Refers to the system’s CPU architecture e.g, aarch64, i586, i686 and x86_64.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``$basearch``
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Refers to the base architecture of the system. For example, i686 and i586 machines
|
|
Packit Service |
21c75c |
both have a base architecture of i386, and AMD64 and Intel64 machines have a base architecture of x86_64.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``$releasever``
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Refers to the release version of operating system which DNF derives from information available in RPMDB.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
In addition to these hard coded variables, user-defined ones can also be used. They can be defined either via :ref:`variable files <varfiles-label>`, 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::
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
$ DNF_VAR_MY_VARIABLE=value
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
To use such variable in your repository configuration remove the prefix. E.g.::
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
[myrepo]
|
|
Packit Service |
21c75c |
baseurl=https://example.site/pub/fedora/$MY_VARIABLE/releases/$releasever
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Note that it is not possible to override the ``arch`` and ``basearch`` variables using either variable files or environmental variables.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Although users are encouraged to use named variables, the numbered environmental variables ``DNF0`` - ``DNF9`` are still supported::
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
$ DNF1=value
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
[myrepo]
|
|
Packit Service |
21c75c |
baseurl=https://example.site/pub/fedora/$DNF1/releases/$releasever
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _conf_main_and_repo_options-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
==================================
|
|
Packit Service |
21c75c |
Options for both [main] and Repo
|
|
Packit Service |
21c75c |
==================================
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Some options can be applied in either the main section, per repository, or in a
|
|
Packit Service |
21c75c |
combination. The value provided in the main section is used for all repositories
|
|
Packit Service |
21c75c |
as the default value, which repositories can then override in their
|
|
Packit Service |
21c75c |
configuration.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _bandwidth-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``bandwidth``
|
|
Packit Service |
21c75c |
storage size
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Total bandwidth available for downloading. Meaningful when used with the :ref:`throttle option <throttle-label>`. Storage size is in bytes by default but can be specified with a unit of storage. Valid units are 'k', 'M', 'G'.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``countme``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Determines whether a special flag should be added to a single, randomly
|
|
Packit Service |
21c75c |
chosen metalink/mirrorlist query each week.
|
|
Packit Service |
21c75c |
This allows the repository owner to estimate the number of systems
|
|
Packit Service |
21c75c |
consuming it, by counting such queries over a week's time, which is much
|
|
Packit Service |
21c75c |
more accurate than just counting unique IP addresses (which is subject to
|
|
Packit Service |
21c75c |
both overcounting and undercounting due to short DHCP leases and NAT,
|
|
Packit Service |
21c75c |
respectively).
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The flag is a simple "countme=N" parameter appended to the metalink and
|
|
Packit Service |
21c75c |
mirrorlist URL, where N is an integer representing the "longevity" bucket
|
|
Packit Service |
21c75c |
this system belongs to.
|
|
Packit Service |
21c75c |
The following 4 buckets are defined, based on how many full weeks have
|
|
Packit Service |
21c75c |
passed since the beginning of the week when this system was installed: 1 =
|
|
Packit Service |
21c75c |
first week, 2 = first month (2-4 weeks), 3 = six months (5-24 weeks) and 4
|
|
Packit Service |
21c75c |
= more than six months (> 24 weeks).
|
|
Packit Service |
21c75c |
This information is meant to help distinguish short-lived installs from
|
|
Packit Service |
21c75c |
long-term ones, and to gather other statistics about system lifecycle.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Default is False.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _deltarpm-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``deltarpm``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
When enabled, DNF will save bandwidth by downloading much smaller delta RPM
|
|
Packit Service |
21c75c |
files, rebuilding them to RPM locally. However, this is quite CPU and I/O
|
|
Packit Service |
21c75c |
intensive. Default is True.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``deltarpm_percentage``
|
|
Packit Service |
21c75c |
:ref:`integer <integer-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
When the relative size of delta vs pkg is larger than this, delta is not used. Default value is 75
|
|
Packit Service |
21c75c |
(Deltas must be at least 25% smaller than the pkg). Use `0` to turn off delta rpm processing. Local repositories (with
|
|
Packit Service |
21c75c |
file:// baseurl) have delta rpms turned off by default.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``enablegroups``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Determines whether DNF will allow the use of package groups for this repository. Default is True (package groups are allowed).
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _exclude-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``excludepkgs``
|
|
Packit Service |
21c75c |
:ref:`list <list-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Exclude packages of this repository, specified by a name or a glob and
|
|
Packit Service |
21c75c |
separated by a comma, from all operations.
|
|
Packit Service |
21c75c |
Can be disabled using ``--disableexcludes`` command line switch.
|
|
Packit Service |
21c75c |
Defaults to ``[]``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``fastestmirror``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
If enabled a metric is used to find the fastest available mirror. This overrides the order provided by the mirrorlist/metalink file itself. This file is often dynamically generated by the server to provide the best download speeds and enabling fastestmirror overrides this. The default is False.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _gpgcheck-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``gpgcheck``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Whether to perform GPG signature check on packages found in this repository.
|
|
Packit Service |
21c75c |
The default is False.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
This option can only be used to strengthen the active RPM security policy set with the ``%_pkgverify_level`` macro (see the ``/usr/lib/rpm/macros`` file for details).
|
|
Packit Service |
21c75c |
That means, if the macro is set to 'signature' or 'all' and this option is False, it will be overridden to True during DNF runtime, and a warning will be printed.
|
|
Packit Service |
21c75c |
To squelch the warning, make sure this option is True for every enabled repository, and also enable :ref:`localpkg_gpgcheck <localpkg_gpgcheck-label>`.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _include-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``includepkgs``
|
|
Packit Service |
21c75c |
:ref:`list <list-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Include packages of this repository, specified by a name or a glob and separated by a comma, in all operations.
|
|
Packit Service |
21c75c |
Inverse of :ref:`excludepkgs <exclude-label>`, DNF will exclude any package in the repository that doesn't match this list. This works in conjunction with ``excludepkgs`` and doesn't override it, so if you 'excludepkgs=*.i386' and 'includepkgs=python*' then only packages starting with python that do not have an i386 arch will be seen by DNF in this repo.
|
|
Packit Service |
21c75c |
Can be disabled using ``--disableexcludes`` command line switch.
|
|
Packit Service |
21c75c |
Defaults to ``[]``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _ip-resolve-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``ip_resolve``
|
|
Packit Service |
21c75c |
IP address type
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Determines how DNF resolves host names. Set this to '4'/'IPv4' or '6'/'IPv6' to resolve to IPv4 or IPv6 addresses only. By default, DNF resolves to either addresses.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _localpkg_gpgcheck-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``localpkg_gpgcheck``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Whether to perform a GPG signature check on local packages (packages in a file, not in a repository).
|
|
Packit Service |
21c75c |
The default is False.
|
|
Packit Service |
21c75c |
This option is subject to the active RPM security policy (see :ref:`gpgcheck <gpgcheck-label>` for more details).
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``max_parallel_downloads``
|
|
Packit Service |
21c75c |
:ref:`integer <integer-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Maximum number of simultaneous package downloads. Defaults to 3.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _metadata_expire-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``metadata_expire``
|
|
Packit Service |
21c75c |
time in seconds
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The period after which the remote repository is checked for metadata update and in the positive
|
|
Packit Service |
21c75c |
case the local metadata cache is updated. The default corresponds to 48 hours. Set this to
|
|
Packit Service |
21c75c |
``-1`` or ``never`` to make the repo never considered expired. Expire of metadata can bee also
|
|
Packit Service |
21c75c |
triggered by change of timestamp of configuration files (``dnf.conf``, ``<repo>.repo``). See
|
|
Packit Service |
21c75c |
also :ref:`check_config_file_age <check_config_file_age-label>`.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _minrate-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``minrate``
|
|
Packit Service |
21c75c |
storage size
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
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 :ref:`timeout option <timeout-label>` seconds, DNF aborts the connection. The default is 1000. Valid units are 'k', 'M', 'G'.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``password``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The password to use for connecting to a repository with basic HTTP authentication. Empty by default.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``proxy``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
URL of a proxy server to connect through. Set to an empty string to disable the proxy setting inherited from the main section and use direct connection instead. The expected format of this option is ``<scheme>://<ip-or-hostname>[:port]``.
|
|
Packit Service |
21c75c |
(For backward compatibility, '_none_' can be used instead of the empty string.)
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Note: The curl environment variables (such as ``http_proxy``) are effective if this option is unset. See the ``curl`` man page for details.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``proxy_username``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The username to use for connecting to the proxy server. Empty by default.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``proxy_password``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The password to use for connecting to the proxy server. Empty by default.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``proxy_auth_method``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The authentication method used by the proxy server. Valid values are
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
========== ==========================================================
|
|
Packit Service |
21c75c |
method meaning
|
|
Packit Service |
21c75c |
========== ==========================================================
|
|
Packit Service |
21c75c |
basic HTTP Basic authentication
|
|
Packit Service |
21c75c |
digest HTTP Digest authentication
|
|
Packit Service |
21c75c |
negotiate HTTP Negotiate (SPNEGO) authentication
|
|
Packit Service |
21c75c |
ntlm HTTP NTLM authentication
|
|
Packit Service |
21c75c |
digest_ie HTTP Digest authentication with an IE flavor
|
|
Packit Service |
21c75c |
ntlm_wb NTLM delegating to winbind helper
|
|
Packit Service |
21c75c |
none None auth method
|
|
Packit Service |
21c75c |
any All suitable methods
|
|
Packit Service |
21c75c |
========== ==========================================================
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Defaults to ``any``
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _repo_gpgcheck-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``repo_gpgcheck``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Whether to perform GPG signature check on this repository's metadata. The default is False.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``retries``
|
|
Packit Service |
21c75c |
:ref:`integer <integer-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Set the number of total retries for downloading packages. The number is
|
|
Packit Service |
21c75c |
accumulative, so e.g. for `retries=10`, dnf will fail after any package
|
|
Packit Service |
21c75c |
download fails for eleventh time. Setting this to `0` makes dnf try
|
|
Packit Service |
21c75c |
forever. Default is `10`.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _skip_if_unavailable-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``skip_if_unavailable``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
If enabled, DNF will continue running and disable the repository that couldn't be synchronized
|
|
Packit Service |
21c75c |
for any reason. This option doesn't affect skipping of unavailable packages after dependency
|
|
Packit Service |
21c75c |
resolution. To check inaccessibility of repository use it in combination with
|
|
Packit Service |
21c75c |
:ref:`refresh command line option <refresh_command-label>`. The default is ``False``.
|
|
Packit Service |
21c75c |
Note this option in particular :ref:`can be set in your configuration file
|
|
Packit Service |
21c75c |
by your distribution <conf_distribution_specific-label>`.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _sslcacert-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``sslcacert``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Path to the directory or file containing the certificate authorities to verify SSL certificates.
|
|
Packit Service |
21c75c |
Empty by default - uses system default.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _sslverify-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``sslverify``
|
|
Packit Service |
21c75c |
:ref:`boolean <boolean-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
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 ``False``, SSL connections can be used, but certificates are not verified. Default is ``True``.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _sslclientcert-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``sslclientcert``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Path to the SSL client certificate used to connect to remote sites.
|
|
Packit Service |
21c75c |
Empty by default.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _sslclientkey-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``sslclientkey``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Path to the SSL client key used to connect to remote sites.
|
|
Packit Service |
21c75c |
Empty by default.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _throttle-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``throttle``
|
|
Packit Service |
21c75c |
storage size
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Limits the downloading speed. It might be an absolute value or a percentage, relative to the value of the :ref:`bandwidth option <bandwidth-label>` option. ``0`` 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 'k', 'M', 'G'.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _timeout-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``timeout``
|
|
Packit Service |
21c75c |
time in seconds
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
Number of seconds to wait for a connection before timing out. Used in combination with :ref:`minrate option <minrate-label>` option. Defaults to 30 seconds.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``username``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The username to use for connecting to repo with basic HTTP authentication. Empty by default.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``user_agent``
|
|
Packit Service |
21c75c |
:ref:`string <string-label>`
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
The User-Agent string to include in HTTP requests sent by DNF.
|
|
Packit Service |
21c75c |
Defaults to ::
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
libdnf (NAME VERSION_ID; VARIANT_ID; OS.BASEARCH)
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
where NAME, VERSION_ID and VARIANT_ID are OS identifiers read from the
|
|
Packit Service |
21c75c |
:manpage:`os-release(5)` file, and OS and BASEARCH are the canonical OS
|
|
Packit Service |
21c75c |
name and base architecture, respectively.
|
|
Packit Service |
21c75c |
Example: ::
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
libdnf (Fedora 31; server; Linux.x86_64)
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
=================
|
|
Packit Service |
21c75c |
Types of Options
|
|
Packit Service |
21c75c |
=================
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _boolean-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``boolean``
|
|
Packit Service |
21c75c |
This is a data type with only two possible values.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
One of following options can be used: 1, 0, True, False, yes, no
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _integer-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``integer``
|
|
Packit Service |
21c75c |
It is a whole number that can be written without a fractional component.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _list-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``list``
|
|
Packit Service |
21c75c |
It is an option that could represent one or more strings separated by space or comma characters.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _string-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``string``
|
|
Packit Service |
21c75c |
It is a sequence of symbols or digits without any whitespace character.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _color-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``color``
|
|
Packit Service |
21c75c |
A string describing color and modifiers separated with a comma, for example "red,bold".
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
* Colors: black, blue, cyan, green, magenta, red, white, yellow
|
|
Packit Service |
21c75c |
* Modifiers: bold, blink, dim, normal, reverse, underline
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
==========
|
|
Packit Service |
21c75c |
Files
|
|
Packit Service |
21c75c |
==========
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``Cache Files``
|
|
Packit Service |
21c75c |
/var/cache/dnf
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``Main Configuration File``
|
|
Packit Service |
21c75c |
/etc/dnf/dnf.conf
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``Repository``
|
|
Packit Service |
21c75c |
/etc/yum.repos.d/
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
.. _varfiles-label:
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
``Variables``
|
|
Packit Service |
21c75c |
Any properly named file in /etc/dnf/vars is turned into a variable named after the filename (or
|
|
Packit Service |
21c75c |
overrides any of the above variables but those set from commandline). Filenames may contain only
|
|
Packit Service |
21c75c |
alphanumeric characters and underscores and be in lowercase.
|
|
Packit Service |
21c75c |
Variables are also read from /etc/yum/vars for YUM compatibility reasons.
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
==========
|
|
Packit Service |
21c75c |
See Also
|
|
Packit Service |
21c75c |
==========
|
|
Packit Service |
21c75c |
|
|
Packit Service |
21c75c |
* :manpage:`dnf(8)`, :ref:`DNF Command Reference <command_ref-label>`
|