keylookup/keylookup.1

   1 .TH keylookup 1 "" 2005-08-16 ""
   2 .\" manual page (c) 2000, 2001, 2002 Christian Kurz, Peter Palfrader
   3 .\" manual page (c) 2005 Christoph Berg
   4 .\" $Id$
   5 .SH NAME
   6 .LP
   7 keylookup \- Fetch and Import GnuPG keys from keyservers.
   8 .SH SYNOPSIS
   9 \fBkeylookup\fP [\fIoptions\fP] \fIsearch-string\fP
  10 .SH DESCRIPTION
  11 .LP
  12 \fBkeylookup\fR is a perl script that queries a keyserver for keys
  13 matching the \fIsearch-string\fP. It shows a list to the user and offers
  14 her/him to select the keys for importing into her/his GnuPG keyring.
  15 For the actual import of keys GnuPG itself is called.
  16 .SH OPTIONS
  17 .IP "\fB--keyserver\fP=\fIkeyserver\fP" 8
  18 Specify the keyserver to use. If no keyserver is specified, it
  19 will parse the GnuPG options file for a default keyserver to use.
  20 If no keyserver can be found, \fBkeylookup\fP will abort.
  21 .IP "\fB--port\fP=\fIport\fP" 8
  22 Use a port other than 11371.
  23 .IP "\fB--frontend\fP=\fIfrontend\fP" 8
  24 \fBkeylookup\fP supports displaying the search results with 3
  25 different frondends. Both \fBwhiptail\fP and \fBdialog\fP are
  26 interactive and allow the user to select the keys to import.
  27 The third frontend \fBplain\fP is non\-interactive and just
  28 prints the keys to STDOUT. The user must then call GnuPG him/herself.
  29 If available, \fB/usr/bin/dialog\fP is the default. If it is not
  30 available but \fB/usr/bin/whiptail\fP is installed, then this is
  31 used instead. If nothing else works, we'll fall back to \fBplain\fP.
  32 .IP "\fB--importall\fP" 8
  33 Don't ask the user which keys to import, but instead import all
  34 keys matching the \fIsearch-string\fP. If this is given no
  35 frontend is needed.
  36 .IP "\fB--honor-http-proxy\fP" 8
  37 Similar to GnuP \fBkeylookup\fP will only honor the \fBhttp_proxy\fP
  38 environment variable if this option is given. If it is not given
  39 but your GnuPG options file includes it, then \fBkeylookup\fP will
  40 use it.
  41 .IP "\fB--help\fP" 8
  42 Print a brief help message and exit succesfully.
  43 .SH ENVIRONMENT
  44 .IP "HOME" 10
  45 Used to locate the default home directory.
  46 .IP "GNUPGHOME" 10
  47 If set directory used instead of "~/.gnupg".
  48 .IP "http_proxy" 10
  49 Only honored when the option --honor-http-proxy is set or honor-http-proxy is
  50 set in GnuPG's config file.
  51 .SH EXAMPLES
  52 .IP "keylookup Christian Kurz"
  53 will query your default keyserver for Christian's keys and offer you to
  54 import them into your keyring with the dialog frontend (if available).
  55 .IP "keylookup --honor-http-proxy --frontend plain wk@gnupg"
  56 will query the default keyserver again, now using the http_proxy if
  57 the environment variable is defined and list wk@gnupg's (Werner Koch)'s key
  58 on STDOUT.
  59 .IP "keylookup --keyserver pgp.mit.edu Peter Palfrader"
  60 will now ask the keyserver pgp.mit.edu for my (Peter's) keys and
  61 display them for import in dialog.
  62 .SH FILES
  63 .IP "~/.gnupg/options"  10
  64 GnuPG's options file where \fBkeylookup\fP will take the keyserver
  65 and honor-http-proxy values from if it exists.
  66 .SH "SEE ALSO"
  67 \fBgpg\fP(1)
  68 .SH BUGS
  69 .LP
  70 Please report bugs using the Debian bug tracking system at
  71 http://bugs.debian.org/.
  72 .SH AUTHORS
  73 .LP
  74 Christian Kurz <shorty@debian.org>
  75 .br
  76 Peter Palfrader <peter@palfrader.org>