Debian Codegraph @

upstream/debian-unstable/man8/repo-add.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: 11-11-1111
6 .\" Manual: Pacman Manual
7 .\" Source: Pacman 7.1.0
8 .\" Language: English
9 .\"
10 .TH "REPO\-ADD" "8" "11\-11\-1111" "Pacman 7\&.1\&.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\&.bz2\(rq, \(lq\&.tar\&.gz\(rq, \(lq\&.tar\&.lrz\(rq, \(lq\&.tar\&.lz\(rq, \(lq\&.tar\&.lz4\(rq, \(lq\&.tar\&.lzo\(rq, \(lq\&.tar\&.xz\(rq, \(lq\&.tar\&.zst\(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 .PP
81 \fB\-R, \-\-remove\fR
82 .RS 4
83 Remove old package files from the disk when updating or removing their entry in the database\&.
84 .RE
85 .PP
86 \fB\-w, \-\-wait\-for\-lock\fR
87 .RS 4
88 Wait for the lock file to be acquired\&. If unset, command will fail with exit code 2 if acquiring the lock fails\&. If set, it will retry to acquire lock until success\&.
89 .RE
90 .SH "REPO\-ADD OPTIONS"
91 .PP
92 \fB\-n, \-\-new\fR
93 .RS 4
94 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\&.
95 .RE
96 .PP
97 \fB\-p, \-\-prevent\-downgrade\fR
98 .RS 4
99 Do not add package to database if a newer version is already present
100 .RE
101 .PP
102 \fB\-\-include\-sigs\fR
103 .RS 4
104 Include package PGP signatures in the repository database (if available)
105 .RE
106 .SH "EXAMPLE"
107 .sp
108 \fIrepo\-add\fR foo\&.db\&.tar\&.xz <pkg1> [<pkg2> \&...]
109 .sp
110 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\&.
111 .SH "SEE ALSO"
112 .sp
113 \fBmakepkg\fR(8), \fBpacman\fR(8)
114 .sp
115 See the pacman website at https://archlinux\&.org/pacman/ for current information on pacman and its related tools\&.
116 .SH "BUGS"
117 .sp
118 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\&.
119 .SH "AUTHORS"
120 .sp
121 Current maintainers:
122 .sp
123 .RS 4
124 .ie n \{\
125 \h'-04'\(bu\h'+03'\c
126 .\}
127 .el \{\
128 .sp -1
129 .IP \(bu 2.3
130 .\}
131 Allan McRae <allan@archlinux\&.org>
132 .RE
133 .sp
134 .RS 4
135 .ie n \{\
136 \h'-04'\(bu\h'+03'\c
137 .\}
138 .el \{\
139 .sp -1
140 .IP \(bu 2.3
141 .\}
142 Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com>
143 .RE
144 .sp
145 .RS 4
146 .ie n \{\
147 \h'-04'\(bu\h'+03'\c
148 .\}
149 .el \{\
150 .sp -1
151 .IP \(bu 2.3
152 .\}
153 Morgan Adamiec <morganamilo@archlinux\&.org>
154 .RE
155 .sp
156 Past major contributors:
157 .sp
158 .RS 4
159 .ie n \{\
160 \h'-04'\(bu\h'+03'\c
161 .\}
162 .el \{\
163 .sp -1
164 .IP \(bu 2.3
165 .\}
166 Judd Vinet <jvinet@zeroflux\&.org>
167 .RE
168 .sp
169 .RS 4
170 .ie n \{\
171 \h'-04'\(bu\h'+03'\c
172 .\}
173 .el \{\
174 .sp -1
175 .IP \(bu 2.3
176 .\}
177 Aurelien Foret <aurelien@archlinux\&.org>
178 .RE
179 .sp
180 .RS 4
181 .ie n \{\
182 \h'-04'\(bu\h'+03'\c
183 .\}
184 .el \{\
185 .sp -1
186 .IP \(bu 2.3
187 .\}
188 Aaron Griffin <aaron@archlinux\&.org>
189 .RE
190 .sp
191 .RS 4
192 .ie n \{\
193 \h'-04'\(bu\h'+03'\c
194 .\}
195 .el \{\
196 .sp -1
197 .IP \(bu 2.3
198 .\}
199 Dan McGee <dan@archlinux\&.org>
200 .RE
201 .sp
202 .RS 4
203 .ie n \{\
204 \h'-04'\(bu\h'+03'\c
205 .\}
206 .el \{\
207 .sp -1
208 .IP \(bu 2.3
209 .\}
210 Xavier Chantry <shiningxc@gmail\&.com>
211 .RE
212 .sp
213 .RS 4
214 .ie n \{\
215 \h'-04'\(bu\h'+03'\c
216 .\}
217 .el \{\
218 .sp -1
219 .IP \(bu 2.3
220 .\}
221 Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu>
222 .RE
223 .sp
224 .RS 4
225 .ie n \{\
226 \h'-04'\(bu\h'+03'\c
227 .\}
228 .el \{\
229 .sp -1
230 .IP \(bu 2.3
231 .\}
232 Dave Reisner <dreisner@archlinux\&.org>
233 .RE
234 .sp
235 .RS 4
236 .ie n \{\
237 \h'-04'\(bu\h'+03'\c
238 .\}
239 .el \{\
240 .sp -1
241 .IP \(bu 2.3
242 .\}
243 Eli Schwartz <eschwartz@archlinux\&.org>
244 .RE
245 .sp
246 For additional contributors, use git shortlog \-s on the pacman\&.git repository\&.