Scroll to navigation

GPG-WKS-CLIENT(1) User Commands GPG-WKS-CLIENT(1)

NAME

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

SYNOPSIS

gpg-wks-client [COMMAND] [OPTIONS] [ARGS]

DESCRIPTION

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.

COMMANDS

--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:





  

  






gpg --list-key USER-ID








  

  
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.
    

  








OPTIONS



  
-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.
    

  








EXAMPLES




Send a publication request

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.






Confirm a confirmation request

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















SEE ALSO



  
—

  
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>
    

  








BUGS

Please report bugs to <https://dev.gnupg.org>.







COPYRIGHT

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).







  

    May 2017
    gpg-wks-client (GnuPG) 2.1.20