Prevent segfault when parsing unexpected sync database file
[pacman-ng.git] / doc / pacman-key.8.txt
blob892f14dfdb324c69e0578d017e922f9b31abc298
1 /////
2 vim:set ts=4 sw=4 syntax=asciidoc noet:
3 /////
4 pacman-key(8)
5 =============
8 Name
9 ----
10 pacman-key - manage pacman's list of trusted keys
13 Synopsis
14 --------
15 'pacman-key' [options] <command> [arguments]
18 Description
19 -----------
20 'pacman-key' is a script used to manage pacman's keyring, which is the collection
21 of GnuPG keys used to check signed packages. It provides the ability to import
22 and export keys, fetch keys from keyservers and update the key trust database.
25 Options
26 -------
27 *\--config* <file>::
28         Use an alternate config file instead of the +{sysconfdir}/pacman.conf+
29         default.
31 *\--gpgdir* <dir>::
32         Set an alternate home directory for GnuPG. If unspecified, the value is
33         read from +{sysconfdir}/pacman.conf+.
36 Commands
37 -------
38 *-a, \--add* file ...::
39         Add the key(s) contained in the specified file or files to pacman's
40         keyring. If a key already exists, update it.
42 *\--adv* param ...::
43         Use this option to issue particular GnuPG actions to pacman's keyring. This
44         option should be used with care as it can modify pacman's trust in
45         packages' signatures.
47 *-d, \--del* keyid ...::
48         Remove the key(s) identified by the specified keyid or keyids from pacman's
49         keyring.
51 *-e, \--export* [keyid ...]::
52         Export key(s) identified by the specified keyid to 'stdout'. If no keyid is
53         specified, all keys will be exported.
55 *-f, \--finger* [keyid ...]::
56         List a fingerprint for each specified keyid, or for all known keys if no
57         keyids are specified.
59 *-h, \--help*::
60         Output syntax and command line options.
62 *-l, \--list*::
63         Equivalent to --list-sigs from GnuPG.
65 *-r, \--receive* keyserver keyid ...::
66         Fetch the specified keyids from the specified key server URL.
68 *\--reload*::
69         Reloads the keys from the keyring package.
71 *-t, \--trust* keyid::
72         Set the trust level of the given key.
74 *-u, \--updatedb*::
75         Equivalent to \--check-trustdb in GnuPG.
77 *-v, \--version*::
78         Displays the program version.
81 See Also
82 --------
83 linkman:pacman[8], linkman:pacman.conf[5]
85 include::footer.txt[]