summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGuillaume Alaux <guillaume@alaux.net>2010-11-20 23:15:05 +1000
committerDan McGee <dan@archlinux.org>2011-03-23 01:59:42 -0500
commit482da2ecebaccd520a2934f853ed632d8a648b94 (patch)
tree3b3d9da2242756ab978d890c9cd0af1686a82a96
parent5a89a12aa012ceb3ee03ad4ced8d8bde44176e6f (diff)
downloadpacman-482da2ecebaccd520a2934f853ed632d8a648b94.tar.xz
Add man-page for pacman-key
Signed-off-by: Allan McRae <allan@archlinux.org>
-rw-r--r--doc/.gitignore1
-rw-r--r--doc/Makefile.am4
-rw-r--r--doc/pacman-key.8.txt76
3 files changed, 81 insertions, 0 deletions
diff --git a/doc/.gitignore b/doc/.gitignore
index a6f4df7f..4c4e158d 100644
--- a/doc/.gitignore
+++ b/doc/.gitignore
@@ -3,6 +3,7 @@ libalpm.3
makepkg.8
makepkg.conf.5
pacman.8
+pacman-key.8
pacman.conf.5
repo-add.8
repo-remove.8
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 00a0e88d..ed9bb000 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -8,6 +8,7 @@ ASCIIDOC_MANS = \
makepkg.8 \
repo-add.8 \
vercmp.8 \
+ pacman-key.8 \
PKGBUILD.5 \
makepkg.conf.5 \
pacman.conf.5 \
@@ -20,6 +21,7 @@ HTML_MANPAGES = \
makepkg.8.html \
repo-add.8.html \
vercmp.8.html \
+ pacman-key.8.html \
PKGBUILD.5.html \
makepkg.conf.5.html \
pacman.conf.5.html \
@@ -41,6 +43,7 @@ EXTRA_DIST = \
makepkg.8.txt \
repo-add.8.txt \
vercmp.8.txt \
+ pacman-key.8.txt \
PKGBUILD.5.txt \
PKGBUILD-example.txt \
makepkg.conf.5.txt \
@@ -133,6 +136,7 @@ pacman.8 pacman.8.html: pacman.8.txt
makepkg.8 makepkg.8.html: makepkg.8.txt
repo-add.8 repo-add.8.html: repo-add.8.txt
vercmp.8 vercmp.8.html: vercmp.8.txt
+pacman-key.8 pacman-key.8.html: pacman-key.8.txt
PKGBUILD.5 PKGBUILD.5.html: PKGBUILD.5.txt PKGBUILD-example.txt
makepkg.conf.5 makepkg.conf.5.html: makepkg.conf.5.txt
pacman.conf.5 pacman.conf.5.html: pacman.conf.5.txt
diff --git a/doc/pacman-key.8.txt b/doc/pacman-key.8.txt
new file mode 100644
index 00000000..5ebbd0a2
--- /dev/null
+++ b/doc/pacman-key.8.txt
@@ -0,0 +1,76 @@
+/////
+vim:set ts=4 sw=4 syntax=asciidoc noet:
+/////
+pacman-key(8)
+=============
+
+
+Name
+----
+pacman-key - manage pacman's list of trusted keys
+
+
+Synopsis
+--------
+*pacman-key* [options] *command* ['arguments']
+
+
+Description
+-----------
+The script *pacman-key* manage *pacman*'s keyring, which is the collection of GnuPG keys used to check signed packages.
+It provides the ability to import and export keys, fetch keys from keyservers and update the key trust database.
+
+
+Options
+-------
+*\--config* 'file'::
+ Set an alternative configuration file to use (default is {sysconfdir}/pacman.conf)
+
+*\--gpgdir* 'directory'::
+ Set an alternative home directory for GnuPG (default is set in {sysconfdir}/pacman.conf)
+
+
+Commands
+-------
+*-a*, *\--add* 'file ...'::
+ Add the key(s) contained in 'file'(s) to pacman's keyring. If a key already exists, update it.
+
+*\--adv* 'param ...'::
+ Use this option to issue particular GnuPG actions to pacman's keyring. This option should be used with care as it can modify pacman's trust in packages' signatures.
+
+*-d*, *\--del* 'keyid ...'::
+ Remove the key(s) identified by 'keyid'(s) from pacman's keyring
+
+*-e*, *\--export* ['keyid ...']::
+ Export key(s) identified by 'keyid'(s) to STDOUT or all keys if no 'keyid' is specified
+
+*-f*, *\--finger* ['keyid ...']::
+ List fingerprint(s) for specified 'keyid'(s) or for all if none is specified
+
+*\--help*::
+ Display short usage instructions
+
+*-l*, *\--list*::
+ Equivalent to --list-sigs from GnuPG
+
+*-r*, *\--receive* 'keyserver' 'keyid ...'::
+ Fetch the 'keyid'(s) from the specified 'keyserver' URL
+
+*\--reload*::
+ Reloads the keys from the keyring package
+
+*-t*, *\--trust* 'keyid'::
+ Set the trust level of the given key
+
+*-u*, *\--updatedb*::
+ Equivalent to \--check-trustdb in GnuPG
+
+*-v*, *\--version*::
+ Displays the current version
+
+
+See Also
+--------
+linkman:pacman.conf[5]
+
+include::footer.txt[]