.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "DNF5-SWAP" "8" "Sep 06, 2026" "" "dnf5"
.SH NAME
dnf5-swap \- Swap Command
.SH SYNOPSIS
.sp
\fBdnf5 swap [options] <remove\-spec> <install\-spec>\fP
.SH DESCRIPTION
.sp
The \fBswap\fP command in \fBDNF5\fP is used for removing a package while installing
a different one in a single transaction.
Both \fB<remove\-spec>\fP and \fB<install\-spec>\fP are \fB<package\-spec\-NPFB>\fP
.SH OPTIONS
.INDENT 0.0
.TP
.B \fB\-\-allowerasing\fP
.nf
Allow removing of installed packages to resolve any potential dependency problems.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-installed\-from\-repo=REPO_ID,...\fP
.nf
Filters installed packages by the ID of the repository they were installed from.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-from\-repo=REPO_ID,...\fP
.nf
Packages (or their provides) explicitly specified on the command line will only be looked up in the specified repositories.
These repositories are automatically enabled.
Repository enabling and disabling still applies. Dependencies of these packages will be resolved from any enabled repository.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-from\-vendor=VENDOR,...\fP
.nf
List of vendors separated by commas or spaces. Globs are supported (e.g., \fB\-\-from\-vendor=\(aqFedora\e project, vendorA, vendorB*, vendorC\(aq\fP).
Packages (or their provides) explicitly specified on the command line will only be looked up from the specified vendors.
The vendor change check is \fBbypassed\fP for these packages.
The vendor is ignored or vendor change policies (if \fBallow_vendor_change=0\fP) will still be used for packages that satisfy dependencies.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-offline\fP
.nf
Store the transaction to be performed offline. See offline command \%<#\:offline-command-ref-label>, \fBdnf5\-offline(8)\fP\&.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-transient\fP
Applicable only on bootc (bootable containers) systems. Perform transactions using a transient overlay which will be lost on the next reboot. See also the persistence \%<#\:persistence-options-label> configuration option.
.TP
.B \fB\-\-store=PATH\fP
.nf
Store the current transaction in a directory at the specified \fBPATH\fP instead of running it.
The stored transaction can be performed by the replay command \%<#\:replay-command-ref-label>, \fBdnf5\-replay(8)\fP\&.
Note that repository ids in the stored transaction are mangled to \fB@stored_transaction(repo_id)\fP this is required
because during replaying the stored repositories are recreated and they might collide with already present repositories
(this doesn\(aqt apply to the special @System repository).
.fi
.sp
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.TP
.B \fBdnf5 swap mlocate plocate\fP
.nf
Remove the \fBmlocate\fP package and install the \fBplocate\fP instead in the single transaction.
.fi
.sp
.UNINDENT
.SH SEE ALSO
.INDENT 0.0
.INDENT 3.5
.nf
\fBdnf5\-specs(7)\fP, Patterns specification \%<#\:specs-misc-ref-label>
.fi
.sp
.UNINDENT
.UNINDENT
.SH Author
See AUTHORS.md in dnf5 source distribution.
.SH Copyright
Contributors to the dnf5 project.
.\" End of generated man page.