| 1 |
.\" Man page generated from reStructuredText |
| 2 |
.\" by the Docutils 0.22.4 manpage writer. |
| 3 |
. |
| 4 |
. |
| 5 |
.nr rst2man-indent-level 0 |
| 6 |
. |
| 7 |
.de1 rstReportMargin |
| 8 |
\\$1 \\n[an-margin] |
| 9 |
level \\n[rst2man-indent-level] |
| 10 |
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| 11 |
- |
| 12 |
\\n[rst2man-indent0] |
| 13 |
\\n[rst2man-indent1] |
| 14 |
\\n[rst2man-indent2] |
| 15 |
.. |
| 16 |
.de1 INDENT |
| 17 |
.\" .rstReportMargin pre: |
| 18 |
. RS \\$1 |
| 19 |
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] |
| 20 |
. nr rst2man-indent-level +1 |
| 21 |
.\" .rstReportMargin post: |
| 22 |
.. |
| 23 |
.de UNINDENT |
| 24 |
. RE |
| 25 |
.\" indent \\n[an-margin] |
| 26 |
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| 27 |
.nr rst2man-indent-level -1 |
| 28 |
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| 29 |
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u |
| 30 |
.. |
| 31 |
.TH "DNF5-FILTERING" "7" "May 09, 2026" "" "dnf5" |
| 32 |
.SH NAME |
| 33 |
dnf5-filtering \- Packages Filtering |
| 34 |
.SH DESCRIPTION |
| 35 |
.sp |
| 36 |
Package filtering removes packages from the available package set, making them invisible to most \fBDNF5\fP commands. As a result, these packages cannot be included in any transaction. |
| 37 |
.sp |
| 38 |
There are several ways a package can be filtered out: |
| 39 |
.SH GLOBAL EXCLUDES FILTERING |
| 40 |
.sp |
| 41 |
Exclude filtering can be adjusted using the \fBincludepkgs\fP or \fBexcludepkgs\fP configuration options in the DNF5 configuration file. To disable excludes, you can use the \fBdisable_excludes\fP configuration option: |
| 42 |
.sp |
| 43 |
\fBdnf5 \-\-setopt=disable_excludes=* install bash\fP |
| 44 |
.sp |
| 45 |
For details about the configuration options see \fBdnf5.conf(5)\fP, DNF5 configuration reference \%<#\:dnf5-conf-label>\&. |
| 46 |
.SH REPOSITORY EXCLUDES FILTERING |
| 47 |
.sp |
| 48 |
Similar to global excludes, but this configuration is repository\-specific and only affects packages within the repository where the excludes are set. |
| 49 |
.SH USER EXCLUDES FILTERING |
| 50 |
.sp |
| 51 |
API users have an additional option how to fine\-tune excluded packages using \fB*_user_excludes()\fP and \fB*_user_includes\fP methods of the \fBPackageSack\fP object. See \fBlibdnf5::rpm::libdnf5::rpm::PackageSack\fP\&. |
| 52 |
.SH VERSIONLOCK |
| 53 |
.sp |
| 54 |
Additionally, the versionlock functionality is implemented using excludes filtering. However, these excludes are applied only during transactional operations. |
| 55 |
For details see \fBdnf5\-versionlock(8)\fP, Versionlock command \%<#\:versionlock-command-ref-label>\&. |
| 56 |
.SH MODULAR FILTERING |
| 57 |
.sp |
| 58 |
For details on how modular filtering works please see \fBdnf5\-modularity(7)\fP, the modularity documentation \%<#\:modularity-misc-ref-label>\&. |
| 59 |
.sp |
| 60 |
With modularity, only RPM packages from \fBactive\fP module streams are included in the available package set. RPM packages from \fBinactive\fP module streams, as well as non\-modular packages with the same name or provides as a package from an \fBactive\fP module stream, are filtered out. Modular filtering is not applied to packages added from the command line, installed packages, or packages from repositories with \fBmodule_hotfixes=true\fP in their \fB\&.repo\fP file. |
| 61 |
.sp |
| 62 |
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 |
| 63 |
\fBmodule_hotfixes=true\fP in the \fB\&.repo\fP file or use \fB\-\-setopt=<repo_id>.module_hotfixes=true\fP\&. |
| 64 |
.SH Author |
| 65 |
See AUTHORS.md in dnf5 source distribution. |
| 66 |
.SH Copyright |
| 67 |
Contributors to the dnf5 project. |
| 68 |
.\" End of generated man page. |