NAME
keylookup - Fetch and Import GnuPG keys from keyservers.
SYNOPSIS
keylookup [options] search-string
DESCRIPTION
keylookup is a wrapper around gpg --search, allowing you to search for
keys on a keyserver. It presents the list of matching keys to the user
and allows her to select the keys for importing into the GnuPG keyring.
For the search and actual import of keys GnuPG itself is called.
OPTIONS
--keyserver=keyserver
Specify the keyserver to use. If no keyserver is specified, it
will parse the GnuPG options file for a default keyserver to
use. If no keyserver can be found, keylookup will abort.
--port=port
Use a port other than 11371.
--frontend=frontend
keylookup supports displaying the search results with 3
different frondends. Both whiptail and dialog are interactive
and allow the user to select the keys to import. The third
frontend plain is non-interactive and just prints the keys to
STDOUT. The user must then call GnuPG him/herself.
If available, /usr/bin/dialog is the default. If it is not
available but /usr/bin/whiptail is installed, then this is used
instead. If nothing else works, we’ll fall back to plain.
--importall
Don’t ask the user which keys to import, but instead import all
keys matching the search-string. If this is given no frontend
is needed.
--honor-http-proxy
Similar to GnuP keylookup will only honor the http_proxy
environment variable if this option is given. If it is not
given but your GnuPG options file includes it, then keylookup
will use it.
--help Print a brief help message and exit successfully.
ENVIRONMENT
HOME Used to locate the default home directory.
GNUPGHOME If set directory used instead of "~/.gnupg".
http_proxy
Only honored when the option --honor-http-proxy is set or
honor-http-proxy is set in GnuPG’s config file.
EXAMPLES
keylookup Christian Kurz
will query your default keyserver for Christian’s keys and offer
you to import them into your keyring with the dialog frontend
(if available).
keylookup --honor-http-proxy --frontend plain wk@gnupg
will query the default keyserver again, now using the http_proxy
if the environment variable is defined and list wk@gnupg’s
(Werner Koch)’s key on STDOUT.
keylookup --keyserver pgp.mit.edu Peter Palfrader
will now ask the keyserver pgp.mit.edu for my (Peter’s) keys and
display them for import in dialog.
FILES
~/.gnupg/options
GnuPG’s options file where keylookup will take the keyserver
and honor-http-proxy values from if it exists.
SEE ALSO
gpg(1)
BUGS
Please report bugs using the Debian bug tracking system at
http://bugs.debian.org/.
AUTHORS
Christian Kurz <shorty@debian.org>
Peter Palfrader <peter@palfrader.org>