gpg-wks-client - Client for the Web Key Service
gpg-wks-client [COMMAND] [OPTIONS]
[ARGS]
gpg-wks-client is a simple command line client for the Web
Key Service. The executable is usually located in /usr/lib/gnupg. It allows
a user to create a publication request and to respond to a received
confirmation request. Communication with the Web Key Service is done via
email. It also can lookup the fingerprint of a USER-ID in the Web Key
Directory.
- --supported
USER-ID
- Check whether provider of the given USER-ID supports the Web Key Service
protocol, i.e. whether it has a Web Key Directory providing a submission
address.
- Similar to:
gpg-connect-agent --dirmngr 'WKD_GET --submission-address -- USER-ID' /bye
- --check
USER-ID
- Check whether a key is available, and whether the listed key is valid for
the requested USER-ID. You might want to use
gpg -v --auto-key-locate=clear,wkd,nodefault --locate-key USER-ID
- instead.
- --create FINGERPRINT
USER-ID
- Create a publication request for the USER-ID in the key with the given
FINGERPRINT. List all possible keys (including the fingerprint) for a
USER-ID with:
- By default the publication request will be printed to STDOUT. You can also
write it to a file using the --output option or send it using
sendmail with the --send option.
- --receive
- Receive a MIME confirmation request on STDIN and acknowledge it.
- By default the confirmation response will be printed to STDOUT. You can
also write it to a file using the --output option or send it using
sendmail with the --send option.
- --read
- Receive a plain text confirmation request. Similar to --receive,
but takes only the message body on STDIN.
- --version
- Show program version and some meta information.
- -h, --help
- Output a short usage information.
- --warranty
- Print warranty information.
- --dump-options
- Dump all available options and commands.
- -v, --verbose
- Enable verbose output.
- -q, --quiet
- Be somewhat more quiet.
- --send
- Send the mail using sendmail.
- -o, --output
FILE
- Write the mail to FILE.
- --status-fd
FD
- Write status info to this FD.
- --debug
- Set debugging flags. All flags are or-ed and flags may be given in C
syntax (e.g. 0x0042) or as a comma separated list of flag names. To get a
list of all supported flags the single word "help" can be
used.
- --gpg GPG
- Use the specified command instead of gpg.
- --fake-submission-addr
MAILADDR
- Send mail to MAILADDR instead of the submission address queried through
Web Key Service.
First find the fingerprint (a long string of hex digits) of the
key you want to publish:
gpg --list-key "Alice <alice@example.com>"
Now create and send the publication request:
/usr/lib/gnupg/gpg-wks-client --create --send 0123456789ABCDEF0123456789ABCDEF01234567 "Alice <alice@example.com>"
Instead of "Alice <alice@example.com>" you
can also just give alice@example.com.
Paste the full mail containing the confirmation request (including
headers) you got from the Web Key Service on STDIN after starting:
/usr/lib/gnupg/gpg-wks-client --receive --send
- —
- Latest draft for the protocol:
<https://tools.ietf.org/html/draft-koch-openpgp-webkey-service>
- —
- GnuPG on Web Key Service: <https://wiki.gnupg.org/WKS>
Please report bugs to <https://dev.gnupg.org>.
Copyright © 2017 Free Software Foundation, Inc. License
GPLv3+: GNU GPL version 3 or later
<https://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
This manpage was written by Stefan Bühler for the
Debian distribution (but may be used by others).