Debian Codegraph @

upstream/mageia-cauldron/man8/dnf5-do.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-DO" "8" "May 10, 2026" "" "dnf5"
31 .SH NAME
32 dnf5-do \- Do Command
33 .SH SYNOPSIS
34 .sp
35 \fBdnf5 do [options] [arguments]\fP
36 .SH DESCRIPTION
37 .sp
38 The \fBdo\fP command is a universal command for package management in DNF5. It allows a user to define multiple
39 actions (\fBinstall\fP, \fBremove\fP, \fBupgrade\fP, \fBdowngrade\fP, and \fBreinstall\fP).
40 .sp
41 Unlike a series of specific commands (\fBinstall\fP, \fBremove\fP, \fBupgrade\fP, \fBdowngrade\fP, and \fBreinstall\fP),
42 the \fBdo\fP command handles all requested actions together and performs them in a single transaction.
43 This simplifies complex operations and makes them more efficient.
44 .sp
45 Another difference is that the \fBdo\fP command allows for the explicit specification of object types
46 in the transaction: \fBpackage\fP, \fBgroup\fP, or \fBauto\fP\&. For the \fBgroup\fP type, it is possible to specify whether
47 a group ID or a group name is used. By default, the \fBauto\fP type is active. In this mode, the \fBdo\fP command
48 behaves like other commands, inferring the object\(aqs type from its specification. For example, if a specification starts
49 with the \fB@\fP character, it is treated as a group ID or a module.
50 .sp
51 Individual actions and object types are specified by options and are combinable.
52 .sp
53 Other options have the same meaning and use as with the commands (\fBinstall\fP, \fBremove\fP, \fBupgrade\fP, \fBdowngrade\fP,
54 and \fBreinstall\fP). The exceptions are the \fB\-\-installed\-from\-repo\fP and \fB\-\-from\-repo\fP options. While they have
55 the same meaning, they only apply to the packages that follow them on the command line. Additionally, they can be
56 repeated with different values.
57 .SH OPTIONS
58 .INDENT 0.0
59 .TP
60 .B \fB\-\-action\fP
61 .nf
62 Action to be done on the following items.
63 .fi
64 .sp
65 .sp
66 This is a mandatory option that must precede the transaction\(aqs items (objects). The do command needs
67 this information to know which action to perform on the specified items.
68 Supports: \fBinstall\fP, \fBremove\fP, \fBupgrade\fP, \fBdowngrade\fP, \fBreinstall\fP\&.
69 .TP
70 .B \fB\-\-type\fP
71 .nf
72 Type of the following items.
73 .fi
74 .sp
75 .sp
76 Supports: \fBauto\fP, \fBpackage\fP, \fBgroup\fP\&. \fBauto\fP is the default until the \fBtype\fP option is used.
77 .TP
78 .B \fB\-\-allowerasing\fP
79 .nf
80 Allow removing of installed packages to resolve any potential dependency problems.
81 .fi
82 .sp
83 .TP
84 .B \fB\-\-skip\-broken\fP
85 .nf
86 Resolve any dependency problems by removing packages that are causing problems from the transaction.
87 .fi
88 .sp
89 .TP
90 .B \fB\-\-skip\-unavailable\fP
91 .nf
92 Allow skipping packages that are not available in repositories. All available packages will be installed.
93 .fi
94 .sp
95 .TP
96 .B \fB\-\-allow\-downgrade\fP
97 .nf
98 Enable downgrade of dependencies when resolving the requested operation.
99 .fi
100 .sp
101 .TP
102 .B \fB\-\-no\-allow\-downgrade\fP
103 .nf
104 Disable downgrade of dependencies when resolving the requested operation.
105 .fi
106 .sp
107 .UNINDENT
108 .INDENT 0.0
109 .TP
110 .B \fB\-\-installed\-from\-repo=REPO_ID,...\fP
111 .nf
112 Filters installed packages by the ID of the repository they were installed from.
113 .fi
114 .sp
115 .UNINDENT
116 .INDENT 0.0
117 .TP
118 .B \fB\-\-from\-repo=REPO_ID,...\fP
119 .nf
120 Packages (or their provides) explicitly specified on the command line will only be looked up in the specified repositories.
121 These repositories are automatically enabled.
122 Repository enabling and disabling still applies. Dependencies of these packages will be resolved from any enabled repository.
123 .fi
124 .sp
125 .UNINDENT
126 .INDENT 0.0
127 .TP
128 .B \fB\-\-from\-vendor=VENDOR,...\fP
129 .nf
130 List of vendors separated by commas or spaces. Globs are supported (e.g., \fB\-\-from\-vendor=\(aqFedora\e project, vendorA, vendorB*, vendorC\(aq\fP).
131 Packages (or their provides) explicitly specified on the command line will only be looked up from the specified vendors.
132 The vendor change check is \fBbypassed\fP for these packages.
133 The vendor is ignored or vendor change policies (if \fBallow_vendor_change=0\fP) will still be used for packages that satisfy dependencies.
134 .fi
135 .sp
136 .UNINDENT
137 .INDENT 0.0
138 .TP
139 .B \fB\-\-downloadonly\fP
140 .nf
141 Download the resolved package set without executing an RPM transaction.
142 .fi
143 .sp
144 .TP
145 .B \fB\-\-offline\fP
146 .nf
147 Store the transaction to be performed offline. See \fBdnf5\-offline(8)\fP, \fI\%Offline command\fP\&.
148 .fi
149 .sp
150 .UNINDENT
151 .INDENT 0.0
152 .TP
153 .B \fB\-\-advisories=ADVISORY_NAME,...\fP
154 .nf
155 Include content contained in advisories with specified name.
156 This is a list option.
157 Expected values are advisory IDs, e.g. \fIFEDORA\-2201\-123\fP\&.
158 Any transaction command (install, upgrade) will fail with an error if there is no existing advisory in the list; this can be bypassed by using the \-\-skip\-unavailable switch.
159 .fi
160 .sp
161 .UNINDENT
162 .INDENT 0.0
163 .TP
164 .B \fB\-\-advisory\-severities=ADVISORY_SEVERITY,...\fP
165 .nf
166 Include content contained in advisories with specified severity.
167 This is a list option.
168 Accepted values are: \fIcritical\fP, \fIimportant\fP, \fImoderate\fP, \fIlow\fP, \fInone\fP\&.
169 .fi
170 .sp
171 .UNINDENT
172 .INDENT 0.0
173 .TP
174 .B \fB\-\-bzs=BUGZILLA_ID,...\fP
175 .nf
176 Include content contained in advisories that fix a ticket of the given Bugzilla ID.
177 This is a list option.
178 Expected values are numeric IDs, e.g. \fI123123\fP\&.
179 Any transaction command (install, upgrade) will fail with an error if there is no advisory fixing the given ticket; this can be bypassed by using the \-\-skip\-unavailable switch.
180 .fi
181 .sp
182 .UNINDENT
183 .INDENT 0.0
184 .TP
185 .B \fB\-\-cves=CVE_ID,...\fP
186 .nf
187 Include content contained in advisories that fix a ticket of the given CVE (Common Vulnerabilities and Exposures) ID.
188 This is a list option.
189 Expected values are string IDs in CVE format, e.g. \fICVE\-2201\-0123\fP\&.
190 Any transaction command (install, upgrade) will fail with an error if there is no advisory fixing the given ticket; this can be bypassed by using the \-\-skip\-unavailable switch.
191 .fi
192 .sp
193 .UNINDENT
194 .INDENT 0.0
195 .TP
196 .B \fB\-\-security\fP
197 .nf
198 Include content contained in security advisories.
199 .fi
200 .sp
201 .UNINDENT
202 .INDENT 0.0
203 .TP
204 .B \fB\-\-bugfix\fP
205 .nf
206 Include content contained in bugfix advisories.
207 .fi
208 .sp
209 .UNINDENT
210 .INDENT 0.0
211 .TP
212 .B \fB\-\-enhancement\fP
213 .nf
214 Include content contained in enhancement advisories.
215 .fi
216 .sp
217 .UNINDENT
218 .INDENT 0.0
219 .TP
220 .B \fB\-\-newpackage\fP
221 .nf
222 Include content contained in newpackage advisories.
223 .fi
224 .sp
225 .UNINDENT
226 .SH EXAMPLES
227 .INDENT 0.0
228 .TP
229 .B \fBdnf5 do \-\-action=install tito\fP
230 Install the \fBtito\fP package.
231 .TP
232 .B \fBdnf5 do \-\-action=remove sddm\-wayland\-plasma \-\-action=install sddm\-x11\fP
233 Replace package \fBsddm\-wayland\-plasma\fP with \fBsddm\-x11\fP\&.
234 .TP
235 .B \fBdnf5 do \-\-action=install \-\-type=group id=office \(aqname=Games and Entertainment\(aq \-\-type=package iftop \-\-action=remove atop\fP
236 Install the \fBoffice\fP group (by ID), the \fBGames and Entertainment\fP group (by name), and the \fBiftop\fP package,
237 and remove the \fBatop\fP package.
238 .TP
239 .B \fBdnf5 do \-\-action=install pkg \-\-from\-repo=myrepo1 pkg1 \-\-from\-repo=myrepo2 pkg2 \-\-action=remove \-\-installed\-from\-repo=compromised_repo \(aq*\(aq\fP
240 Install the \fBpkg\fP package from any enabled repository, as well as package \fBpkg1\fP from the \fBmyrepo1\fP
241 repository and package \fBpkg2\fP from the \fBmyrepo2\fP repository. Dependencies for these packages are installed
242 from any enabled repository. Additionally, remove all packages installed from the \fBcompromised_repo\fP\&.
243 .UNINDENT
244 .SH SEE ALSO
245 .INDENT 0.0
246 .INDENT 3.5
247 .nf
248 \fBdnf5\-install(8)\fP, \fI\%Install command\fP
249 \fBdnf5\-remove(8)\fP, \fI\%Remove command\fP
250 \fBdnf5\-upgrade(8)\fP, \fI\%Upgrade command\fP
251 \fBdnf5\-downgrade(8)\fP, \fI\%Downgrade command\fP
252 \fBdnf5\-reinstall(8)\fP, \fI\%Reinstall command\fP
253 \fBdnf5\-advisory(8)\fP, \fI\%Advisory command\fP
254 \fBdnf5\-specs(7)\fP, \fI\%Patterns specification\fP
255 .fi
256 .sp
257 .UNINDENT
258 .UNINDENT
259 .SH AUTHOR
260 See AUTHORS.md in dnf5 source distribution.
261 .SH COPYRIGHT
262 Contributors to the dnf5 project.
263 .\" Generated by docutils manpage writer.
264 .