Debian Codegraph @

upstream/debian-unstable/man8/pacman-key.8

raw
1 '\" t
2 .\" Title: pacman-key
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 "PACMAN\-KEY" "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 pacman-key \- manage pacman\*(Aqs list of trusted keys
32 .SH "SYNOPSIS"
33 .sp
34 \fIpacman\-key\fR [options] operation [targets]
35 .SH "DESCRIPTION"
36 .sp
37 \fIpacman\-key\fR is a wrapper script for GnuPG used to manage pacman\(cqs keyring, which is the collection of PGP keys used to check signed packages and databases\&. It provides the ability to import and export keys, fetch keys from keyservers and update the key trust database\&.
38 .sp
39 More complex keyring management can be achieved using GnuPG directly combined with the \fI\-\-homedir\fR option pointing at the pacman keyring (located in /etc/pacman\&.d/gnupg by default)\&.
40 .sp
41 Invoking pacman\-key consists of supplying an operation with any potential options and targets to operate on\&. Depending on the operation, a \fItarget\fR may be a valid key identifier, filename, or directory\&.
42 .SH "OPERATIONS"
43 .PP
44 \fB\-a, \-\-add\fR
45 .RS 4
46 Add the key(s) contained in the specified file or files to pacman\(cqs keyring\&. If a key already exists, update it\&.
47 .RE
48 .PP
49 \fB\-d, \-\-delete\fR
50 .RS 4
51 Remove the key(s) identified by the specified keyid(s) from pacman\(cqs keyring\&.
52 .RE
53 .PP
54 \fB\-e, \-\-export\fR
55 .RS 4
56 Export key(s) identified by the specified keyid(s) to
57 \fIstdout\fR\&. If no keyid is specified, all keys will be exported\&.
58 .RE
59 .PP
60 \fB\-\-edit\-key\fR
61 .RS 4
62 Present a menu for key management task on the specified keyid(s)\&. Useful for adjusting a keys trust level\&.
63 .RE
64 .PP
65 \fB\-f, \-\-finger\fR
66 .RS 4
67 List a fingerprint for each specified keyid, or for all known keys if no keyids are specified\&.
68 .RE
69 .PP
70 \fB\-h, \-\-help\fR
71 .RS 4
72 Output syntax and command line options\&.
73 .RE
74 .PP
75 \fB\-\-import\fR
76 .RS 4
77 Imports keys from
78 pubring\&.gpg
79 into the public keyring from the specified directories\&.
80 .RE
81 .PP
82 \fB\-\-import\-trustdb\fR
83 .RS 4
84 Imports ownertrust values from
85 trustdb\&.gpg
86 into the shared trust database from the specified directories\&.
87 .RE
88 .PP
89 \fB\-\-init\fR
90 .RS 4
91 Ensure the keyring is properly initialized and has the required access permissions\&.
92 .RE
93 .PP
94 \fB\-l, \-\-list\-keys\fR
95 .RS 4
96 Lists all or specified keys from the public keyring\&.
97 .RE
98 .PP
99 \fB\-\-list\-sigs\fR
100 .RS 4
101 Same as
102 \fI\-\-list\-keys\fR, but the signatures are listed too\&.
103 .RE
104 .PP
105 \fB\-\-lsign\-key\fR
106 .RS 4
107 Locally sign the given key\&. This is primarily used to root the web of trust in the local private key generated by
108 \fI\-\-init\fR\&.
109 .RE
110 .PP
111 \fB\-\-nocolor\fR
112 .RS 4
113 Disable colored output from pacman\-key\&.
114 .RE
115 .PP
116 \fB\-r, \-\-recv\-keys\fR
117 .RS 4
118 Equivalent to
119 \fI\-\-recv\-keys\fR
120 in GnuPG\&.
121 .RE
122 .PP
123 \fB\-\-refresh\-keys\fR
124 .RS 4
125 Equivalent to
126 \fI\-\-refresh\-keys\fR
127 in GnuPG\&.
128 .RE
129 .PP
130 \fB\-\-populate\fR
131 .RS 4
132 Reload the default keys from the (optionally provided) keyrings in
133 /usr/share/keyrings\&. For more information, see
134 Providing a Keyring for Import
135 below\&.
136 .RE
137 .PP
138 \fB\-u, \-\-updatedb\fR
139 .RS 4
140 Equivalent to
141 \fI\-\-check\-trustdb\fR
142 in GnuPG\&. This operation can be specified with other operations\&.
143 .RE
144 .PP
145 \fB\-V, \-\-version\fR
146 .RS 4
147 Displays the program version\&.
148 .RE
149 .PP
150 \fB\-v, \-\-verify\fR
151 .RS 4
152 Assume that the first argument is a signature and verify it\&. If a second argument is provided, it is the file to be verified\&.
153 .sp
154 With only one argument given, assume that the signature is a detached signature, and look for a matching data file to verify by stripping the file extension\&. If no matching data file is found, fall back on GnuPG semantics and attempt to verify a file with an embedded signature\&.
155 .RE
156 .SH "OPTIONS"
157 .PP
158 \fB\-\-config\fR <file>
159 .RS 4
160 Use an alternate configuration file instead of the
161 /etc/pacman\&.conf
162 default\&.
163 .RE
164 .PP
165 \fB\-\-gpgdir\fR <dir>
166 .RS 4
167 Set an alternate home directory for GnuPG\&. If unspecified, the value is read from
168 /etc/pacman\&.conf\&.
169 .RE
170 .PP
171 \fB\-\-keyserver\fR <keyserver>
172 .RS 4
173 Use the specified keyserver if the operation requires one\&. This will take precedence over any keyserver option specified in a
174 gpg\&.conf
175 configuration file\&. Running
176 \fI\-\-init\fR
177 with this option will set the default keyserver if one was not already configured\&.
178 .RE
179 .SH "PROVIDING A KEYRING FOR IMPORT"
180 .sp
181 A distribution or other repository provided may want to provide a set of PGP keys used in the signing of its packages and repository databases that can be readily imported into the pacman keyring\&. This is achieved by providing a PGP keyring file foo\&.gpg that contains the keys for the foo keyring in the directory /usr/share/keyrings\&.
182 .sp
183 Optionally, the file foo\-trusted can be provided containing a list of trusted key IDs for that keyring\&. This is a file in a format compatible with \fIgpg \-\-export\-ownertrust\fR output\&. This file will inform the user which keys a user needs to verify and sign to build a local web of trust, in addition to assigning provided owner trust values\&.
184 .sp
185 Also optionally, the file foo\-revoked can be provided containing a list of revoked key IDs for that keyring\&. Revoked is defined as "no longer valid for any signing", so should be used with prudence\&. A key being marked as revoked will be disabled in the keyring and no longer treated as valid, so this always takes priority over it\(cqs trusted state in any other keyring\&.
186 .SH "SEE ALSO"
187 .sp
188 \fBpacman\fR(8), \fBpacman.conf\fR(5)
189 .sp
190 See the pacman website at https://archlinux\&.org/pacman/ for current information on pacman and its related tools\&.
191 .SH "BUGS"
192 .sp
193 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\&.
194 .SH "AUTHORS"
195 .sp
196 Current maintainers:
197 .sp
198 .RS 4
199 .ie n \{\
200 \h'-04'\(bu\h'+03'\c
201 .\}
202 .el \{\
203 .sp -1
204 .IP \(bu 2.3
205 .\}
206 Allan McRae <allan@archlinux\&.org>
207 .RE
208 .sp
209 .RS 4
210 .ie n \{\
211 \h'-04'\(bu\h'+03'\c
212 .\}
213 .el \{\
214 .sp -1
215 .IP \(bu 2.3
216 .\}
217 Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com>
218 .RE
219 .sp
220 .RS 4
221 .ie n \{\
222 \h'-04'\(bu\h'+03'\c
223 .\}
224 .el \{\
225 .sp -1
226 .IP \(bu 2.3
227 .\}
228 Morgan Adamiec <morganamilo@archlinux\&.org>
229 .RE
230 .sp
231 Past major contributors:
232 .sp
233 .RS 4
234 .ie n \{\
235 \h'-04'\(bu\h'+03'\c
236 .\}
237 .el \{\
238 .sp -1
239 .IP \(bu 2.3
240 .\}
241 Judd Vinet <jvinet@zeroflux\&.org>
242 .RE
243 .sp
244 .RS 4
245 .ie n \{\
246 \h'-04'\(bu\h'+03'\c
247 .\}
248 .el \{\
249 .sp -1
250 .IP \(bu 2.3
251 .\}
252 Aurelien Foret <aurelien@archlinux\&.org>
253 .RE
254 .sp
255 .RS 4
256 .ie n \{\
257 \h'-04'\(bu\h'+03'\c
258 .\}
259 .el \{\
260 .sp -1
261 .IP \(bu 2.3
262 .\}
263 Aaron Griffin <aaron@archlinux\&.org>
264 .RE
265 .sp
266 .RS 4
267 .ie n \{\
268 \h'-04'\(bu\h'+03'\c
269 .\}
270 .el \{\
271 .sp -1
272 .IP \(bu 2.3
273 .\}
274 Dan McGee <dan@archlinux\&.org>
275 .RE
276 .sp
277 .RS 4
278 .ie n \{\
279 \h'-04'\(bu\h'+03'\c
280 .\}
281 .el \{\
282 .sp -1
283 .IP \(bu 2.3
284 .\}
285 Xavier Chantry <shiningxc@gmail\&.com>
286 .RE
287 .sp
288 .RS 4
289 .ie n \{\
290 \h'-04'\(bu\h'+03'\c
291 .\}
292 .el \{\
293 .sp -1
294 .IP \(bu 2.3
295 .\}
296 Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu>
297 .RE
298 .sp
299 .RS 4
300 .ie n \{\
301 \h'-04'\(bu\h'+03'\c
302 .\}
303 .el \{\
304 .sp -1
305 .IP \(bu 2.3
306 .\}
307 Dave Reisner <dreisner@archlinux\&.org>
308 .RE
309 .sp
310 .RS 4
311 .ie n \{\
312 \h'-04'\(bu\h'+03'\c
313 .\}
314 .el \{\
315 .sp -1
316 .IP \(bu 2.3
317 .\}
318 Eli Schwartz <eschwartz@archlinux\&.org>
319 .RE
320 .sp
321 For additional contributors, use git shortlog \-s on the pacman\&.git repository\&.