Debian Codegraph @

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