doc/pacman-key.8.txt

   1 /////
   2 vim:set ts=4 sw=4 syntax=asciidoc noet spell spelllang=en_us:
   3 /////
   4 pacman-key(8)
   5 =============
   6
   7
   8 Name
   9 ----
  10 pacman-key - manage pacman's list of trusted keys
  11
  12
  13 Synopsis
  14 --------
  15 'pacman-key' [options]
  16
  17
  18 Description
  19 -----------
  20 'pacman-key' is a wrapper script for GnuPG used to manage pacman's keyring, which
  21 is the collection of PGP keys used to check signed packages and databases. It
  22 provides the ability to import and export keys, fetch keys from keyservers and
  23 update the key trust database.
  24
  25 More complex keyring management can be achieved using GnuPG directly combined with
  26 the `--homedir` option pointing at the pacman keyring (located in
  27 +{sysconfdir}/pacman.d/gnupg+ by default).
  28
  29
  30 Options
  31 -------
  32 *-a, \--add* [file(s)]::
  33         Add the key(s) contained in the specified file or files to pacman's
  34         keyring. If a key already exists, update it.
  35
  36 *\--config* <file>::
  37         Use an alternate config file instead of the +{sysconfdir}/pacman.conf+
  38         default.
  39
  40 *-d, \--delete* <keyid(s)>::
  41         Remove the key(s) identified by the specified keyid(s) from pacman's
  42         keyring.
  43
  44 *-e, \--export* [keyid(s)]::
  45         Export key(s) identified by the specified keyid(s) to 'stdout'. If no keyid
  46         is specified, all keys will be exported.
  47
  48 *\--edit-key * <keyid(s)>::
  49         Present a menu for key management task on the specified keyids. Useful for
  50         adjusting a keys trust level.
  51
  52 *-f, \--finger* [keyid(s)]::
  53         List a fingerprint for each specified keyid, or for all known keys if no
  54         keyids are specified.
  55
  56 *\--gpgdir* <dir>::
  57         Set an alternate home directory for GnuPG. If unspecified, the value is
  58         read from +{sysconfdir}/pacman.conf+.
  59
  60 *-h, \--help*::
  61         Output syntax and command line options.
  62
  63 *--import* <dir(s)>::
  64         Adds keys from pubring.gpg into pacman's keyring and imports ownertrust
  65         values from trustdb.gpg in the specified directories.
  66
  67 *--import-dirs* <dir(s)> ::
  68         Imports ownertrust values from trustdb.gpg in the specified directories.
  69
  70 *--init*::
  71         Ensure the keyring is properly initialized and has the required access
  72         permissions.
  73
  74 *-l, \--list-keys* [keyid(s)]::
  75         Lists all or specified keys from the public keyring.
  76
  77 *--list-sigs* [keyid(s)]::
  78         Same as --list-keys, but the signatures are listed too.
  79
  80 *-r, \--receive* <keyserver> <keyid(s)>::
  81         Fetch the specified keyids from the specified key server URL.
  82
  83 *\--reload*::
  84         Reloads the keys from the keyring package.
  85
  86 *-u, \--updatedb*::
  87         Equivalent to \--check-trustdb in GnuPG.
  88
  89 * -v, \--verify* <signature>::
  90         Verify the given signature file.
  91
  92 *-V, \--version*::
  93         Displays the program version.
  94
  95
  96 See Also
  97 --------
  98 linkman:pacman[8], linkman:pacman.conf[5]
  99
 100 include::footer.txt[]