gpg-wks-client(1)

1GPG-WKS-CLIENT(1)            GNU Privacy Guard 2.2           GPG-WKS-CLIENT(1)
2
3
4

NAME

6       gpg-wks-client - Client for the Web Key Service
7

SYNOPSIS

9       gpg-wks-client [options] --supported user-id
10       gpg-wks-client [options] --check user-id
11       gpg-wks-client [options] --create fingerprint user-id
12       gpg-wks-client [options] --receive
13       gpg-wks-client [options] --read
14
15

DESCRIPTION

17       The  gpg-wks-client  is  used  to  send  requests  to a Web Key Service
18       provider.  This is usuallay done to upload a key into a Web Key  Direc‐
19       tory.
20
21       With  the  --supported  command the caller can test whether a site sup‐
22       ports the Web Key Service.  The argument is an arbitray address in  the
23       to  be  tested  domain.  For  example  ‘foo@example.net’.   The command
24       returns success if the Web Key Service is supported.  The operation  is
25       silent; to get diagnostic output use the option --verbose.
26
27       With the --check command the caller can test whether a key exists for a
28       supplied mail address.  The command returns success if a key is  avail‐
29       able.
30
31       The  --create  command is used to send a request for publication in the
32       Web Key Directory.  The arguments are the fingerprint of  the  key  and
33       the user id to publish.  The output from the command is a properly for‐
34       matted mail with all standard headers.  This mail can be fed  to  send‐
35       mail(8)  or  any other tool to actually send that mail.  If sendmail(8)
36       is installed the option --send can be used to directly send the created
37       request.   If the provider request a 'mailbox-only' user id and no such
38       user id is found, gpg-wks-client will try an additional user id.
39
40       The --receive and --read commands  are  used  to  process  confirmation
41       mails  as  send  from  the  service  provider.   The  former expects an
42       encrypted MIME messages, the latter an already decrypted MIME  message.
43       The  result of these commands are another mail which can be send in the
44       same way as the mail created with --create.
45
46       gpg-wks-client is not commonly invoked directly  and  thus  it  is  not
47       installed  in  the  bin  directory.   Here  is an example how it can be
48       invoked manually to check for a Web Key Directory entry for  ‘foo@exam‐
49       ple.org’:
50
51         $(gpgconf --list-dirs libexecdir)/gpg-wks-client --check foo@example.net
52
53

OPTIONS

55       gpg-wks-client understands these options:
56
57
58
59       --send Directly   send   created  mails  using  the  sendmail  command.
60              Requires installation of that command.
61
62
63       --output file
64       -o     Write the created mail to file instead of stdout.  Note that the
65              value - for file is the same as writing to stdout.
66
67
68       --status-fd n
69              Write  special  status  strings  to the file descriptor n.  This
70              program returns only the  status  messages  SUCCESS  or  FAILURE
71              which  are  helpful  when the caller uses a double fork approach
72              and can't easily get the return code of the process.
73
74
75       --verbose
76              Enable extra informational output.
77
78
79       --quiet
80              Disable almost all informational output.
81
82
83       --version
84              Print version of the program and exit.
85
86
87       --help Display a brief help page and exit.
88
89

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

SEE ALSO