keylookup(1)															      keylookup(1)

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>

Jun-2002															      keylookup(1)