Debian Codegraph @

upstream/debian-unstable/man8/dnf5-swap.8

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