Debian Codegraph @

upstream/debian-unstable/man7/dnf4.modularity.7

raw
1 .\" Man page generated from reStructuredText
2 .\" by the Docutils 0.22.2 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 "DNF4.MODULARITY" "7" "Oct 24, 2025" "4.24.0" "DNF"
32 .SH NAME
33 dnf4.modularity \- Modularity in DNF
34 .sp
35 \fBWarning:\fP
36 .INDENT 0.0
37 .INDENT 3.5
38 Modularity is deprecated, and functionality will be removed in a future release of DNF5.
39 .UNINDENT
40 .UNINDENT
41 .sp
42 Modularity is new way of building, organizing and delivering packages.
43 For more details see: \%<https://\:docs\:.pagure\:.org/\:modularity/>
44 .SH DEFINITIONS
45 .INDENT 0.0
46 .TP
47 .B modulemd
48 Every repository can contain \fBmodules\fP metadata with modulemd documents.
49 These documents hold metadata about modules such as \fBName\fP, \fBStream\fP or list of packages.
50 .TP
51 .B (non\-modular) package
52 Package that doesn\(aqt belong to a module.
53 .TP
54 .B modular package
55 Package that belongs to a module. It is listed in modulemd under the \fBartifacts\fP section.
56 Modular packages can be also identified by having \fB%{modularitylabel}\fP RPM header set.
57 .TP
58 .B (module) stream
59 Stream is a collection of packages, a virtual repository. It is identified with
60 \fBName\fP and \fBStream\fP from modulemd separated with colon, for example \(dqpostgresql:9.6\(dq.
61 .sp
62 Module streams can be \fBactive\fP or \fBinactive\fP\&. \fBactive\fP means the RPM
63 packages from this stream are included in the set of available packages.
64 Packages from \fBinactive\fP streams are filtered out. Streams are
65 \fBactive\fP either if marked as \fBdefault\fP or if they are explicitly
66 \fBenabled\fP by a user action. Streams that satisfy dependencies of
67 \fBdefault\fP or \fBenabled\fP streams are also considered \fBactive\fP\&. Only
68 one stream of a particular module can be \fBactive\fP at a given point in
69 time.
70 .UNINDENT
71 .SH PACKAGE FILTERING
72 .sp
73 Without modules, packages with the highest version are used by default.
74 .sp
75 Module streams can distribute packages with lower versions than available in the
76 repositories available to the operating system. To make such packages available
77 for installs and upgrades, the non\-modular packages are filtered out when their
78 name or provide matches against a modular package name from any enabled, default,
79 or dependent stream. Modular source packages will not cause non\-modular binary
80 packages to be filtered out.
81 .SS Demodularized rpms
82 .sp
83 Contains names of RPMs excluded from package filtering for particular module stream. When defined in the latest active
84 module, non\-modular RPMs with the same name or provide which were previously filtered out will reappear.
85 .SH HOTFIX REPOSITORIES
86 .sp
87 In special cases, a user wants to cherry\-pick individual packages provided outside module
88 streams and make them available on along with packages from the active streams.
89 Under normal circumstances, such packages are filtered out or rejected from getting on the system by
90 Fail\-safe mechanisms.
91 To make the system use packages from a repository regardless of their modularity,
92 specify \fBmodule_hotfixes=true\fP in the .repo file. This protects the repository from package filtering.
93 .sp
94 Please note the hotfix packages do not override module packages, they only become
95 part of available package set. It\(aqs the package \fBEpoch\fP, \fBVersion\fP and \fBRelease\fP
96 what determines if the package is the latest.
97 .SH FAIL-SAFE MECHANISMS
98 .SS Repositories with module metadata are unavailable
99 .sp
100 When a repository with module metadata is unavailable, package filtering must keep working.
101 Non\-modular RPMs must remain unavailable and must never get on the system.
102 .sp
103 This happens when:
104 .INDENT 0.0
105 .IP \(bu 2
106 user disables a repository via \fB\-\-disablerepo\fP or uses \fB\-\-repoid\fP
107 .IP \(bu 2
108 user removes a .repo file from disk
109 .IP \(bu 2
110 repository is not available and has \fBskip_if_unavailable=true\fP
111 .UNINDENT
112 .sp
113 DNF keeps copies of the latest modulemd for every active stream
114 and uses them if there\(aqs no modulemd available for the stream.
115 This keeps package filtering working correctly.
116 .sp
117 The copies are made any time a transaction is resolved and started.
118 That includes RPM transactions as well as any \fBdnf module <enable|disable|reset>\fP operations.
119 .sp
120 When the fail\-safe data is used, dnf show such modules as part of @modulefailsafe repository.
121 .SS Orphaned modular packages
122 .sp
123 All packages that are built as a part of a module have \fB%{modularitylabel}\fP RPM header set.
124 If such package becomes part of RPM transaction and cannot be associated with any available
125 modulemd, DNF prevents from getting it on the system (package is available, but cannot be
126 installed, upgraded, etc.). Packages from Hotfix repositories or Commandline repository are not
127 affected by Fail\-safe mechanisms.
128 .SH Author
129 See AUTHORS in DNF source distribution.
130 .SH Copyright
131 2012-2020, Red Hat, Licensed under GPLv2+
132 .\" End of generated man page.