Debian Codegraph @

upstream/mageia-cauldron/man7/dnf5-changes-from-dnf4.7

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