NAME¶

dnf5-filtering - Packages Filtering

DESCRIPTION¶

Package filtering removes packages from the available package set, making them invisible to most DNF5 commands. As a result, these packages cannot be included in any transaction.

There are several ways a package can be filtered out:

GLOBAL EXCLUDES FILTERING¶

Exclude filtering can be adjusted using the includepkgs or excludepkgs configuration options in the DNF5 configuration file. To disable excludes, you can use the disable_excludes configuration option:

dnf5 --setopt=disable_excludes=* install bash

For details about the configuration options see dnf5.conf(5), DNF5 configuration reference <#dnf5-conf-label>.

REPOSITORY EXCLUDES FILTERING¶

Similar to global excludes, but this configuration is repository-specific and only affects packages within the repository where the excludes are set.

USER EXCLUDES FILTERING¶

API users have an additional option how to fine-tune excluded packages using *_user_excludes() and *_user_includes methods of the PackageSack object. See libdnf5::rpm::libdnf5::rpm::PackageSack.

VERSIONLOCK¶

Additionally, the versionlock functionality is implemented using excludes filtering. However, these excludes are applied only during transactional operations. For details see dnf5-versionlock(8), Versionlock command <#versionlock-command-ref-label>.

MODULAR FILTERING¶

For details on how modular filtering works please see dnf5-modularity(7), the modularity documentation <#modularity-misc-ref-label>.

With modularity, only RPM packages from active module streams are included in the available package set. RPM packages from inactive module streams, as well as non-modular packages with the same name or provides as a package from an active module stream, are filtered out. Modular filtering is not applied to packages added from the command line, installed packages, or packages from repositories with module_hotfixes=true in their .repo file.

Disabling of modular filtering is not recommended, because it could cause the system to get into a broken state. To disable modular filtering for a particular repository, specify module_hotfixes=true in the .repo file or use --setopt=<repo_id>.module_hotfixes=true.

Author¶

See AUTHORS.md in dnf5 source distribution.

Copyright¶

Contributors to the dnf5 project.