Debian Codegraph @

upstream/debian-trixie/man8/repo-remove.8

raw
1 '\" t
2 .\" Title: repo-add
3 .\" Author: [see the "Authors" section]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: 2025-01-20
6 .\" Manual: Pacman Manual
7 .\" Source: Pacman 7.0.0
8 .\" Language: English
9 .\"
10 .TH "REPO\-ADD" "8" "2025\-01\-20" "Pacman 7\&.0\&.0" "Pacman Manual"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 repo-add \- package database maintenance utility
32 .SH "SYNOPSIS"
33 .sp
34 \fIrepo\-add\fR [options] <path\-to\-db> <package> [<package> \&...]
35 .sp
36 \fIrepo\-remove\fR [options] <path\-to\-db> <packagename> [<packagename> \&...]
37 .SH "DESCRIPTION"
38 .sp
39 \fIrepo\-add\fR and \fIrepo\-remove\fR are two scripts to help build a package database for packages built with \fBmakepkg\fR(8) and installed with \fBpacman\fR(8)\&.
40 .sp
41 \fIrepo\-add\fR will update a package database by reading a built package file\&. Multiple packages to add can be specified on the command line\&.
42 .sp
43 If a matching \(lq\&.sig\(rq file is found alongside a package file, the signature will automatically be embedded into the database\&.
44 .sp
45 \fIrepo\-remove\fR will update a package database by removing the package name specified on the command line\&. Multiple packages to remove can be specified on the command line\&.
46 .sp
47 A package database is a tar file, optionally compressed\&. Valid extensions are \(lq\&.db\(rq followed by an archive extension of \(lq\&.tar\(rq, \(lq\&.tar\&.gz\(rq, \(lq\&.tar\&.bz2\(rq, \(lq\&.tar\&.xz\(rq, or \(lq\&.tar\&.Z\(rq\&. The file does not need to exist, but all parent directories must exist\&.
48 .SH "COMMON OPTIONS"
49 .PP
50 \fB\-q, \-\-quiet\fR
51 .RS 4
52 Force this program to keep quiet and run silently except for warning and error messages\&.
53 .RE
54 .PP
55 \fB\-s, \-\-sign\fR
56 .RS 4
57 Generate a PGP signature file using GnuPG\&. This will execute
58 gpg \-\-detach\-sign
59 on the generated database to generate a detached signature file, using the GPG agent if it is available\&. The signature file will be the entire filename of the database with a \(lq\&.sig\(rq extension\&.
60 .RE
61 .PP
62 \fB\-k, \-\-key\fR <key>
63 .RS 4
64 Specify a key to use when signing packages\&. Can also be specified using the GPGKEY environment variable\&. If not specified in either location, the default key from the keyring will be used\&.
65 .RE
66 .PP
67 \fB\-v, \-\-verify\fR
68 .RS 4
69 Verify the PGP signature of the database before updating the database\&. If the signature is invalid, an error is produced and the update does not proceed\&.
70 .RE
71 .PP
72 \fB\-\-nocolor\fR
73 .RS 4
74 Remove color from
75 \fIrepo\-add\fR
76 and
77 \fIrepo\-remove\fR
78 output\&.
79 .RE
80 .SH "REPO\-ADD OPTIONS"
81 .PP
82 \fB\-n, \-\-new\fR
83 .RS 4
84 Only add packages that are not already in the database\&. Warnings will be printed upon detection of existing packages, but they will not be re\-added\&.
85 .RE
86 .PP
87 \fB\-R, \-\-remove\fR
88 .RS 4
89 Remove old package files from the disk when updating their entry in the database\&.
90 .RE
91 .PP
92 \fB\-\-include\-sigs\fR
93 .RS 4
94 Include package PGP signatures in the repository database (if available)
95 .RE
96 .SH "EXAMPLE"
97 .sp
98 \fIrepo\-add\fR foo\&.db\&.tar\&.xz <pkg1> [<pkg2> \&...]
99 .sp
100 This creates two separate databases; a smaller database \(lqfoo\&.db\&.tar\&.xz\(rq used by pacman and a large database containing package file lists \(lqfoo\&.files\&.tar\&.xz\(rq for use by other utilities\&. While pacman can use the large database (if renamed with a db\&.tar* extension), there is currently no additional benefit for the larger download\&.
101 .SH "SEE ALSO"
102 .sp
103 \fBmakepkg\fR(8), \fBpacman\fR(8)
104 .sp
105 See the pacman website at https://archlinux\&.org/pacman/ for current information on pacman and its related tools\&.
106 .SH "BUGS"
107 .sp
108 Bugs? You must be kidding; there are no bugs in this software\&. But if we happen to be wrong, please report them to the issue tracker at https://gitlab\&.archlinux\&.org/pacman/pacman/\-/issues with specific information such as your command\-line, the nature of the bug, and even the package database if it helps\&.
109 .SH "AUTHORS"
110 .sp
111 Current maintainers:
112 .sp
113 .RS 4
114 .ie n \{\
115 \h'-04'\(bu\h'+03'\c
116 .\}
117 .el \{\
118 .sp -1
119 .IP \(bu 2.3
120 .\}
121 Allan McRae <allan@archlinux\&.org>
122 .RE
123 .sp
124 .RS 4
125 .ie n \{\
126 \h'-04'\(bu\h'+03'\c
127 .\}
128 .el \{\
129 .sp -1
130 .IP \(bu 2.3
131 .\}
132 Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com>
133 .RE
134 .sp
135 .RS 4
136 .ie n \{\
137 \h'-04'\(bu\h'+03'\c
138 .\}
139 .el \{\
140 .sp -1
141 .IP \(bu 2.3
142 .\}
143 Morgan Adamiec <morganamilo@archlinux\&.org>
144 .RE
145 .sp
146 Past major contributors:
147 .sp
148 .RS 4
149 .ie n \{\
150 \h'-04'\(bu\h'+03'\c
151 .\}
152 .el \{\
153 .sp -1
154 .IP \(bu 2.3
155 .\}
156 Judd Vinet <jvinet@zeroflux\&.org>
157 .RE
158 .sp
159 .RS 4
160 .ie n \{\
161 \h'-04'\(bu\h'+03'\c
162 .\}
163 .el \{\
164 .sp -1
165 .IP \(bu 2.3
166 .\}
167 Aurelien Foret <aurelien@archlinux\&.org>
168 .RE
169 .sp
170 .RS 4
171 .ie n \{\
172 \h'-04'\(bu\h'+03'\c
173 .\}
174 .el \{\
175 .sp -1
176 .IP \(bu 2.3
177 .\}
178 Aaron Griffin <aaron@archlinux\&.org>
179 .RE
180 .sp
181 .RS 4
182 .ie n \{\
183 \h'-04'\(bu\h'+03'\c
184 .\}
185 .el \{\
186 .sp -1
187 .IP \(bu 2.3
188 .\}
189 Dan McGee <dan@archlinux\&.org>
190 .RE
191 .sp
192 .RS 4
193 .ie n \{\
194 \h'-04'\(bu\h'+03'\c
195 .\}
196 .el \{\
197 .sp -1
198 .IP \(bu 2.3
199 .\}
200 Xavier Chantry <shiningxc@gmail\&.com>
201 .RE
202 .sp
203 .RS 4
204 .ie n \{\
205 \h'-04'\(bu\h'+03'\c
206 .\}
207 .el \{\
208 .sp -1
209 .IP \(bu 2.3
210 .\}
211 Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu>
212 .RE
213 .sp
214 .RS 4
215 .ie n \{\
216 \h'-04'\(bu\h'+03'\c
217 .\}
218 .el \{\
219 .sp -1
220 .IP \(bu 2.3
221 .\}
222 Dave Reisner <dreisner@archlinux\&.org>
223 .RE
224 .sp
225 .RS 4
226 .ie n \{\
227 \h'-04'\(bu\h'+03'\c
228 .\}
229 .el \{\
230 .sp -1
231 .IP \(bu 2.3
232 .\}
233 Eli Schwartz <eschwartz@archlinux\&.org>
234 .RE
235 .sp
236 For additional contributors, use git shortlog \-s on the pacman\&.git repository\&.