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