1keylookup(1) keylookup(1)
2
3
4
6 keylookup - Fetch and Import GnuPG keys from keyservers.
7
8
10 keylookup [options] search-string
11
12
14 keylookup is a wrapper around gpg --search, allowing you to search for
15 keys on a keyserver. It presents the list of matching keys to the user
16 and allows her to select the keys for importing into the GnuPG keyring.
17
18 For the search and actual import of keys GnuPG itself is called.
19
20
21
23 --keyserver=keyserver
24 Specify the keyserver to use. If no keyserver is specified, it
25 will parse the GnuPG options file for a default keyserver to
26 use. If no keyserver can be found, keylookup will abort.
27
28
29 --port=port
30 Use a port other than 11371.
31
32
33 --frontend=frontend
34 keylookup supports displaying the search results with 3 differ‐
35 ent frondends. Both whiptail and dialog are interactive and
36 allow the user to select the keys to import. The third fron‐
37 tend plain is non-interactive and just prints the keys to STD‐
38 OUT. The user must then call GnuPG him/herself.
39
40 If available, /usr/bin/dialog is the default. If it is not
41 available but /usr/bin/whiptail is installed, then this is used
42 instead. If nothing else works, we'll fall back to plain.
43
44
45 --importall
46 Don't ask the user which keys to import, but instead import all
47 keys matching the search-string. If this is given no frontend
48 is needed.
49
50
51 --honor-http-proxy
52 Similar to GnuP keylookup will only honor the http_proxy envi‐
53 ronment variable if this option is given. If it is not given
54 but your GnuPG options file includes it, then keylookup will
55 use it.
56
57
58 --help Print a brief help message and exit succesfully.
59
60
61
62
64 HOME Used to locate the default home directory.
65
66
67 GNUPGHOME If set directory used instead of "~/.gnupg".
68
69
70 http_proxy
71 Only honored when the option --honor-http-proxy is set or
72 honor-http-proxy is set in GnuPG's config file.
73
74
75
76
78 keylookup Christian Kurz
79 will query your default keyserver for Christian's keys and offer
80 you to import them into your keyring with the dialog frontend
81 (if available).
82
83
84 keylookup --honor-http-proxy --frontend plain wk@gnupg
85 will query the default keyserver again, now using the http_proxy
86 if the environment variable is defined and list wk@gnupg's (Wer‐
87 ner Koch)'s key on STDOUT.
88
89
90 keylookup --keyserver pgp.mit.edu Peter Palfrader
91 will now ask the keyserver pgp.mit.edu for my (Peter's) keys and
92 display them for import in dialog.
93
94
95
97 ~/.gnupg/options
98 GnuPG's options file where keylookup will take the keyserver
99 and honor-http-proxy values from if it exists.
100
101
102
104 gpg(1)
105
106
108 Please report bugs using the Debian bug tracking system at
109 http://bugs.debian.org/.
110
111
112
114 Christian Kurz <shorty@debian.org>
115 Peter Palfrader <peter@palfrader.org>
116
117
118
119Jun-2002 keylookup(1)