Debian Codegraph @

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