Debian Codegraph @

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