X-Git-Url: https://git.sthu.org/?a=blobdiff_plain;f=keylookup%2Fkeylookup.1;h=d5d2d703b373e32902394513b2bde1866ecaf227;hb=8b16f5d3cdfc8dd2886d86fabd7467c65b687c86;hp=c652a9e9d757f7642ee137a92d462369a5214de6;hpb=407b3c3541e264ab1a0362d50a51c9d84a49757d;p=pgp-tools.git diff --git a/keylookup/keylookup.1 b/keylookup/keylookup.1 index c652a9e..d5d2d70 100644 --- a/keylookup/keylookup.1 +++ b/keylookup/keylookup.1 @@ -1,33 +1,33 @@ .TH keylookup 1 "" Jun-2002 "" .\" manual page (c) 2000, 2001, 2002 Christian Kurz, Peter Palfrader -.\" $Id: keylookup.1,v 1.6 2002/06/17 14:18:13 weasel Exp $ +.\" $Id$ .SH NAME .LP -keylookup \- Fetch and Import GnuPG keys from keyservers. +keylookup - Fetch and Import GnuPG keys from keyservers. .SH SYNOPSIS \fBkeylookup\fP [\fIoptions\fP] \fIsearch-string\fP .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. +\fBkeylookup\fR 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 actual import of keys GnuPG itself is called. +For the search and actual import of keys GnuPG itself is called. .SH OPTIONS -.IP "\fB--keyserver\fP=\fIkeyserver\fP" 8 +.IP "\fB\-\-keyserver\fP=\fIkeyserver\fP" 8 Specify the keyserver to use. If no keyserver is specified, it -will parse the GnuPG optiosn file for a default keyserver to use. +will parse the GnuPG options file for a default keyserver to use. If no keyserver can be found, \fBkeylookup\fP will abort. -.IP "\fB--port\fP=\fIport\fP" 8 +.IP "\fB\-\-port\fP=\fIport\fP" 8 Use a port other than 11371. -.IP "\fB--frontend\fP=\fIfrontend\fP" 8 +.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. @@ -38,18 +38,18 @@ 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 +.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 +.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--help\fP" 8 +.IP "\fB\-\-help\fP" 8 Print a brief help message and exit succesfully. @@ -63,8 +63,8 @@ Used to locate the default home directory. If set directory used instead of "~/.gnupg". .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. +Only honored when the option \-\-honor\-http\-proxy is set or +honor\-http\-proxy is set in GnuPG's config file. @@ -74,12 +74,12 @@ set in GnuPG's config file. 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" +.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" +.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. @@ -88,20 +88,21 @@ 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. +and honor\-http\-proxy values from if it exists. .SH "SEE ALSO" -\fBgpg\fP(1), \fBhttp://www.palfrader.org/keylookup/\fP +\fBgpg\fP(1) .SH BUGS .LP -Please report bugs to shorty@debian.org and peter@palfrader.org. +Please report bugs using the Debian bug tracking system at +http://bugs.debian.org/. -.SH AUTHOR +.SH AUTHORS .LP Christian Kurz