Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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 differ-
	       ent frondends. Both whiptail and	dialog are interactive and al-
	       low 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	 envi-
	       ronment	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
       https://bugs.debian.org/.

AUTHORS
       Christian Kurz <shorty@debian.org>
       Peter Palfrader <peter@palfrader.org>

Jun-2002							  keylookup(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=keylookup&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help