Debian Codegraph @

upstream/debian-unstable/man7/dnf5-filtering.7

raw
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.