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".

       GNUPGBIN  If set used as gpg binary instead of "gpg".

       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>