Debian Codegraph @

upstream/debian-unstable/man7/dnf5-changes-from-dnf4.7

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-CHANGES-FROM-DNF4" "7" "May 09, 2026" "" "dnf5"
32 .SH NAME
33 dnf5-changes-from-dnf4 \- Changes from the DNF4
34 .sp
35 This chapter describes the differences between DNF5 \%<https://\:github\:.com/\:rpm-software-management/\:dnf5> and DNF \%<https://\:github\:.com/\:rpm-software-management/\:dnf>\&.
36 .SH CHANGES ON THE CLI
37 .SS Options
38 .SS Global options scoping
39 .sp
40 Options that cannot be applied to all commands or may be applicable but have no effect are removed from general options and implemented only for related commands.
41 .sp
42 Examples: \fB\-\-best\fP, \fB\-\-no\-best\fP are only relevant to several transaction commands.
43 .SS Options renaming
44 .sp
45 Renaming boolean options to the following formats:
46 .INDENT 0.0
47 .INDENT 3.5
48 .INDENT 0.0
49 .IP \(bu 2
50 \fB\-\-<option>\fP and \fB\-\-no\-<option>\fP
51 .IP \(bu 2
52 \fB\-\-enable\-<option>\fP and \fB\-\-disable\-<option>\fP
53 .UNINDENT
54 .UNINDENT
55 .UNINDENT
56 .sp
57 The options with original names are retained for now as compatibility aliases.
58 .sp
59 Examples: \fB\-\-best\fP and \fB\-\-no\-best\fP\&.
60 .SS Strict behavior
61 .INDENT 0.0
62 .INDENT 3.5
63 .INDENT 0.0
64 .IP \(bu 2
65 Options \fB\-\-disable\-repo=REPO_ID\fP and \fB\-\-setopt=[REPO_ID.]OPTION=VALUE\fP now consistently result in an error when provided with an invalid \fBREPO_ID\fP\&.
66 .IP \(bu 2
67 The behavior is now aligned with the \fB\-\-repo=REPO_ID\fP and \fB\-\-enable\-repo=REPO_ID\fP\&.
68 .IP \(bu 2
69 The \fBstrict\fP configuration option is no longer considered, see the strict option deprecation for more information.
70 .UNINDENT
71 .UNINDENT
72 .UNINDENT
73 .SS No value separator after short options
74 .sp
75 Short options do not have a separator between the option name and the option
76 value. E.g. \fBdnf \-x package\fP is equivalent to \fBdnf \-\-exclude package\fP and
77 \fBdnf \-\-exclude=package\fP long forms. But \fBdnf \-x=package\fP means
78 \fBdnf \-\-exclude =package\fP\&.
79 .SS Changes to individual options
80 .INDENT 0.0
81 .TP
82 .B \fB\-4/\-6\fP
83 .INDENT 7.0
84 .IP \(bu 2
85 Dropped. Now only the \fBip_resolve\fP configuration option is available.
86 .UNINDENT
87 .UNINDENT
88 .INDENT 0.0
89 .TP
90 .B \fB\-\-disableexcludes\fP and \fB\-\-disableexcludepkgs\fP
91 .INDENT 7.0
92 .IP \(bu 2
93 Dropped. Now only the \fBdisable_excludes\fP configuration option is available.
94 .UNINDENT
95 .TP
96 .B \fB\-\-disable, \-\-enable\fP
97 .INDENT 7.0
98 .IP \(bu 2
99 Dropped along with the previously existing alternatives \fB\-\-set\-disabled\fP and \fB\-\-set\-enabled\fP\&.
100 .IP \(bu 2
101 Currently, this can only be achieved through the config\-manager \%<#\:config-manager-plugin-ref-label> plugin.
102 .INDENT 2.0
103 .IP \(bu 2
104 For example, to disable the \fBfedora\fP repository: \fBdnf config\-manager setopt fedora.enabled=0\fP\&.
105 .UNINDENT
106 .UNINDENT
107 .TP
108 .B \fB\-\-downloaddir\fP
109 .INDENT 7.0
110 .IP \(bu 2
111 Dropped. Now only the \fB\-\-destdir\fP is used for the \fBdownload\fP command.
112 .IP \(bu 2
113 When downloading packages using the \fBsystem\-upgrade\fP or \fBoffline\fP command, the target path construction now utilizes the configured \fBinstallroot\fP and \fBcachedir\fP options.
114 .UNINDENT
115 .TP
116 .B \fB\-e, \-\-errorlevel\fP
117 .INDENT 7.0
118 .IP \(bu 2
119 Both the \fB\-\-errorlevel\fP option and \fBerrorlevel\fP configuration option are dropped.
120 .UNINDENT
121 .TP
122 .B \fB\-\-help\-cmd\fP
123 .INDENT 7.0
124 .IP \(bu 2
125 Dropped. Now only the \fB\-h\fP or \fB\-\-help\fP options are available.
126 .UNINDENT
127 .TP
128 .B \fB\-\-installroot\fP
129 .INDENT 7.0
130 .IP \(bu 2
131 New behavior introduced to define from which place the configuration and variables are loaded.
132 .IP \(bu 2
133 See the installroot documentation \%<#\:installroot-misc-ref-label> for more information.
134 .UNINDENT
135 .TP
136 .B \fB\-\-noautoremove\fP
137 .INDENT 7.0
138 .IP \(bu 2
139 Applicable only for the \fBremove\fP command now. As a workaround for other commands, you can use \fB\-\-setopt=clean_requirements_on_remove=False\fP\&.
140 .UNINDENT
141 .TP
142 .B \fB\-\-obsoletes\fP
143 .INDENT 7.0
144 .IP \(bu 2
145 Dropped. Now only the \fBobsoletes\fP configuration option is available.
146 .UNINDENT
147 .TP
148 .B \fB\-R, \-\-randomwait\fP
149 .INDENT 7.0
150 .IP \(bu 2
151 Dropped.
152 .UNINDENT
153 .TP
154 .B \fB\-\-rpmverbosity\fP
155 .INDENT 7.0
156 .IP \(bu 2
157 Dropped. Now only the \fBrpmverbosity\fP configuration option is available.
158 .UNINDENT
159 .TP
160 .B \fB\-\-sec\-severity\fP
161 .INDENT 7.0
162 .IP \(bu 2
163 Renamed to \fB\-\-advisory\-severities\fP\&.
164 .UNINDENT
165 .TP
166 .B \fB\-v, \-\-verbose\fP
167 .INDENT 7.0
168 .IP \(bu 2
169 Not implemented at present. May be added for specific commands in the future.
170 .UNINDENT
171 .TP
172 .B \fB\-\-version\fP
173 .INDENT 7.0
174 .IP \(bu 2
175 Behavior is different now. See the main man page \%<#\:version-option-ref-label> for more details.
176 .UNINDENT
177 .UNINDENT
178 .SS Newly introduced options
179 .INDENT 0.0
180 .TP
181 .B \fB\-\-allow\-downgrade\fP
182 .INDENT 7.0
183 .IP \(bu 2
184 Along with \fB\-\-no\-allow\-downgrade\fP, these options enable/disable the downgrade of dependencies when resolving transactions.
185 .IP \(bu 2
186 New respective configuration options have also been created.
187 .IP \(bu 2
188 Applicable to \fBinstall\fP, \fBupgrade\fP, and related commands.
189 .UNINDENT
190 .TP
191 .B \fB\-\-dump\-main\-config\fP
192 .INDENT 7.0
193 .IP \(bu 2
194 Along with related \fB\-\-dump\-repo\-config=REPO_ID\fP, these are new options to print configuration values on the standard output.
195 .UNINDENT
196 .TP
197 .B \fB\-\-offline\fP
198 .INDENT 7.0
199 .IP \(bu 2
200 Store the transaction to be performed offline.
201 .IP \(bu 2
202 Applicable to all relevant transactional commands.
203 .IP \(bu 2
204 See the Offline command \%<#\:offline-command-ref-label> for more information.
205 .UNINDENT
206 .TP
207 .B \fB\-\-show\-new\-leaves\fP
208 .INDENT 7.0
209 .IP \(bu 2
210 Show newly installed leaf packages and packages that became leaves after a transaction.
211 .UNINDENT
212 .TP
213 .B \fB\-\-skip\-unavailable\fP
214 .INDENT 7.0
215 .IP \(bu 2
216 Allow skipping packages that are not available in repositories.
217 .IP \(bu 2
218 Not to be confused with the skip_if_unavailable \%<#\:skip-if-unavailable-options-label> configuration option.
219 .IP \(bu 2
220 Applicable to \fBinstall\fP, \fBupgrade\fP, and related commands.
221 .IP \(bu 2
222 See also the strict option deprecation for more information.
223 .UNINDENT
224 .TP
225 .B \fB\-\-use\-host\-config\fP
226 .INDENT 7.0
227 .IP \(bu 2
228 See the main man page \%<#\:use-host-config-option-ref-label> for more details.
229 .UNINDENT
230 .UNINDENT
231 .SS Commands
232 .SS Optional subcommands
233 .sp
234 Commands cannot have optional subcommands. Optional subcommands were ambiguous,
235 making it unclear whether the input was intended as a command argument or a subcommand. Subcommands are now mandatory if present.
236 .INDENT 0.0
237 .TP
238 .B Examples:
239 .INDENT 7.0
240 .IP \(bu 2
241 Before: \fBdnf history <transaction ID>\fP Now: \fBdnf history info <transaction ID>\fP
242 .IP \(bu 2
243 Before: \fBdnf updateinfo\fP Now: \fBdnf updateinfo summary\fP
244 .UNINDENT
245 .UNINDENT
246 .SS Changes to individual commands
247 .INDENT 0.0
248 .TP
249 .B \fBalias\fP
250 .INDENT 7.0
251 .IP \(bu 2
252 Dropped. The command has been replaced by a different functionality.
253 .IP \(bu 2
254 See the Aliases for command line arguments \%<#\:aliases-misc-ref-label> for more information.
255 .UNINDENT
256 .TP
257 .B \fBautomatic\fP
258 .INDENT 7.0
259 .IP \(bu 2
260 Now a DNF5 plugin.
261 .IP \(bu 2
262 The specific systemd units, \fBdnf\-automatic\-download\fP, \fBdnf\-automatic\-install\fP, and \fBdnf\-automatic\-notifyonly\fP, have been dropped. Only one \fBdnf5\-automatic\fP timer is shipped.
263 .IP \(bu 2
264 The \fBemitters.send_error_messages\fP config option has been dropped. DNF5 automatic always informs the user about failed operations using configured emitters.
265 .IP \(bu 2
266 See the Automatic command \%<#\:automatic-plugin-ref-label> for more information.
267 .UNINDENT
268 .TP
269 .B \fBautoremove\fP
270 .INDENT 7.0
271 .IP \(bu 2
272 Dropped the \fB<spec>\fP positional argument since the use case is sufficiently covered by the \fBremove\fP command.
273 .IP \(bu 2
274 Specific variants of the command, \fBautoremove\-n\fP, \fBautoremove\-na\fP, and \fBautoremove\-nevra\fP, are not supported anymore.
275 .UNINDENT
276 .TP
277 .B \fBbuilddep\fP
278 .INDENT 7.0
279 .IP \(bu 2
280 The \fB\-\-spec\fP and \fB\-\-srpm\fP options only apply to arguments that follow them. This allows for use cases that combine spec files and source RPMs (e.g., \fBdnf5 builddep \-\-spec pkg1.spec.in \-\-srpm pkg2.src.rpm\fP). However, the previously supported syntax \fBdnf builddep pkg1.spec.in \-\-spec\fP no longer has any effect.
281 .UNINDENT
282 .TP
283 .B \fBconfig\-manager\fP
284 .INDENT 7.0
285 .IP \(bu 2
286 New behavior introduced.
287 .IP \(bu 2
288 Parameters are replaced by subcommands.
289 .INDENT 2.0
290 .IP \(bu 2
291 Examples:
292 .INDENT 2.0
293 .IP \(bu 2
294 Before: \fB\-\-add\-repo\fP Now: \fBaddrepo\fP
295 .IP \(bu 2
296 Before: \fB\-\-save \-\-setopt\fP Now: \fBsetopt\fP
297 .UNINDENT
298 .UNINDENT
299 .IP \(bu 2
300 Existing repository files are not modified; drop\-in override files are created instead.
301 .IP \(bu 2
302 Dropped the \fB\-\-dump\fP option:
303 .INDENT 2.0
304 .INDENT 3.5
305 .INDENT 0.0
306 .IP \(bu 2
307 To dump main configuration options use \fBdnf5 \-\-dump\-main\-config\fP command.
308 .IP \(bu 2
309 To dump a repository configuration use \fBdnf5 \-\-dump\-repo\-config=REPO_ID\fP command.
310 .UNINDENT
311 .UNINDENT
312 .UNINDENT
313 .IP \(bu 2
314 Dropped the \fB\-\-dump\-variables\fP option, use \fBdnf5 \-\-dump\-variables\fP command instead.
315 .IP \(bu 2
316 See the config\-manager documentation \%<#\:config-manager-plugin-ref-label> for more information.
317 .UNINDENT
318 .TP
319 .B \fBdebuginfo\-install\fP
320 .INDENT 7.0
321 .IP \(bu 2
322 Now does not support \fIautoupdate\fP functionality. The permanent enablement of debug repositories can be achieved
323 using \fIconfig\-manager\fP command.
324 .UNINDENT
325 .TP
326 .B \fBdistro\-sync\fP
327 .INDENT 7.0
328 .IP \(bu 2
329 Now when any argument doesn\(aqt match an installed package, DNF5 fails. The behavior can be modified by the \fB\-\-skip\-unavailable\fP option.
330 .IP \(bu 2
331 Dropped \fBdistrosync\fP and \fBdistribution\-synchronization\fP aliases.
332 .UNINDENT
333 .TP
334 .B \fBdowngrade\fP
335 .INDENT 7.0
336 .IP \(bu 2
337 Now when any argument doesn\(aqt match an installed package, DNF5 fails. The behavior can be modified by the \fB\-\-skip\-unavailable\fP option.
338 .UNINDENT
339 .TP
340 .B \fBdownload\fP
341 .INDENT 7.0
342 .IP \(bu 2
343 Option \fB\-\-source\fP was renamed to \fB\-\-srpm\fP\&.
344 .IP \(bu 2
345 Dropped \fB\-\-downloaddir\fP argument, only \fB\-\-destdir\fP is supported now.
346 .UNINDENT
347 .TP
348 .B \fBgroup\fP
349 .INDENT 7.0
350 .IP \(bu 2
351 New option \fB\-\-contains\-pkgs\fP to filter only groups containing specific packages.
352 .IP \(bu 2
353 Dropped \fB\-\-ids\fP argument as group ids are always in the output now.
354 .IP \(bu 2
355 Dropped \fBgroup mark install\fP and \fBgroup mark remove\fP subcommands in favor of the new \fB\-\-no\-packages\fP option for the \fBinstall\fP and \fBremove\fP commands.
356 .INDENT 2.0
357 .IP \(bu 2
358 E.g. to mark a group as installed without touching any packages, \fBdnf5 group install \-\-no\-packages <group_id>\fP command can be used.
359 .UNINDENT
360 .IP \(bu 2
361 Dropped \fBgroupinstall\fP alias. It is replaced by \fBdnf group install\fP\&.
362 .IP \(bu 2
363 Dropped \fBgroupinfo\fP alias. It is replaced by \fBdnf group info\fP\&.
364 .IP \(bu 2
365 Dropped \fBgrouplist\fP alias. It is replaced by \fBdnf group list\fP\&.
366 .IP \(bu 2
367 Dropped \fBgrouperase\fP alias. It is replaced by \fBdnf group remove\fP\&.
368 .IP \(bu 2
369 Dropped \fBgroupremove\fP alias. It is replaced by \fBdnf group remove\fP\&.
370 .IP \(bu 2
371 Dropped \fBgroupupdate\fP alias. It is replaced by \fBdnf group upgrade\fP\&.
372 .IP \(bu 2
373 Dropped \fBgroups\fP alias. It is replaced by \fBdnf group\fP\&.
374 .UNINDENT
375 .TP
376 .B \fBhelp\fP
377 .INDENT 7.0
378 .IP \(bu 2
379 Dropped. The functionality is replaced by the \fB\-\-help\fP option.
380 .UNINDENT
381 .TP
382 .B \fBhistory\fP
383 .INDENT 7.0
384 .IP \(bu 2
385 Subcommands are now mandatory: \fBdnf history\fP has to be now \fBdnf5 history list\fP\&.
386 .IP \(bu 2
387 The \fBhistory\fP commands now only accept transaction ID arguments; to filter by packages, use the \fB\-\-contains\-pkgs=PACKAGE_NAME,...\fP option, available for \fBlist\fP and \fBinfo\fP\&.
388 .IP \(bu 2
389 \fBundo\fP subcommand now accepts \fB\-\-ignore\-extras\fP and \fB\-\-ignore\-installed\fP like original \fBhistory replay\fP command.
390 .IP \(bu 2
391 \fBuserinstalled\fP subcommand was dropped. It is replaced by \fBdnf repoquery \-\-userinstalled\fP\&.
392 .IP \(bu 2
393 \fBstore\fP subcommand now creates a directory with transaction JSON file instead of a single transaction JSON file directly.
394 .IP \(bu 2
395 \fBstore\fP subcommand\(aqs \fB\-\-output\fP option now accepts a directory path instead of a file. The default is \fB\&./transaction\fP\&.
396 .IP \(bu 2
397 \fBreplay\fP subcommand was moved to a standalone \fBreplay\fP command, that now accepts a path to a directory instead of a file path.
398 The directory can be created with \fB\-\-store\fP option and in addition to the JSON transaction, it can contain packages, group and environments used in the transaction.
399 .IP \(bu 2
400 \fBinfo\fP subcommand now prints a separate section for each selected transaction. It no longer merges all selected transactions into a single transaction section.
401 .UNINDENT
402 .TP
403 .B \fBinfo\fP
404 .INDENT 7.0
405 .IP \(bu 2
406 Dropped \fB\-\-all\fP option since this behavior is the default one.
407 .IP \(bu 2
408 Dropped \fB\-\-updates\fP option, only \fB\-\-upgrades\fP is available now.
409 .UNINDENT
410 .TP
411 .B \fBinstall\fP
412 .INDENT 7.0
413 .IP \(bu 2
414 Dropped \fBinstall\-n\fP, \fBinstall\-na\fP and \fBinstall\-nevra\fP command variants.
415 .UNINDENT
416 .TP
417 .B \fBlist\fP
418 .INDENT 7.0
419 .IP \(bu 2
420 Dropped \fB\-\-all\fP option since this behavior is the default one.
421 .IP \(bu 2
422 Changed the behavior of the \fB\-\-available\fP option.
423 .INDENT 2.0
424 .IP \(bu 2
425 In DNF4, only packages not installed or with higher versions were listed. This behavior remains unchanged when the option is not used, reducing duplications in the \(dqInstalled Packages\(dq section.
426 .IP \(bu 2
427 When using the \fB\-\-available\fP option, DNF5 considers all versions available in enabled repositories, irrespective of the installed version.
428 .UNINDENT
429 .IP \(bu 2
430 For installed packages print from which repository was the package installed and if the information is not available print \fB<unknown>\fP\&. This differs to DNF4 which if the information wasn\(aqt available printed \fB@System\fP\&.
431 .UNINDENT
432 .TP
433 .B \fBmakecache\fP
434 .INDENT 7.0
435 .IP \(bu 2
436 Metadata is now stored in different directories, see the \fBcachedir\fP configuration option changes for more details.
437 .IP \(bu 2
438 The \fB\-\-timer\fP option has been dropped in favor of the systemd \fBOnUnitInactiveSec\fP setting in \fBdnf5\-makecache.timer\fP and the \fBConditionACPower\fP setting in \fBdnf5\-makecache.service\fP\&.
439 .IP \(bu 2
440 Now tries to avoid downloading whenever possible (e.g. when the local metadata hasn\(aqt expired yet or when the metadata timestamp hasn\(aqt changed). Pass \fB\-\-refresh\fP to force refreshing of metadata. This was the intended behavior in DNF4 also, but \fBdnf4 makecache\fP always refreshed repositories due to a bug \%<https://\:github\:.com/\:rpm-software-management/\:dnf/\:issues/\:2242>\&.
441 .UNINDENT
442 .TP
443 .B \fBmark\fP
444 .INDENT 7.0
445 .IP \(bu 2
446 Renaming subcommands to be more intuitive: \fBinstall\fP \-> \fBuser\fP, \fBremove\fP \-> \fBdependency\fP\&.
447 .IP \(bu 2
448 New \fBweak\fP subcommand to mark a package as a weak dependency.
449 .IP \(bu 2
450 Now when any argument doesn\(aqt match an installed package, DNF5 fails. The behavior can be modified by the \fB\-\-skip\-unavailable\fP option.
451 .UNINDENT
452 .TP
453 .B \fBmodule\fP
454 .INDENT 7.0
455 .IP \(bu 2
456 Dropped \fB\-\-all\fP option since this behavior is the default one.
457 .UNINDENT
458 .TP
459 .B \fBneeds\-restarting\fP
460 .INDENT 7.0
461 .IP \(bu 2
462 Command no longer scans for open files to determine outdated files still in use. The default behavior now aligns with DNF 4\(aqs \fB\-\-reboothint\fP, suggesting a system reboot depending on updated packages since the last boot.
463 .IP \(bu 2
464 Reboot recommendations are now triggered if any package with a \fBreboot_suggested\fP advisory has been installed or updated.
465 .IP \(bu 2
466 The \fB\-s, \-\-services\fP option no longer scans for open files. Instead, restarting a service is recommended if any dependency of the service\-providing package or the package itself has been updated since the service started.
467 .IP \(bu 2
468 Dropped \fB\-r, \-\-reboothint\fP option since this behavior is now the default one.
469 .IP \(bu 2
470 Dropped \fB\-u, \-\-useronly\fP option.
471 .UNINDENT
472 .TP
473 .B \fBoffline\-distrosync\fP
474 .INDENT 7.0
475 .IP \(bu 2
476 Now it\(aqs an alias of \fBdnf5 distro\-sync \-\-offline\fP\&.
477 .UNINDENT
478 .TP
479 .B \fBoffline\-upgrade\fP
480 .INDENT 7.0
481 .IP \(bu 2
482 Now it\(aqs an alias of \fBdnf5 upgrade \-\-offline\fP\&.
483 .UNINDENT
484 .TP
485 .B \fBremove\fP
486 .INDENT 7.0
487 .IP \(bu 2
488 Command no longer removes packages according to provides, but only based on NEVRA or file provide match.
489 .IP \(bu 2
490 Dropped commands \fBremove\-n\fP, \fBremove\-na\fP, \fBremove\-nevra\fP\&.
491 .IP \(bu 2
492 Specific variants of the command, \fBremove\-n\fP, \fBremove\-na\fP, and \fBremove\-nevra\fP, are not supported anymore.
493 .INDENT 2.0
494 .IP \(bu 2
495 Dropped also the related aliases, \fBerase\fP, \fBerase\-n\fP, \fBerase\-na\fP and \fBerase\-nevra\fP\&.
496 .UNINDENT
497 .UNINDENT
498 .TP
499 .B \fBrepoclosure\fP
500 .INDENT 7.0
501 .IP \(bu 2
502 Dropped \fB\-\-pkg\fP option. Positional arguments can now be used to specify packages to check closure for.
503 .UNINDENT
504 .TP
505 .B \fBreposync\fP
506 .INDENT 7.0
507 .IP \(bu 2
508 Dropped \fB\-\-downloadcomps\fP option. Consider using \fB\-\-download\-metadata\fP option which downloads all available repository metadata, not only comps groups.
509 .UNINDENT
510 .TP
511 .B \fBrepolist\fP
512 .INDENT 7.0
513 .IP \(bu 2
514 The \fBrepolist\fP and \fBrepoinfo\fP commands are now subcommands of the \fBrepo\fP command: \fBrepo list\fP and \fBrepo info\fP\&.
515 .INDENT 2.0
516 .IP \(bu 2
517 Original commands still exist as compatibility aliases.
518 .UNINDENT
519 .IP \(bu 2
520 Options \fB\-v\fP and \fB\-\-verbose\fP have been removed. The functionality is replaced by the \fBrepo info\fP command (already in DNF4 as \fBrepoinfo\fP).
521 .IP \(bu 2
522 When no repositories are configured, empty output is now provided instead of displaying \(dqNo repositories available\(dq.
523 .UNINDENT
524 .TP
525 .B \fBrepoquery\fP
526 .INDENT 7.0
527 .IP \(bu 2
528 Dropped: \fB\-a/\-\-all\fP, \fB\-\-alldeps\fP, \fB\-\-nevra\fP options. Their behavior is and has been the default for both DNF4 and DNF5, so the options are no longer needed.
529 .IP \(bu 2
530 Dropped: \fB\-\-envra\fP, \fB\-\-nvr\fP, \fB\-\-unsatisfied\fP options. They are no longer supported.
531 .IP \(bu 2
532 Dropped: \fBrepoquery\-n\fP, \fBrepoquery\-na\fP and \fBrepoquery\-nevra\fP command variants.
533 .IP \(bu 2
534 Dropped: \fB\-\-archlist\fP alias for \fB\-\-arch\fP\&.
535 .IP \(bu 2
536 Dropped: \fB\-f\fP alias for \fB\-\-file\fP\&. Also, the arguments to \fB\-\-file\fP are separated by commas instead of spaces.
537 .IP \(bu 2
538 Moved \fB\-\-groupmember\fP option to the \fBinfo\fP and \fBlist\fP subcommands of the \fBgroup\fP and \fBadvisory\fP commands, renaming it to \fB\-\-contains\-pkgs\fP\&.
539 .IP \(bu 2
540 \fB\-\-queryformat, \-\-qf\fP no longer prints an additional newline at the end of each formatted string, bringing it closer to the behavior of \fBrpm \-\-query\fP\&. To get the newline, use an explicit \fB\en\fP sequence in the formatting string.
541 .IP \(bu 2
542 \fB\-\-queryformat\fP no longer supports \fBsize\fP tag because it was printing install size for installed packages and download size for not\-installed packages, which could be confusing.
543 .IP \(bu 2
544 Option \fB\-\-source\fP was renamed to \fB\-\-sourcerpm\fP, and it now matches queryformat\(aqs \fBsourcerpm\fP tag.
545 .IP \(bu 2
546 Option \fB\-\-resolve\fP was changed to \fB\-\-providers\-of=PACKAGE_ATTRIBUTE\fP\&. It no longer interacts with the formatting options such as \fB\-\-requires\fP, \fB\-\-provides\fP, \fB\-\-suggests\fP, etc. Instead, it takes the PACKAGE_ATTRIBUTE value directly.
547 .INDENT 2.0
548 .IP \(bu 2
549 For example, \fBdnf rq \-\-resolve \-\-requires glibc\fP is now \fBdnf rq \-\-providers\-of=requires glibc\fP\&.
550 .UNINDENT
551 .IP \(bu 2
552 See the Repoquery command \%<#\:repoquery-command-ref-label> for more information.
553 .UNINDENT
554 .TP
555 .B \fBshell\fP
556 .INDENT 7.0
557 .IP \(bu 2
558 The \fBshell\fP command has been superseded by the new \fBdo\fP command.
559 .INDENT 2.0
560 .IP \(bu 2
561 The main advantage of the old command was its ability to perform multiple actions within a single transaction. The new \fBdo\fP command retains this core functionality, but with a different usage model.
562 .INDENT 2.0
563 .INDENT 3.5
564 .INDENT 0.0
565 .IP \(bu 2
566 Usage: The \fBshell\fP command allowed actions to be entered via an interactive shell or a redirected file. The new \fBdo\fP command, however, requires actions to be provided as command\-line arguments. Direct support for reading a command file is not available at this time. However, the file\(aqs contents can be passed as arguments on the command line (e.g., \fBdnf do $(cat file)\fP).
567 .UNINDENT
568 .UNINDENT
569 .UNINDENT
570 .UNINDENT
571 .UNINDENT
572 .TP
573 .B \fBsystem\-upgrade\fP
574 .INDENT 7.0
575 .IP \(bu 2
576 Moved from a plugin to a built\-in command.
577 .UNINDENT
578 .TP
579 .B \fBupgrade\fP
580 .INDENT 7.0
581 .IP \(bu 2
582 New option \fB\-\-minimal\fP\&.
583 .INDENT 2.0
584 .IP \(bu 2
585 \fBupgrade\-minimal\fP still exists as a compatibility alias for \fBupgrade \-\-minimal\fP\&.
586 .UNINDENT
587 .IP \(bu 2
588 Now when any argument doesn\(aqt match an installed package, DNF5 fails. The behavior can be modified by the \fB\-\-skip\-unavailable\fP option.
589 .IP \(bu 2
590 Dropped \fBupgrade\-to\fP and \fBlocalupdate\fP aliases.
591 .IP \(bu 2
592 Dropped \fB\-\-skip\-broken\fP option, as it was already available in DNF4 only for compatibility reasons with YUM, but has no effect.
593 .INDENT 2.0
594 .IP \(bu 2
595 Instead, decisions about package selection and handling dependency issues are based on the best \%<#\:best-option-ref-label> or no\-best \%<#\:no-best-option-ref-label> options.
596 .UNINDENT
597 .UNINDENT
598 .TP
599 .B \fBupdateinfo\fP
600 .INDENT 7.0
601 .IP \(bu 2
602 Renamed the command to \fBadvisory\fP
603 .INDENT 2.0
604 .IP \(bu 2
605 \fBupdateinfo\fP still exists as a compatibility alias.
606 .UNINDENT
607 .IP \(bu 2
608 Subcommands are now mandatory: \fBdnf updateinfo\fP is now \fBdnf5 advisory summary\fP\&.
609 .IP \(bu 2
610 Options \fB\-\-summary\fP, \fB\-\-list\fP and \fB\-\-info\fP have been changed to subcommands. See \fBdnf5 advisory \-\-help\fP\&.
611 .IP \(bu 2
612 Option \fB\-\-sec\-severity\fP has been renamed to \fB\-\-advisory\-severities=ADVISORY_SEVERITY,...\fP\&.
613 .IP \(bu 2
614 The \fBadvisory\fP commands now only accept advisory IDs; to filter by packages, use the \fB\-\-contains\-pkgs=PACKAGE_NAME,...\fP option.
615 .IP \(bu 2
616 Dropped deprecated aliases: \fBlist\-updateinfo\fP, \fBlist\-security\fP, \fBlist\-sec\fP, \fBinfo\-updateinfo\fP, \fBinfo\-security\fP, \fBinfo\-sec\fP, \fBsummary\-updateinfo\fP\&.
617 .IP \(bu 2
618 Dropped \fBupif\fP alias.
619 .UNINDENT
620 .TP
621 .B \fBversionlock\fP
622 .INDENT 7.0
623 .IP \(bu 2
624 New format of the configuration file.
625 .IP \(bu 2
626 See the Versionlock command \%<#\:versionlock-command-ref-label> for more information.
627 .UNINDENT
628 .UNINDENT
629 .SH CHANGES ON THE API
630 .sp
631 The differences between DNF4 and DNF5 API are not only in minor tweaks, but there are major architectural changes, therefore, it is not feasible to cover all the changes. The Tutorial: API changes between DNF and DNF5 \%<#\:tutorial-api-changes-ref-label> section describes the most common use cases and points out the main differences.
632 .SS Other notable changes on the API
633 .INDENT 0.0
634 .TP
635 .B \fBPackageSet::operator[]\fP
636 .INDENT 7.0
637 .IP \(bu 2
638 It was removed due to insufficient O(n^2) performance. Use PackageSet iterator to access the data instead.
639 .UNINDENT
640 .TP
641 .B \fBPackage::get_epoch()\fP
642 .INDENT 7.0
643 .IP \(bu 2
644 The return type was changed from \fBunsigned long\fP to \fBstd::string\fP\&.
645 .UNINDENT
646 .TP
647 .B DNF: \fBPackage.size\fP, libdnf: \fBdnf_package_get_size()\fP
648 .INDENT 7.0
649 .IP \(bu 2
650 The return value was ambiguous, returning either package or install size. Use Package::get_download_size() and Package::get_install_size() instead.
651 .UNINDENT
652 .TP
653 .B \fBdnf_sack_set_installonly\fP, \fBdnf_sack_get_installonly\fP, \fBdnf_sack_set_installonly_limit\fP, \fBdnf_sack_get_installonly_limit\fP
654 .INDENT 7.0
655 .IP \(bu 2
656 The functions were dropped as unneeded. The installonly packages are taken directly from main Conf in Base.
657 .UNINDENT
658 .TP
659 .B \fBQuery::filter()\fP \- \fBHY_PKG_UPGRADES_BY_PRIORITY\fP, \fBHY_PKG_OBSOLETES_BY_PRIORITY\fP, \fBHY_PKG_LATEST_PER_ARCH_BY_PRIORITY\fP
660 .INDENT 7.0
661 .IP \(bu 2
662 The priority filter was separated into a standalone method. Combine \fBquery.filter_priority()\fP with \fBquery.filter_latest_evr()\fP or another filter to achieve the original functionality.
663 .UNINDENT
664 .TP
665 .B \fBQuery::filter()\fP \- \fBHY_PKG_LATEST\fP
666 .INDENT 7.0
667 .IP \(bu 2
668 The filter was replaced with \fBfilter_latest_evr()\fP which has the same behavior as \fBHY_PKG_LATEST_PER_ARCH\fP
669 .UNINDENT
670 .TP
671 .B \fBConfigMain::proxy_auth_method()\fP and \fBConfigRepo::proxy_auth_method()\fP
672 .INDENT 7.0
673 .IP \(bu 2
674 The return types were changed. \fBOptionEnum<std::string>\fP was replaced by \fBOptionStringSet\fP\&. A combination of several authentication methods (for example \(dqbasic\(dq and \(dqdigest\(dq) can now be used. This allows using a list of authentication methods in configuration files and the DNF5 command line \(dq\-\-setopt=proxy_auth_method=\(dq.
675 .UNINDENT
676 .UNINDENT
677 .SH CHANGES TO CONFIGURATION
678 .SS Deprecation of the \fBstrict\fP option
679 .sp
680 \fBstrict\fP configuration option is now deprecated due to its dual functionality:
681 .INDENT 0.0
682 .INDENT 3.5
683 .INDENT 0.0
684 .IP 1. 3
685 It allows the solver to skip uninstallable packages to resolve dependency problems.
686 .IP 2. 3
687 It permits DNF to skip unavailable packages (mostly for the \fBinstall\fP command).
688 .UNINDENT
689 .UNINDENT
690 .UNINDENT
691 .sp
692 To address this, the functionality has been split into two configuration options:
693 .INDENT 0.0
694 .INDENT 3.5
695 .INDENT 0.0
696 .IP \(bu 2
697 \fBskip_broken\fP for uninstallable packages.
698 .IP \(bu 2
699 \fBskip_unavailable\fP for packages not present in repositories.
700 .UNINDENT
701 .UNINDENT
702 .UNINDENT
703 .sp
704 Additionally, corresponding command\-line options \fB\-\-skip\-broken\fP and \fB\-\-skip\-unavailable\fP have been introduced for commands where applicable.
705 .SS Deprecation of the \fBmetadata_timer_sync\fP option
706 .sp
707 The \fBmetadata_timer_sync\fP configuration option is now obsoleted by the \fBdnf5\-makecache.timer\fP systemd timer settings.
708 .SS Deprecation of the \fBretries\fP option
709 .sp
710 The \fBretries\fP configuration option is now deprecated. In dnf4, despite being documented as the number of retries for downloading packages, it was only used to limit the number of package re\-downloads due to deltarpm errors. Deltarpm support is currently not planned for DNF5.
711 .SS Deprecation of the \fBdeltarpm\fP and \fBdeltarpm_percentage\fP options
712 .sp
713 Support for delta RPMs is not planned for DNF5.
714 .SS Changes to individual options
715 .INDENT 0.0
716 .TP
717 .B \fBbest\fP
718 .INDENT 7.0
719 .IP \(bu 2
720 Default value is changed to \fBtrue\fP\&.
721 .IP \(bu 2
722 The new default value ensures that important updates will not be skipped and issues in distribution will be reported earlier.
723 .UNINDENT
724 .UNINDENT
725 .INDENT 0.0
726 .TP
727 .B \fBcachedir\fP
728 .INDENT 7.0
729 .IP \(bu 2
730 The default user cached dir is now at \fB~/.cache/libdnf5\fP\&.
731 .IP \(bu 2
732 The default root cache directory, configured by the \fBsystem_cachedir\fP option, is now \fB/var/cache/libdnf5\fP\&.
733 .IP \(bu 2
734 Users no longer access the root\(aqs cache directly; instead, metadata is copied to the user\(aqs location if it\(aqs empty or invalid.
735 .IP \(bu 2
736 For additional information, refer to the Caching \%<#\:caching-misc-ref-label> man page.
737 .UNINDENT
738 .TP
739 .B \fBcacheonly\fP
740 .INDENT 7.0
741 .IP \(bu 2
742 The option was changed from \fBbool\fP to \fBenum\fP with options \fBall\fP, \fBmetadata\fP and \fBnone\fP\&.
743 .INDENT 2.0
744 .IP \(bu 2
745 This enables users to specify whether to use the cache exclusively for metadata or for both metadata and packages.
746 .UNINDENT
747 .UNINDENT
748 .TP
749 .B \fBdisable_excludes\fP
750 .INDENT 7.0
751 .IP \(bu 2
752 To disable all configuration file excludes, the \fB*\fP glob character is used now instead of the \fBall\fP to unify the behavior with query objects on the API.
753 .UNINDENT
754 .TP
755 .B \fBkeepcache\fP
756 .INDENT 7.0
757 .IP \(bu 2
758 The behavior has been slightly modified, see the Caching \%<#\:caching-packages-ref-label> man page for more information.
759 .UNINDENT
760 .TP
761 .B \fBoptional_metadata_types\fP
762 .INDENT 7.0
763 .IP \(bu 2
764 Default value is now: \fBcomps,updateinfo\fP\&.
765 .IP \(bu 2
766 Supported values are now extended to the following list: \fBcomps\fP, \fBfilelists\fP, \fBother\fP, \fBpresto\fP, \fBupdateinfo\fP\&.
767 .UNINDENT
768 .UNINDENT
769 .SS Newly introduced configuration options
770 .INDENT 0.0
771 .TP
772 .B \fBallow_downgrade\fP
773 .INDENT 7.0
774 .IP \(bu 2
775 New option used to enable or disable downgrade of dependencies when resolving transaction.
776 .UNINDENT
777 .TP
778 .B \fBskip_broken\fP, \fBskip_unavailable\fP, \fBstrict\fP
779 .INDENT 7.0
780 .IP \(bu 2
781 New options \fBskip_broken\fP, \fBskip_unavailable\fP were added due to deprecation of \fBstrict\fP option.
782 .IP \(bu 2
783 See the strict deprecation above.
784 .UNINDENT
785 .UNINDENT
786 .SS Dropped configuration options
787 .INDENT 0.0
788 .TP
789 .B \fBarch\fP and \fBbasearch\fP
790 .INDENT 7.0
791 .IP \(bu 2
792 It is no longer possible to change the detected architecute in configuration files.
793 .IP \(bu 2
794 See the \fBdnf5\-forcearch(7)\fP, Forcearch parameter \%<#\:forcearch-misc-ref-label> for overriding architecture.
795 .UNINDENT
796 .TP
797 .B \fBerrorlevel\fP
798 .INDENT 7.0
799 .IP \(bu 2
800 The option was deprecated in dnf < 5 and is dropped now.
801 .UNINDENT
802 .UNINDENT
803 .SH Author
804 See AUTHORS.md in dnf5 source distribution.
805 .SH Copyright
806 Contributors to the dnf5 project.
807 .\" End of generated man page.