Debian Codegraph @

upstream/mageia-cauldron/man8/dnf5-upgrade.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-UPGRADE" "8" "May 10, 2026" "" "dnf5"
31 .SH NAME
32 dnf5-upgrade \- Upgrade Command
33 .SH SYNOPSIS
34 .sp
35 \fBdnf5 upgrade [options] [<package\-spec\-NPFB>|@<group\-spec>|@<environment\-spec>...]\fP
36 .SH DESCRIPTION
37 .sp
38 The \fBupgrade\fP command in \fBDNF5\fP is used for upgrading installed packages, groups or
39 environments to newer available version.
40 .sp
41 Since groups and environments are not versioned the upgrade basically means a synchronization
42 with the currently available definition. In addition group upgrade also upgrades all packages
43 the group contains and environment upgrade also upgrades all groups the environment contains.
44 .SH OPTIONS
45 .INDENT 0.0
46 .TP
47 .B \fB\-\-minimal\fP
48 .nf
49 Upgrade packages only to the lowest available versions that fix advisories of type bugfix, enhancement, security, or
50 newpackage. In case that any option limiting advisories is used it upgrades packages only to the lowest versions
51 that fix advisories matching selected advisory properties
52 .fi
53 .sp
54 .TP
55 .B \fB\-\-allowerasing\fP
56 .nf
57 Allow removing of installed packages to resolve any potential dependency problems.
58 .fi
59 .sp
60 .TP
61 .B \fB\-\-skip\-unavailable\fP
62 .nf
63 Allow skipping packages that are not possible to upgrade. All remaining packages will be upgraded.
64 .fi
65 .sp
66 .TP
67 .B \fB\-\-allow\-downgrade\fP
68 .nf
69 Enable downgrade of dependencies when resolving the requested operation.
70 .fi
71 .sp
72 .TP
73 .B \fB\-\-no\-allow\-downgrade\fP
74 .nf
75 Disable downgrade of dependencies when resolving the requested operation.
76 .fi
77 .sp
78 .TP
79 .B \fB\-\-destdir=<path>\fP
80 .nf
81 Set directory used for downloading packages to. Default location is to the current working directory.
82 Automatically sets the \fBdownloadonly\fP option.
83 .fi
84 .sp
85 .UNINDENT
86 .INDENT 0.0
87 .TP
88 .B \fB\-\-installed\-from\-repo=REPO_ID,...\fP
89 .nf
90 Filters installed packages by the ID of the repository they were installed from.
91 .fi
92 .sp
93 .UNINDENT
94 .INDENT 0.0
95 .TP
96 .B \fB\-\-from\-repo=REPO_ID,...\fP
97 .nf
98 Packages (or their provides) explicitly specified on the command line will only be looked up in the specified repositories.
99 These repositories are automatically enabled.
100 Repository enabling and disabling still applies. Dependencies of these packages will be resolved from any enabled repository.
101 .fi
102 .sp
103 .UNINDENT
104 .INDENT 0.0
105 .TP
106 .B \fB\-\-from\-vendor=VENDOR,...\fP
107 .nf
108 List of vendors separated by commas or spaces. Globs are supported (e.g., \fB\-\-from\-vendor=\(aqFedora\e project, vendorA, vendorB*, vendorC\(aq\fP).
109 Packages (or their provides) explicitly specified on the command line will only be looked up from the specified vendors.
110 The vendor change check is \fBbypassed\fP for these packages.
111 The vendor is ignored or vendor change policies (if \fBallow_vendor_change=0\fP) will still be used for packages that satisfy dependencies.
112 .fi
113 .sp
114 .UNINDENT
115 .INDENT 0.0
116 .TP
117 .B \fB\-\-downloadonly\fP
118 .nf
119 Only download packages for transaction.
120 .fi
121 .sp
122 .UNINDENT
123 .INDENT 0.0
124 .TP
125 .B \fB\-\-offline\fP
126 .nf
127 Store the transaction to be performed offline. See \fI\%offline command\fP, \fBdnf5\-offline(8)\fP\&.
128 .fi
129 .sp
130 .TP
131 .B \fB\-\-store=PATH\fP
132 .nf
133 Store the current transaction in a directory at the specified \fBPATH\fP instead of running it.
134 The stored transaction can be performed by the \fI\%replay command\fP, \fBdnf5\-replay(8)\fP\&.
135 Note that repository ids in the stored transaction are mangled to \fB@stored_transaction(repo_id)\fP this is required
136 because during replaying the stored repositories are recreated and they might collide with already present repositories
137 (this doesn\(aqt apply to the special @System repository).
138 .fi
139 .sp
140 .UNINDENT
141 .INDENT 0.0
142 .TP
143 .B \fB\-\-advisories=ADVISORY_NAME,...\fP
144 .nf
145 Include content contained in advisories with specified name.
146 This is a list option.
147 Expected values are advisory IDs, e.g. \fIFEDORA\-2201\-123\fP\&.
148 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.
149 .fi
150 .sp
151 .UNINDENT
152 .INDENT 0.0
153 .TP
154 .B \fB\-\-advisory\-severities=ADVISORY_SEVERITY,...\fP
155 .nf
156 Include content contained in advisories with specified severity.
157 This is a list option.
158 Accepted values are: \fIcritical\fP, \fIimportant\fP, \fImoderate\fP, \fIlow\fP, \fInone\fP\&.
159 .fi
160 .sp
161 .UNINDENT
162 .INDENT 0.0
163 .TP
164 .B \fB\-\-bzs=BUGZILLA_ID,...\fP
165 .nf
166 Include content contained in advisories that fix a ticket of the given Bugzilla ID.
167 This is a list option.
168 Expected values are numeric IDs, e.g. \fI123123\fP\&.
169 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.
170 .fi
171 .sp
172 .UNINDENT
173 .INDENT 0.0
174 .TP
175 .B \fB\-\-cves=CVE_ID,...\fP
176 .nf
177 Include content contained in advisories that fix a ticket of the given CVE (Common Vulnerabilities and Exposures) ID.
178 This is a list option.
179 Expected values are string IDs in CVE format, e.g. \fICVE\-2201\-0123\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\-\-security\fP
187 .nf
188 Include content contained in security advisories.
189 .fi
190 .sp
191 .UNINDENT
192 .INDENT 0.0
193 .TP
194 .B \fB\-\-bugfix\fP
195 .nf
196 Include content contained in bugfix advisories.
197 .fi
198 .sp
199 .UNINDENT
200 .INDENT 0.0
201 .TP
202 .B \fB\-\-enhancement\fP
203 .nf
204 Include content contained in enhancement advisories.
205 .fi
206 .sp
207 .UNINDENT
208 .INDENT 0.0
209 .TP
210 .B \fB\-\-newpackage\fP
211 .nf
212 Include content contained in newpackage advisories.
213 .fi
214 .sp
215 .UNINDENT
216 .SH EXAMPLES
217 .INDENT 0.0
218 .TP
219 .B \fBdnf5 upgrade\fP
220 .nf
221 Upgrade all installed packages to the newest available version.
222 .fi
223 .sp
224 .TP
225 .B \fBdnf5 upgrade tito\fP
226 .nf
227 Upgrade the \fBtito\fP package.
228 .fi
229 .sp
230 .UNINDENT
231 .SH SEE ALSO
232 .INDENT 0.0
233 .INDENT 3.5
234 .nf
235 \fBdnf5\-advisory(8)\fP, \fI\%Advisory command\fP
236 \fBdnf5\-specs(7)\fP, \fI\%Patterns specification\fP
237 .fi
238 .sp
239 .UNINDENT
240 .UNINDENT
241 .SH AUTHOR
242 See AUTHORS.md in dnf5 source distribution.
243 .SH COPYRIGHT
244 Contributors to the dnf5 project.
245 .\" Generated by docutils manpage writer.
246 .