| 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" "8" "May 10, 2026" "" "dnf5" |
| 31 |
.SH NAME |
| 32 |
dnf5 \- DNF5 Package Management Utility |
| 33 |
.SH SYNOPSIS |
| 34 |
.sp |
| 35 |
\fBdnf5 <command> [options] [<args>...]\fP |
| 36 |
.SH DESCRIPTION |
| 37 |
.sp |
| 38 |
\X'tty: link https://github.com/rpm-software-management/dnf5/'\fI\%DNF5\fP\X'tty: link' is the new version of \X'tty: link https://github.com/rpm-software-management/dnf/'\fI\%DNF\fP\X'tty: link', a package manager for RPM\-based Linux distributions. It has been completely |
| 39 |
rewritten in C++ aiming for better performance and reducing external dependencies. |
| 40 |
.SH COMMANDS |
| 41 |
.sp |
| 42 |
Here is the list of the available commands. |
| 43 |
For more details see the separate man page for the specific command, f.e. \fBman dnf5 install\fP\&. |
| 44 |
.INDENT 0.0 |
| 45 |
.TP |
| 46 |
.B \fI\%advisory\fP |
| 47 |
.nf |
| 48 |
Manage advisories. |
| 49 |
.fi |
| 50 |
.sp |
| 51 |
.TP |
| 52 |
.B \fI\%autoremove\fP |
| 53 |
.nf |
| 54 |
Remove unneeded packages. |
| 55 |
.fi |
| 56 |
.sp |
| 57 |
.TP |
| 58 |
.B \fI\%check\fP |
| 59 |
.nf |
| 60 |
Check for problems in the package database. |
| 61 |
.fi |
| 62 |
.sp |
| 63 |
.TP |
| 64 |
.B \fI\%check\-upgrade\fP |
| 65 |
.nf |
| 66 |
Check for available package upgrades. |
| 67 |
.fi |
| 68 |
.sp |
| 69 |
.TP |
| 70 |
.B \fI\%clean\fP |
| 71 |
.nf |
| 72 |
Remove or invalidate cached data. |
| 73 |
.fi |
| 74 |
.sp |
| 75 |
.TP |
| 76 |
.B \fI\%distro\-sync\fP |
| 77 |
.nf |
| 78 |
Upgrade or downgrade installed packages to the latest available version. |
| 79 |
.fi |
| 80 |
.sp |
| 81 |
.TP |
| 82 |
.B \fI\%downgrade\fP |
| 83 |
.nf |
| 84 |
Downgrade packages. |
| 85 |
.fi |
| 86 |
.sp |
| 87 |
.TP |
| 88 |
.B \fI\%download\fP |
| 89 |
.nf |
| 90 |
Download packages. |
| 91 |
.fi |
| 92 |
.sp |
| 93 |
.TP |
| 94 |
.B \fI\%environment\fP |
| 95 |
.nf |
| 96 |
Manage comps environments. |
| 97 |
.fi |
| 98 |
.sp |
| 99 |
.TP |
| 100 |
.B \fI\%group\fP |
| 101 |
.nf |
| 102 |
Manage comps groups. |
| 103 |
.fi |
| 104 |
.sp |
| 105 |
.TP |
| 106 |
.B \fI\%history\fP |
| 107 |
.nf |
| 108 |
Manage transaction history. |
| 109 |
.fi |
| 110 |
.sp |
| 111 |
.TP |
| 112 |
.B \fI\%info\fP |
| 113 |
.nf |
| 114 |
Provide detailed information about installed or available packages. |
| 115 |
.fi |
| 116 |
.sp |
| 117 |
.TP |
| 118 |
.B \fI\%install\fP |
| 119 |
.nf |
| 120 |
Install packages. |
| 121 |
.fi |
| 122 |
.sp |
| 123 |
.TP |
| 124 |
.B \fI\%leaves\fP |
| 125 |
.nf |
| 126 |
List groups of leaf packages. |
| 127 |
.fi |
| 128 |
.sp |
| 129 |
.TP |
| 130 |
.B \fI\%list\fP |
| 131 |
.nf |
| 132 |
List installed or available packages. |
| 133 |
.fi |
| 134 |
.sp |
| 135 |
.TP |
| 136 |
.B \fI\%makecache\fP |
| 137 |
.nf |
| 138 |
Generate the metadata cache. |
| 139 |
.fi |
| 140 |
.sp |
| 141 |
.TP |
| 142 |
.B \fI\%mark\fP |
| 143 |
.nf |
| 144 |
Change the reason of an installed package. |
| 145 |
.fi |
| 146 |
.sp |
| 147 |
.TP |
| 148 |
.B \fI\%module\fP |
| 149 |
.nf |
| 150 |
Manage modules. |
| 151 |
.fi |
| 152 |
.sp |
| 153 |
.TP |
| 154 |
.B \fI\%offline\fP |
| 155 |
.nf |
| 156 |
Manage offline transactions. |
| 157 |
.fi |
| 158 |
.sp |
| 159 |
.TP |
| 160 |
.B \fI\%provides\fP |
| 161 |
.nf |
| 162 |
Find what package provides the given value. |
| 163 |
.fi |
| 164 |
.sp |
| 165 |
.TP |
| 166 |
.B \fI\%reinstall\fP |
| 167 |
.nf |
| 168 |
Reinstall packages. |
| 169 |
.fi |
| 170 |
.sp |
| 171 |
.TP |
| 172 |
.B \fI\%remove\fP |
| 173 |
.nf |
| 174 |
Remove packages. |
| 175 |
.fi |
| 176 |
.sp |
| 177 |
.TP |
| 178 |
.B \fI\%replay\fP |
| 179 |
.nf |
| 180 |
Replay stored transactions. |
| 181 |
.fi |
| 182 |
.sp |
| 183 |
.TP |
| 184 |
.B \fI\%repo\fP |
| 185 |
.nf |
| 186 |
Manage repositories. |
| 187 |
.fi |
| 188 |
.sp |
| 189 |
.TP |
| 190 |
.B \fI\%repoquery\fP |
| 191 |
.nf |
| 192 |
Search for packages in repositories. |
| 193 |
.fi |
| 194 |
.sp |
| 195 |
.TP |
| 196 |
.B \fI\%search\fP |
| 197 |
.nf |
| 198 |
Search for packages using keywords. |
| 199 |
.fi |
| 200 |
.sp |
| 201 |
.TP |
| 202 |
.B \fI\%swap\fP |
| 203 |
.nf |
| 204 |
Remove software and install another in the single transaction. |
| 205 |
.fi |
| 206 |
.sp |
| 207 |
.TP |
| 208 |
.B \fI\%system\-upgrade\fP |
| 209 |
.nf |
| 210 |
Upgrade the system to a new major release. |
| 211 |
.fi |
| 212 |
.sp |
| 213 |
.TP |
| 214 |
.B \fI\%upgrade\fP |
| 215 |
.nf |
| 216 |
Upgrade packages. |
| 217 |
.fi |
| 218 |
.sp |
| 219 |
.TP |
| 220 |
.B \fI\%versionlock\fP |
| 221 |
.nf |
| 222 |
Protect packages from updates to newer versions. |
| 223 |
.fi |
| 224 |
.sp |
| 225 |
.UNINDENT |
| 226 |
.SS Plugin commands |
| 227 |
.sp |
| 228 |
Here is the list of the commands available as plugins. |
| 229 |
These are available after installing the \fBdnf5\-plugins\fP package. |
| 230 |
.INDENT 0.0 |
| 231 |
.TP |
| 232 |
.B \fI\%automatic\fP |
| 233 |
.nf |
| 234 |
Alternative CLI to \fBdnf upgrade\fP suitable to be executed automatically and regularly from systemd timers, cron jobs and similar. |
| 235 |
.fi |
| 236 |
.sp |
| 237 |
.TP |
| 238 |
.B \fI\%builddep\fP |
| 239 |
.nf |
| 240 |
Install missing dependencies for building an RPM package. |
| 241 |
.fi |
| 242 |
.sp |
| 243 |
.TP |
| 244 |
.B \fI\%changelog\fP |
| 245 |
.nf |
| 246 |
Show package changelogs. |
| 247 |
.fi |
| 248 |
.sp |
| 249 |
.TP |
| 250 |
.B \fI\%config\-manager\fP |
| 251 |
.nf |
| 252 |
Manages main configuration, repositories configuration, and variables. |
| 253 |
.fi |
| 254 |
.sp |
| 255 |
.TP |
| 256 |
.B \fI\%copr\fP |
| 257 |
.nf |
| 258 |
Manage Copr repositories (add\-ons provided by users/community/third\-party). |
| 259 |
.fi |
| 260 |
.sp |
| 261 |
.TP |
| 262 |
.B \fI\%needs\-restarting\fP |
| 263 |
.nf |
| 264 |
Determine whether the system should be rebooted. |
| 265 |
.fi |
| 266 |
.sp |
| 267 |
.TP |
| 268 |
.B \fI\%repoclosure\fP |
| 269 |
.nf |
| 270 |
Display a list of unresolved dependencies for repositories. |
| 271 |
.fi |
| 272 |
.sp |
| 273 |
.TP |
| 274 |
.B \fI\%reposync\fP |
| 275 |
.nf |
| 276 |
Synchronize packages and metadata of a remote DNF repository to a local directory. |
| 277 |
.fi |
| 278 |
.sp |
| 279 |
.UNINDENT |
| 280 |
.SH OPTIONS |
| 281 |
.sp |
| 282 |
Following options are applicable in the general context for any \fBdnf5\fP command: |
| 283 |
.INDENT 0.0 |
| 284 |
.TP |
| 285 |
.B \fB\-\-assumeno\fP |
| 286 |
.nf |
| 287 |
Automatically answer no for all questions. |
| 288 |
.fi |
| 289 |
.sp |
| 290 |
.UNINDENT |
| 291 |
.INDENT 0.0 |
| 292 |
.TP |
| 293 |
.B \fB\-\-best\fP |
| 294 |
.nf |
| 295 |
Try the best available package versions in transactions. |
| 296 |
.fi |
| 297 |
.sp |
| 298 |
.sp |
| 299 |
Specifically during dnf upgrade, which by default skips over updates that can not be |
| 300 |
installed for dependency reasons, the switch forces \fBDNF5\fP to only consider the latest |
| 301 |
packages. When running into packages with broken dependencies, \fBDNF5\fP will fail giving |
| 302 |
the reason why the latest version can not be installed. |
| 303 |
.sp |
| 304 |
Note that the use of the newest available version is only guaranteed for the packages |
| 305 |
directly requested (e.g. as a command line arguments), and the solver may use older |
| 306 |
versions of dependencies to meet their requirements. |
| 307 |
.TP |
| 308 |
.B \fB\-C, \-\-cacheonly\fP |
| 309 |
.nf |
| 310 |
Use only cached data for working with packages and repository metadata. |
| 311 |
Cache won\(aqt be updated, even if it is expired. |
| 312 |
.fi |
| 313 |
.sp |
| 314 |
.TP |
| 315 |
.B \fB\-\-comment=COMMENT\fP |
| 316 |
.nf |
| 317 |
Add a comment to the transaction history. |
| 318 |
.fi |
| 319 |
.sp |
| 320 |
.UNINDENT |
| 321 |
.INDENT 0.0 |
| 322 |
.TP |
| 323 |
.B \fB\-\-config=CONFIG_FILE_PATH\fP |
| 324 |
.nf |
| 325 |
Define configuration file location. |
| 326 |
.fi |
| 327 |
.sp |
| 328 |
.TP |
| 329 |
.B \fB\-\-debugsolver\fP |
| 330 |
.nf |
| 331 |
Dump additional data from solver for debugging purposes. |
| 332 |
Data are saved in \fB\&./debugdata\fP\&. |
| 333 |
.fi |
| 334 |
.sp |
| 335 |
.TP |
| 336 |
.B \fB\-\-disable\-plugin=PLUGIN_NAME,...\fP |
| 337 |
.nf |
| 338 |
Disable specified libdnf5 library plugins for the purpose of the current \fBDNF5\fP command. |
| 339 |
This is a list option which can be specified multiple times. |
| 340 |
Accepted values are names, or a glob of names. |
| 341 |
.fi |
| 342 |
.sp |
| 343 |
.TP |
| 344 |
.B \fB\-\-disable\-repo=REPO_ID,...\fP |
| 345 |
.nf |
| 346 |
Temporarily disable active repositories for the purpose of the current \fBDNF5\fP command. |
| 347 |
This is a list option which can be specified multiple times. |
| 348 |
Accepted values are ids, or a glob of ids. |
| 349 |
.fi |
| 350 |
.sp |
| 351 |
.TP |
| 352 |
.B \fB\-\-dump\-main\-config\fP |
| 353 |
.nf |
| 354 |
Print main configuration values to stdout. |
| 355 |
.fi |
| 356 |
.sp |
| 357 |
.TP |
| 358 |
.B \fB\-\-dump\-repo\-config=REPO_ID,...\fP |
| 359 |
.nf |
| 360 |
Print repository configuration values to stdout. |
| 361 |
This is a list option which can be specified multiple times. |
| 362 |
Accepted values are ids, or a glob of ids. |
| 363 |
.fi |
| 364 |
.sp |
| 365 |
.TP |
| 366 |
.B \fB\-\-dump\-variables\fP |
| 367 |
.nf |
| 368 |
Print variable values to stdout. |
| 369 |
.fi |
| 370 |
.sp |
| 371 |
.TP |
| 372 |
.B \fB\-\-enable\-plugin=PLUGIN_NAME,...\fP |
| 373 |
.nf |
| 374 |
Enable specified libdnf5 library plugins for the purpose of the current \fBDNF5\fP command. |
| 375 |
This is a list option which can be specified multiple times. |
| 376 |
Accepted values are names, or a glob of names. |
| 377 |
.fi |
| 378 |
.sp |
| 379 |
.TP |
| 380 |
.B \fB\-\-enable\-repo=REPO_ID,...\fP |
| 381 |
.nf |
| 382 |
Temporarily enable additional repositories for the purpose of the current \fBDNF5\fP command. |
| 383 |
This is a list option which can be specified multiple times. |
| 384 |
Accepted values are ids, or a glob of ids. |
| 385 |
.fi |
| 386 |
.sp |
| 387 |
.TP |
| 388 |
.B \fB\-\-forcearch=ARCH\fP |
| 389 |
.nf |
| 390 |
Force the use of a specific architecture. |
| 391 |
\fI\%See\fP \fBdnf5\-forcearch(7)\fP for more info. |
| 392 |
.fi |
| 393 |
.sp |
| 394 |
.UNINDENT |
| 395 |
.INDENT 0.0 |
| 396 |
.TP |
| 397 |
.B \fB\-h, \-\-help\fP |
| 398 |
.nf |
| 399 |
Show the help. |
| 400 |
.fi |
| 401 |
.sp |
| 402 |
.TP |
| 403 |
.B \fB\-\-installroot=ABSOLUTE_PATH\fP |
| 404 |
.nf |
| 405 |
Setup installroot path. |
| 406 |
Absolute path is required. |
| 407 |
\fI\%See\fP \fBdnf5\-installroot(7)\fP for more info. |
| 408 |
.fi |
| 409 |
.sp |
| 410 |
.UNINDENT |
| 411 |
.INDENT 0.0 |
| 412 |
.TP |
| 413 |
.B \fB\-\-no\-best\fP |
| 414 |
.nf |
| 415 |
Do not limit the transaction to the best candidates only. |
| 416 |
.fi |
| 417 |
.sp |
| 418 |
.TP |
| 419 |
.B \fB\-\-no\-docs\fP |
| 420 |
.nf |
| 421 |
Do not install any files that are marked as a documentation (which includes man pages and texinfo documents). |
| 422 |
It sets the \fBRPMTRANS_FLAG_NODOCS\fP flag. |
| 423 |
.fi |
| 424 |
.sp |
| 425 |
.TP |
| 426 |
.B \fB\-\-no\-gpgchecks\fP |
| 427 |
.nf |
| 428 |
Skip checking OpenPGP signatures on packages (if \fBRPM\fP policy allows that). |
| 429 |
.fi |
| 430 |
.sp |
| 431 |
.TP |
| 432 |
.B \fB\-\-no\-plugins\fP |
| 433 |
.nf |
| 434 |
Disable all libdnf5 plugins. |
| 435 |
.fi |
| 436 |
.sp |
| 437 |
.TP |
| 438 |
.B \fB\-q, \-\-quiet\fP |
| 439 |
In combination with a non\-interactive command, shows just the relevant content. |
| 440 |
Suppresses messages notifying about the current state or actions of \fBDNF5\fP\&. |
| 441 |
.TP |
| 442 |
.B \fB\-\-refresh\fP |
| 443 |
.nf |
| 444 |
Force refreshing metadata before running the command. |
| 445 |
.fi |
| 446 |
.sp |
| 447 |
.TP |
| 448 |
.B \fB\-\-color=<color>\fP |
| 449 |
.nf |
| 450 |
Control whether color is used in terminal output. Valid values are \fBalways\fP, \fBnever\fP and \fBauto\fP (default). |
| 451 |
.fi |
| 452 |
.sp |
| 453 |
.TP |
| 454 |
.B \fB\-\-repo=REPO_ID,...\fP |
| 455 |
.nf |
| 456 |
Enable just specified repositories. |
| 457 |
This is a list option which can be specified multiple times. |
| 458 |
Accepted values are ids, or a glob of ids. |
| 459 |
.fi |
| 460 |
.sp |
| 461 |
.TP |
| 462 |
.B \fB\-\-repofrompath=REPO_ID,REPO_PATH\fP |
| 463 |
Specify a repository to add to the repositories only for this run. Can be used multiple times. |
| 464 |
.sp |
| 465 |
The new repository id is specified by \fBREPO_ID\fP and its baseurl by \fBREPO_PATH\fP\&. Variables in both values are substituted before creating the repo. |
| 466 |
.sp |
| 467 |
The configuration of the new repository can be adjusted using options \fB\-\-setopt=REPO_ID.option=value\fP\&. |
| 468 |
.sp |
| 469 |
If you want only packages from this repository to be available, combine this option with \fB\-\-repo=REPO_ID\fP switch. |
| 470 |
.TP |
| 471 |
.B \fB\-\-releasever=RELEASEVER\fP |
| 472 |
Override the value of the distribution release (the \fBreleasever\fP variable) in configuration files. |
| 473 |
This can affect cache paths, values in configuration files and mirrorlist URLs. |
| 474 |
Whenever \fBreleasever\fP is set, \fBreleasever_major\fP and \fBreleasever_minor\fP will also be set by splitting \fBreleasever\fP on the first \fB\&.\fP\&. |
| 475 |
.TP |
| 476 |
.B \fB\-\-releasever\-major=RELEASEVER_MAJOR\fP |
| 477 |
Override the \fBreleasever_major\fP variable, which is usually automatically detected or taken from the part of \fB$releasever\fP before the first \fB\&.\fP\&. |
| 478 |
Does not affect the setting of the \fBreleasever\fP variable. |
| 479 |
Must be specified after \fB\-\-releasever\fP on the command line, otherwise the major part of the \fB\-\-releasever\fP will take precedent. |
| 480 |
.TP |
| 481 |
.B \fB\-\-releasever\-minor=RELEASEVER_MINOR\fP |
| 482 |
Override the \fBreleasever_minor\fP variable, which is usually automatically detected or taken from the part of \fB$releasever\fP after the first \fB\&.\fP\&. |
| 483 |
Does not affect the setting of the \fBreleasever\fP variable. |
| 484 |
Must be specified after \fB\-\-releasever\fP on the command line, otherwise the minor part of the \fB\-\-releasever\fP will take precedent. |
| 485 |
.TP |
| 486 |
.B \fB\-\-setopt=[REPO_ID.]OPTION=VALUE\fP |
| 487 |
.nf |
| 488 |
Override a configuration option from the configuration file. |
| 489 |
The \fBREPO_ID\fP parameter is used to override options for repositories. |
| 490 |
.fi |
| 491 |
.sp |
| 492 |
.sp |
| 493 |
Values for the options like \fBexcludepkgs\fP, \fBincludepkgs\fP, \fBinstallonlypkgs\fP and \fBtsflags\fP |
| 494 |
are appended to the original value, they do not override it. However, specifying an empty |
| 495 |
value (e.g. \fB\-\-setopt=tsflags=\fP) will clear the option. |
| 496 |
.TP |
| 497 |
.B \fB\-\-setvar=VAR_NAME=VALUE\fP |
| 498 |
.nf |
| 499 |
Override a \fBDNF5\fP variable value, like \fBarch\fP, \fBreleasever\fP, etc. |
| 500 |
.fi |
| 501 |
.sp |
| 502 |
.TP |
| 503 |
.B \fB\-\-skip\-file\-locks\fP |
| 504 |
.nf |
| 505 |
Skip acquiring file locks, such as the lock on the system repository. |
| 506 |
See \fI\%skip_sytem_repo_lock\fP for more info. |
| 507 |
.fi |
| 508 |
.sp |
| 509 |
.TP |
| 510 |
.B \fB\-\-show\-new\-leaves\fP |
| 511 |
.nf |
| 512 |
Show newly installed leaf packages and packages that became leaves after a transaction. |
| 513 |
.fi |
| 514 |
.sp |
| 515 |
.UNINDENT |
| 516 |
.INDENT 0.0 |
| 517 |
.TP |
| 518 |
.B \fB\-\-use\-host\-config\fP |
| 519 |
.nf |
| 520 |
Use configuration files and variable definitions from the host system rather than the installroot. |
| 521 |
\fI\%See\fP \fBdnf5\-installroot(7)\fP for more info. |
| 522 |
.fi |
| 523 |
.sp |
| 524 |
.UNINDENT |
| 525 |
.INDENT 0.0 |
| 526 |
.TP |
| 527 |
.B \fB\-\-version\fP |
| 528 |
.nf |
| 529 |
Display the version of the dnf5 application and libdnf5 library, along with successfully loaded plugins and their versions, and then exit. |
| 530 |
.fi |
| 531 |
.sp |
| 532 |
.UNINDENT |
| 533 |
.INDENT 0.0 |
| 534 |
.TP |
| 535 |
.B \fB\-y, \-\-assumeyes\fP |
| 536 |
.nf |
| 537 |
Automatically answer yes for all questions. |
| 538 |
.fi |
| 539 |
.sp |
| 540 |
.TP |
| 541 |
.B \fB\-x PACKAGE\-SPEC\-N,..., \-\-exclude=PACKAGE\-SPEC\-N,...\fP |
| 542 |
.nf |
| 543 |
Exclude packages specified in \fBPACKAGE\-SPEC\-N\fP arguments from the transaction. |
| 544 |
This is a list option. |
| 545 |
.fi |
| 546 |
.sp |
| 547 |
.UNINDENT |
| 548 |
.SH METADATA SYNCHRONIZATION |
| 549 |
.sp |
| 550 |
Correct operation of \fBDNF5\fP depends on having an access to up\-to\-date data from the all enabled |
| 551 |
repositories, but contacting remote mirrors on every operation considerably slows it down and costs |
| 552 |
bandwidth for both the client and the repository provider. The \fBmetadata_expire\fP repository configuration |
| 553 |
option is used by \fBDNF5\fP to determine whether a particular local copy of repository data is due |
| 554 |
to be re\-synced. It is crucial that the repository providers set the option well, namely to a value |
| 555 |
where it is guaranteed that if particular metadata was available in time \fBT\fP on the server, |
| 556 |
then all packages it references will still be available for download from the server |
| 557 |
in time \fBT + metadata_expire\fP\&. |
| 558 |
.sp |
| 559 |
To further reduce the bandwidth load, some of the commands where having up\-to\-date metadata |
| 560 |
is not critical (e.g. the \fBgroup list\fP command) do not look at whether a repository is expired |
| 561 |
and whenever any version of it is locally available to the user\(aqs account, it will be used. |
| 562 |
.sp |
| 563 |
\fI\%Refer to the\fP \fBdnf5\-caching(7)\fP for more info regarding |
| 564 |
metadata and packages caching. |
| 565 |
.SH CONFIGURATION FILES REPLACEMENT POLICY |
| 566 |
.sp |
| 567 |
The updated packages could replace the old modified configuration files with the new ones or keep |
| 568 |
the older files. Neither of the files are actually replaced. To the conflicting ones \fBRPM\fP |
| 569 |
gives additional suffix to the origin name. Which file should maintain the true name after |
| 570 |
transaction is not controlled by package manager, but is specified by each package itself, |
| 571 |
following packaging guideline. |
| 572 |
.SH EXIT CODES |
| 573 |
.sp |
| 574 |
The \fBdnf5\fP command in general exits with the following return values: |
| 575 |
.INDENT 0.0 |
| 576 |
.TP |
| 577 |
.B \fI0\fP |
| 578 |
.nf |
| 579 |
Operation was successful. |
| 580 |
.fi |
| 581 |
.sp |
| 582 |
.TP |
| 583 |
.B \fI1\fP |
| 584 |
.nf |
| 585 |
An error occurred during processing of the command. |
| 586 |
.fi |
| 587 |
.sp |
| 588 |
.TP |
| 589 |
.B \fI2\fP |
| 590 |
.nf |
| 591 |
An error occurred during parsing the arguments. |
| 592 |
.fi |
| 593 |
.sp |
| 594 |
.UNINDENT |
| 595 |
.sp |
| 596 |
Other exit codes could be returned by the specific command itself, see its documentation for more info. |
| 597 |
.SH FILES |
| 598 |
.INDENT 0.0 |
| 599 |
.TP |
| 600 |
.B \fBCache Files\fP |
| 601 |
/var/cache/libdnf5/ |
| 602 |
.TP |
| 603 |
.B \fBMain Configuration\fP |
| 604 |
/etc/dnf/dnf.conf |
| 605 |
.TP |
| 606 |
.B \fBRepository Configuration\fP |
| 607 |
/etc/yum.repos.d/ |
| 608 |
.TP |
| 609 |
.B \fBRepository Persistence\fP |
| 610 |
/var/lib/dnf/ |
| 611 |
.TP |
| 612 |
.B \fBSystem State\fP |
| 613 |
/usr/lib/sysimage/libdnf5/ |
| 614 |
.UNINDENT |
| 615 |
.SH ENVIRONMENT |
| 616 |
.INDENT 0.0 |
| 617 |
.TP |
| 618 |
.B \fBDNF5_FORCE_INTERACTIVE\fP |
| 619 |
Override interactivity of the connected standard input/ouput. Set to \fI0\fP to pretend |
| 620 |
that the input/output is not connected to an interactive terminal and DNF5 |
| 621 |
should not ask any questions. Set to \fI1\fP to force DNF5 to ask questions |
| 622 |
even if the terminal is non\-interractive. See |
| 623 |
\fI\%\-\-assumeno\fP and |
| 624 |
\fI\%\-\-assumeyes\fP options. |
| 625 |
.TP |
| 626 |
.B \fBDNF5_PLUGINS_DIR\fP |
| 627 |
Override a directory with DNF5 application plugins. Set it to an empty |
| 628 |
string to disable loading the application plugins. |
| 629 |
.TP |
| 630 |
.B \fBLIBDNF_PLUGINS_CONFIG_DIR\fP |
| 631 |
Override a directory with libdnf5 plugin\(aqs configuration files. |
| 632 |
.TP |
| 633 |
.B \fBSOURCE_DATE_EPOCH\fP |
| 634 |
Specifies a timestamp given as number of seconds since UNIX epoch. When set, |
| 635 |
transaction timestamps in the history database are set to the specified time |
| 636 |
instead of the current time. Additionally, packages are ordered to ensure |
| 637 |
consistent transaction order. |
| 638 |
.UNINDENT |
| 639 |
.sp |
| 640 |
\fBTEMP\fP, |
| 641 |
\fBTEMPDIR\fP, |
| 642 |
\fBTMP\fP, |
| 643 |
\fBTMPDIR\fP |
| 644 |
.INDENT 0.0 |
| 645 |
.INDENT 3.5 |
| 646 |
Override a path to a directory for temporary files. The directory must |
| 647 |
exist. Default value is \fI/tmp\fP\&. |
| 648 |
.UNINDENT |
| 649 |
.UNINDENT |
| 650 |
.SH SEE ALSO |
| 651 |
.INDENT 0.0 |
| 652 |
.TP |
| 653 |
.B Commands: |
| 654 |
.nf |
| 655 |
\fBdnf5\-advisory(8)\fP, \fI\%Advisory command\fP |
| 656 |
\fBdnf5\-autoremove(8)\fP, \fI\%Autoremove command\fP |
| 657 |
\fBdnf5\-check(8)\fP, \fI\%Check command\fP |
| 658 |
\fBdnf5\-check\-upgrade(8)\fP, \fI\%Check\-Upgrade command\fP |
| 659 |
\fBdnf5\-clean(8)\fP, \fI\%Clean command\fP |
| 660 |
\fBdnf5\-distro\-sync(8)\fP, \fI\%Distro\-Sync command\fP |
| 661 |
\fBdnf5\-downgrade(8)\fP, \fI\%Downgrade command\fP |
| 662 |
\fBdnf5\-download(8)\fP, \fI\%Download command\fP |
| 663 |
\fBdnf5\-environment(8)\fP, \fI\%Environment command\fP |
| 664 |
\fBdnf5\-group(8)\fP, \fI\%Group command\fP |
| 665 |
\fBdnf5\-history(8)\fP, \fI\%History command,\fP |
| 666 |
\fBdnf5\-info(8)\fP, \fI\%Info command\fP |
| 667 |
\fBdnf5\-install(8)\fP, \fI\%Install command\fP |
| 668 |
\fBdnf5\-leaves(8)\fP, \fI\%Leaves command\fP |
| 669 |
\fBdnf5\-list(8)\fP, \fI\%List command\fP |
| 670 |
\fBdnf5\-makecache(8)\fP, \fI\%Makecache command\fP |
| 671 |
\fBdnf5\-mark(8)\fP, \fI\%Mark command\fP |
| 672 |
\fBdnf5\-module(8)\fP, \fI\%Module command\fP |
| 673 |
\fBdnf5\-offline(8)\fP, \fI\%Offline command\fP |
| 674 |
\fBdnf5\-provides(8)\fP, \fI\%Provides command\fP |
| 675 |
\fBdnf5\-reinstall(8)\fP, \fI\%Reinstall command\fP |
| 676 |
\fBdnf5\-remove(8)\fP, \fI\%Remove command\fP |
| 677 |
\fBdnf5\-repo(8)\fP, \fI\%Repo command\fP |
| 678 |
\fBdnf5\-repoquery(8)\fP, \fI\%Repoquery command\fP |
| 679 |
\fBdnf5\-search(8)\fP, \fI\%Search command\fP |
| 680 |
\fBdnf5\-swap(8)\fP, \fI\%Swap command\fP |
| 681 |
\fBdnf5\-system\-upgrade(8)\fP, \fI\%System\-Upgrade command\fP |
| 682 |
\fBdnf5\-upgrade(8)\fP, \fI\%Upgrade command\fP |
| 683 |
\fBdnf5\-versionlock(8)\fP, \fI\%Versionlock command\fP |
| 684 |
.fi |
| 685 |
.sp |
| 686 |
.TP |
| 687 |
.B Application Plugins: |
| 688 |
.nf |
| 689 |
\fBdnf5\-automatic(8)\fP, \fI\%Automatic command\fP |
| 690 |
\fBdnf5\-builddep(8)\fP, \fI\%Builddep command\fP |
| 691 |
\fBdnf5\-changelog(8)\fP, \fI\%Changelog command\fP |
| 692 |
\fBdnf5\-config\-manager(8)\fP, \fI\%Config\-manager command\fP |
| 693 |
\fBdnf5\-copr(8)\fP, \fI\%Copr command\fP |
| 694 |
\fBdnf5\-needs\-restarting(8)\fP, \fI\%Needs\-Restarting command\fP |
| 695 |
\fBdnf5\-repoclosure(8)\fP, \fI\%Repoclosure command\fP |
| 696 |
\fBdnf5\-repomanage(8)\fP, \fI\%Repomanage command\fP |
| 697 |
\fBdnf5\-reposync(8)\fP, \fI\%Reposync command\fP |
| 698 |
.fi |
| 699 |
.sp |
| 700 |
.TP |
| 701 |
.B Library Plugins: |
| 702 |
.nf |
| 703 |
\fBlibdnf5\-actions(8)\fP, \fI\%Actions plugin\fP |
| 704 |
\fBlibdnf5\-expired\-pgp\-keys(8)\fP, \fI\%Expired PGP keys plugin\fP |
| 705 |
\fBlibdnf5\-local(8)\fP, \fI\%Local plugin\fP |
| 706 |
.fi |
| 707 |
.sp |
| 708 |
.TP |
| 709 |
.B Configuration: |
| 710 |
.nf |
| 711 |
\fBdnf5.conf(5)\fP, \fI\%DNF5 Configuration Reference\fP |
| 712 |
.fi |
| 713 |
.sp |
| 714 |
.TP |
| 715 |
.B Miscellaneous: |
| 716 |
.nf |
| 717 |
\fBdnf5\-aliases(7)\fP, \fI\%Aliases for command line arguments\fP |
| 718 |
\fBdnf5\-caching(7)\fP, \fI\%Caching\fP |
| 719 |
\fBdnf5\-comps(7)\fP, \fI\%Comps groups and environments\fP |
| 720 |
\fBdnf5\-filtering(7)\fP, \fI\%Packages filtering,\fP |
| 721 |
\fBdnf5\-forcearch(7)\fP, \fI\%Forcearch parameter\fP |
| 722 |
\fBdnf5\-installroot(7)\fP, \fI\%Installroot parameter\fP |
| 723 |
\fBdnf5\-modularity(7)\fP, \fI\%Modularity overview,\fP |
| 724 |
\fBdnf5\-specs(7)\fP, \fI\%Patterns specification\fP |
| 725 |
\fBdnf5\-system\-state(7)\fP, \fI\%System state\fP |
| 726 |
.fi |
| 727 |
.sp |
| 728 |
.TP |
| 729 |
.B Project homepage: |
| 730 |
.nf |
| 731 |
\X'tty: link https://github.com/rpm-software-management/dnf5'\fI\%https://github.com/rpm\-software\-management/dnf5\fP\X'tty: link' |
| 732 |
.fi |
| 733 |
.sp |
| 734 |
.UNINDENT |
| 735 |
.SH AUTHOR |
| 736 |
See AUTHORS.md in dnf5 source distribution. |
| 737 |
.SH COPYRIGHT |
| 738 |
Contributors to the dnf5 project. |
| 739 |
.\" Generated by docutils manpage writer. |
| 740 |
. |