Debian Codegraph @

upstream/debian-unstable/man8/dnf5-environment.8

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