Debian Codegraph @

upstream/mageia-cauldron/man8/dnf5-swap.8

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-SWAP" "8" "May 10, 2026" "" "dnf5"
31 .SH NAME
32 dnf5-swap \- Swap Command
33 .SH SYNOPSIS
34 .sp
35 \fBdnf5 swap [options] <remove\-spec> <install\-spec>\fP
36 .SH DESCRIPTION
37 .sp
38 The \fBswap\fP command in \fBDNF5\fP is used for removing a package while installing
39 a different one in a single transaction.
40 Both \fB<remove\-spec>\fP and \fB<install\-spec>\fP are \fB<package\-spec\-NPFB>\fP
41 .SH OPTIONS
42 .INDENT 0.0
43 .TP
44 .B \fB\-\-allowerasing\fP
45 .nf
46 Allow removing of installed packages to resolve any potential dependency problems.
47 .fi
48 .sp
49 .UNINDENT
50 .INDENT 0.0
51 .TP
52 .B \fB\-\-installed\-from\-repo=REPO_ID,...\fP
53 .nf
54 Filters installed packages by the ID of the repository they were installed from.
55 .fi
56 .sp
57 .UNINDENT
58 .INDENT 0.0
59 .TP
60 .B \fB\-\-from\-repo=REPO_ID,...\fP
61 .nf
62 Packages (or their provides) explicitly specified on the command line will only be looked up in the specified repositories.
63 These repositories are automatically enabled.
64 Repository enabling and disabling still applies. Dependencies of these packages will be resolved from any enabled repository.
65 .fi
66 .sp
67 .UNINDENT
68 .INDENT 0.0
69 .TP
70 .B \fB\-\-from\-vendor=VENDOR,...\fP
71 .nf
72 List of vendors separated by commas or spaces. Globs are supported (e.g., \fB\-\-from\-vendor=\(aqFedora\e project, vendorA, vendorB*, vendorC\(aq\fP).
73 Packages (or their provides) explicitly specified on the command line will only be looked up from the specified vendors.
74 The vendor change check is \fBbypassed\fP for these packages.
75 The vendor is ignored or vendor change policies (if \fBallow_vendor_change=0\fP) will still be used for packages that satisfy dependencies.
76 .fi
77 .sp
78 .UNINDENT
79 .INDENT 0.0
80 .TP
81 .B \fB\-\-offline\fP
82 .nf
83 Store the transaction to be performed offline. See \fI\%offline command\fP, \fBdnf5\-offline(8)\fP\&.
84 .fi
85 .sp
86 .TP
87 .B \fB\-\-store=PATH\fP
88 .nf
89 Store the current transaction in a directory at the specified \fBPATH\fP instead of running it.
90 The stored transaction can be performed by the \fI\%replay command\fP, \fBdnf5\-replay(8)\fP\&.
91 Note that repository ids in the stored transaction are mangled to \fB@stored_transaction(repo_id)\fP this is required
92 because during replaying the stored repositories are recreated and they might collide with already present repositories
93 (this doesn\(aqt apply to the special @System repository).
94 .fi
95 .sp
96 .UNINDENT
97 .SH EXAMPLES
98 .INDENT 0.0
99 .TP
100 .B \fBdnf5 swap mlocate plocate\fP
101 .nf
102 Remove the \fBmlocate\fP package and install the \fBplocate\fP instead in the single transaction.
103 .fi
104 .sp
105 .UNINDENT
106 .SH SEE ALSO
107 .INDENT 0.0
108 .INDENT 3.5
109 .nf
110 \fBdnf5\-specs(7)\fP, \fI\%Patterns specification\fP
111 .fi
112 .sp
113 .UNINDENT
114 .UNINDENT
115 .SH AUTHOR
116 See AUTHORS.md in dnf5 source distribution.
117 .SH COPYRIGHT
118 Contributors to the dnf5 project.
119 .\" Generated by docutils manpage writer.
120 .