Debian Codegraph @

upstream/mageia-cauldron/man8/dnf5-environment.8

raw
1 .\" Man page generated from reStructuredText.
2 .
3 .
4 .nr rst2man-indent-level 0
5 .
6 .de1 rstReportMargin
7 \\$1 \\n[an-margin]
8 level \\n[rst2man-indent-level]
9 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
10 -
11 \\n[rst2man-indent0]
12 \\n[rst2man-indent1]
13 \\n[rst2man-indent2]
14 ..
15 .de1 INDENT
16 .\" .rstReportMargin pre:
17 . RS \\$1
18 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
19 . nr rst2man-indent-level +1
20 .\" .rstReportMargin post:
21 ..
22 .de UNINDENT
23 . RE
24 .\" indent \\n[an-margin]
25 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
26 .nr rst2man-indent-level -1
27 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
28 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
29 ..
30 .TH "DNF5-ENVIRONMENT" "8" "May 10, 2026" "" "dnf5"
31 .SH NAME
32 dnf5-environment \- Environment Command
33 .SH SYNOPSIS
34 .sp
35 \fBdnf5 environment {list|info} [options] [<environment\-spec>...]\fP
36 .sp
37 \fBdnf5 environment {install|remove|upgrade} [options] <group\-spec|environment\-spec>...\fP
38 .SH DESCRIPTION
39 .sp
40 The \fBenvironment\fP command in \fBDNF5\fP offers several queries for getting information
41 about environments and groups related to them and it is also used for environment installation.
42 To query groups, use separate \fBgroup\fP command.
43 .sp
44 Optional \fBenvironment\-spec\fP arguments can be passed to filter environments with given IDs or names.
45 The install, remove and upgrade commands take both \fBenvironment\-spec\fP and \fBgroup\-spec\fP, but in case
46 both environments and groups match, only environments are affected.
47 .SH SUBCOMMANDS
48 .INDENT 0.0
49 .TP
50 .B \fBlist\fP
51 List all matching environments, either among installed or available environments. If
52 nothing is specified, list all known environments. \fB\-\-installed\fP and \fB\-\-available\fP
53 options narrow down the requested list.
54 .TP
55 .B \fBinfo\fP
56 Print detailed information about environments.
57 The command accepts the same options as the \fBlist\fP subcommand.
58 .TP
59 .B \fBinstall\fP
60 Mark the specified environments or groups installed and install groups and packages they
61 contain.
62 .sp
63 If an environments or group is already (partially) installed, the command installs the
64 missing groups and packages it contains.
65 .sp
66 In case both groups and environments match, only environments are affected.
67 .sp
68 If the \fB\-\-with\-optional\fP option is used, also include \fBOptional\fP packages of groups. By default,
69 all \fBMandatory\fP and \fBDefault\fP packages will be installed whenever possible. \fBConditional\fP
70 packages are installed if they meet their requirement. This can be configured by
71 \fBdnf5.conf(5)\fP, \fI\%group_package_types\fP\&.
72 .sp
73 If the \fB\-\-no\-packages\fP option is used, no packages will be installed by this command.
74 Only currently installed group packages are considered to be installed with the groups.
75 .TP
76 .B \fBremove\fP
77 Mark the specified environments or groups removed and remove groups and packages they contain
78 unless they belong to another installed environment or group, were installed explicitly by the
79 user or (in case of packages) were installed as a dependency.
80 .sp
81 In case both groups and environments match, only environments are affected.
82 .sp
83 If the \fB\-\-no\-packages\fP option is used, no packages will be removed by this command.
84 .TP
85 .B \fBupgrade\fP
86 Upgrade a definition of the specified environments and groups and the groups and packages they
87 contain. If new groups or packages have been added to the current definitions since the
88 environments or groups were installed, the new groups and packages will be installed. Likewise,
89 if some groups or packages have been removed from the definition, they will be removed
90 unless they were installed for a different reason (belong to another installed environment or
91 group, were installed explicitly by the user or were installed as a dependency).
92 .sp
93 In case both groups and environments match, only environments are affected.
94 .UNINDENT
95 .SH OPTIONS FOR LIST AND INFO
96 .INDENT 0.0
97 .TP
98 .B \fB\-\-available\fP
99 .nf
100 Show only available environments. Those which are not installed, but known to \fBDNF5\fP\&.
101 .fi
102 .sp
103 .TP
104 .B \fB\-\-installed\fP
105 .nf
106 Show only installed environments.
107 .fi
108 .sp
109 .UNINDENT
110 .SH OPTIONS FOR INSTALL, REMOVE AND UPGRADE
111 .INDENT 0.0
112 .TP
113 .B \fB\-\-with\-optional\fP
114 .nf
115 Include optional packages from the groups.
116 Used with \fBinstall\fP command.
117 .fi
118 .sp
119 .TP
120 .B \fB\-\-no\-packages\fP
121 .nf
122 Operate exclusively on the environments and groups without manipulating any packages.
123 Used with \fBinstall\fP and \fBremove\fP commands.
124 .fi
125 .sp
126 .TP
127 .B \fB\-\-allowerasing\fP
128 .nf
129 Allow removing of installed packages to resolve any potential dependency problems.
130 Used with \fBinstall\fP and \fBupgrade\fP commands.
131 .fi
132 .sp
133 .TP
134 .B \fB\-\-skip\-broken\fP
135 .nf
136 Resolve any dependency problems by removing packages that are causing problems from the transaction.
137 Used with \fBinstall\fP command.
138 .fi
139 .sp
140 .TP
141 .B \fB\-\-skip\-unavailable\fP
142 .nf
143 Allow skipping packages that are not possible to install or upgrade.
144 Used with \fBinstall\fP and \fBupgrade\fP commands.
145 .fi
146 .sp
147 .TP
148 .B \fB\-\-allow\-downgrade\fP
149 .nf
150 Enable downgrade of dependencies when resolving the requested operation.
151 Used with \fBinstall\fP and \fBupgrade\fP commands.
152 .fi
153 .sp
154 .TP
155 .B \fB\-\-no\-allow\-downgrade\fP
156 .nf
157 Disable downgrade of dependencies when resolving the requested operation.
158 Used with \fBinstall\fP and \fBupgrade\fP commands.
159 .fi
160 .sp
161 .TP
162 .B \fB\-\-downloadonly\fP
163 .nf
164 Download the resolved package set without executing an RPM transaction.
165 Used with \fBinstall\fP and \fBupgrade\fP commands.
166 .fi
167 .sp
168 .UNINDENT
169 .INDENT 0.0
170 .TP
171 .B \fB\-\-offline\fP
172 .nf
173 Store the transaction to be performed offline. See \fI\%offline command\fP, \fBdnf5\-offline(8)\fP\&.
174 .fi
175 .sp
176 .TP
177 .B \fB\-\-store=PATH\fP
178 .nf
179 Store the current transaction in a directory at the specified \fBPATH\fP instead of running it.
180 The stored transaction can be performed by the \fI\%replay command\fP, \fBdnf5\-replay(8)\fP\&.
181 Note that repository ids in the stored transaction are mangled to \fB@stored_transaction(repo_id)\fP this is required
182 because during replaying the stored repositories are recreated and they might collide with already present repositories
183 (this doesn\(aqt apply to the special @System repository).
184 .fi
185 .sp
186 .UNINDENT
187 .SH EXAMPLES
188 .INDENT 0.0
189 .TP
190 .B \fBdnf5 environment list\fP
191 .nf
192 Show list of all environments.
193 .fi
194 .sp
195 .TP
196 .B \fBdnf5 environment info \(dqKDE Plasma Workspaces\(dq\fP
197 .nf
198 Show detailed info about the \fBKDE\fP environment.
199 .fi
200 .sp
201 .UNINDENT
202 .SH SEE ALSO
203 .INDENT 0.0
204 .INDENT 3.5
205 .nf
206 \fBdnf5\-comps(7)\fP, \fI\%Comps groups and environments\fP
207 \fBdnf5\-specs(7)\fP, \fI\%Patterns specification\fP
208 .fi
209 .sp
210 .UNINDENT
211 .UNINDENT
212 .SH AUTHOR
213 See AUTHORS.md in dnf5 source distribution.
214 .SH COPYRIGHT
215 Contributors to the dnf5 project.
216 .\" Generated by docutils manpage writer.
217 .