.\" manual page (c) 2000, 2001, 2002 Christian Kurz, Peter Palfrader
.\" manual page (c) 2000, 2001, 2002 Christian Kurz, Peter Palfrader
.SH DESCRIPTION
.LP
\fBkeylookup\fR is a perl script that queries a keyserver for keys
matching the \fIsearch-string\fP. It shows a list to the user and offers
her/him to select the keys for importing into her/his GnuPG keyring.
.SH DESCRIPTION
.LP
\fBkeylookup\fR is a perl script that queries a keyserver for keys
matching the \fIsearch-string\fP. It shows a list to the user and offers
her/him to select the keys for importing into her/his GnuPG keyring.
.SH OPTIONS
.IP "\fB--keyserver\fP=\fIkeyserver\fP" 8
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, \fBkeylookup\fP will abort.
.SH OPTIONS
.IP "\fB--keyserver\fP=\fIkeyserver\fP" 8
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, \fBkeylookup\fP will abort.
.IP "\fB--frontend\fP=\fIfrontend\fP" 8
\fBkeylookup\fP supports displaying the search results with 3
different frondends. Both \fBwhiptail\fP and \fBdialog\fP are
interactive and allow the user to select the keys to import.
The third frontend \fBplain\fP is non\-interactive and just
prints the keys to STDOUT. The user must then call GnuPG him/herself.
.IP "\fB--frontend\fP=\fIfrontend\fP" 8
\fBkeylookup\fP supports displaying the search results with 3
different frondends. Both \fBwhiptail\fP and \fBdialog\fP are
interactive and allow the user to select the keys to import.
The third frontend \fBplain\fP is non\-interactive and just
prints the keys to STDOUT. The user must then call GnuPG him/herself.
If available, \fB/usr/bin/dialog\fP is the default. If it is not
available but \fB/usr/bin/whiptail\fP is installed, then this is
used instead. If nothing else works, we'll fall back to \fBplain\fP.
If available, \fB/usr/bin/dialog\fP is the default. If it is not
available but \fB/usr/bin/whiptail\fP is installed, then this is
used instead. If nothing else works, we'll fall back to \fBplain\fP.
.IP "\fB--importall\fP" 8
Don't ask the user which keys to import, but instead import all
keys matching the \fIsearch-string\fP. If this is given no
frontend is needed.
.IP "\fB--importall\fP" 8
Don't ask the user which keys to import, but instead import all
keys matching the \fIsearch-string\fP. If this is given no
frontend is needed.
.IP "\fB--honor-http-proxy\fP" 8
Similar to GnuP \fBkeylookup\fP will only honor the \fBhttp_proxy\fP
environment variable if this option is given. If it is not given
but your GnuPG options file includes it, then \fBkeylookup\fP will
use it.
.IP "\fB--honor-http-proxy\fP" 8
Similar to GnuP \fBkeylookup\fP will only honor the \fBhttp_proxy\fP
environment variable if this option is given. If it is not given
but your GnuPG options file includes it, then \fBkeylookup\fP will
use it.
.IP "http_proxy" 10
Only honored when the option --honor-http-proxy is set or honor-http-proxy is
set in GnuPG's config file.
.IP "http_proxy" 10
Only honored when the option --honor-http-proxy is set or honor-http-proxy is
set in GnuPG's config file.
.IP "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).
.IP "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).
.IP "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.
.IP "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.
.IP "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.
.IP "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.
.IP "~/.gnupg/options" 10
GnuPG's options file where \fBkeylookup\fP will take the keyserver
and honor-http-proxy values from if it exists.
.IP "~/.gnupg/options" 10
GnuPG's options file where \fBkeylookup\fP will take the keyserver
and honor-http-proxy values from if it exists.