summaryrefslogtreecommitdiffstats
path: root/doc/gpg.texi
diff options
context:
space:
mode:
authorWerner Koch <wk@gnupg.org>2019-07-04 15:13:26 +0200
committerWerner Koch <wk@gnupg.org>2019-07-04 15:13:26 +0200
commitd00c8024e58822e0623b3fad99248ce68a8b7725 (patch)
tree414888fefeb31f7a455a610b39fc9ec4c832f561 /doc/gpg.texi
parentgpg: Make the get_pubkey_byname interface easier to understand. (diff)
downloadgnupg2-d00c8024e58822e0623b3fad99248ce68a8b7725.tar.xz
gnupg2-d00c8024e58822e0623b3fad99248ce68a8b7725.zip
gpg: New command --locate-external-key.
* g10/gpg.c (aLocateExtKeys): New. (opts): Add --locate-external-keys. (main): Implement that. * g10/getkey.c (get_pubkey_byname): Implement GET_PUBKEY_NO_LOCAL. (get_best_pubkey_byname): Add arg 'mode' and pass on to get_pubkey_byname. Change callers. * g10/keylist.c (public_key_list): Add arg 'no_local'. (locate_one): Ditto. Pass on to get_best_pubkey_byname. -- This new command is a shortcut for --auto-key-locate nodefault,clear,wkd,... --locate-key and uses the default or configured AKL list but does so without local. See also GnuPG-bug-id: 4599 Signed-off-by: Werner Koch <wk@gnupg.org>
Diffstat (limited to 'doc/gpg.texi')
-rw-r--r--doc/gpg.texi13
1 files changed, 9 insertions, 4 deletions
diff --git a/doc/gpg.texi b/doc/gpg.texi
index 5822dfdd6..8feab8218 100644
--- a/doc/gpg.texi
+++ b/doc/gpg.texi
@@ -346,12 +346,17 @@ numbers 1-9 or "T" for 10 and above to indicate trust signature levels
@item --locate-keys
+@itemx --locate-external-keys
@opindex locate-keys
+@opindex locate-external-keys
Locate the keys given as arguments. This command basically uses the
-same algorithm as used when locating keys for encryption or signing and
-may thus be used to see what keys @command{@gpgname} might use. In
-particular external methods as defined by @option{--auto-key-locate} may
-be used to locate a key. Only public keys are listed.
+same algorithm as used when locating keys for encryption or signing
+and may thus be used to see what keys @command{@gpgname} might use.
+In particular external methods as defined by
+@option{--auto-key-locate} may be used to locate a key. Only public
+keys are listed. The variant @option{--locate-external-keys} does not
+consider a locally existing key and can thus be used to force the
+refresh of a key via the defined external methods.
@item --show-keys
@opindex show-keys