HKPC(1)

NAME
hkpc - retrieve public key information via HKP

SYNOPSIS
hkpc [-f -address-family] [-h -hostname] [-p -port] [get|index|vindex] userid...

DESCRIPTION
The hkpc command retrieves public key information from the key server daemon using the HKP protocol. The hkpd(8) is normally used to retrieve public key information.

Three types of information can be retrieved from the server:

get The public key, base64-encoded, corresponding to the given userid is returned. The userid can be a numeric value, a unique part of the human identifier, or left blank. The first matching key will be returned, in a format suitable for importing to a keyring via the netpgpkeys(1) command.

index
    the information returned from this command is the same as provided by the netpgpkeys(1) command, using the --list-keys modifier.

vindex
    the information returned from this command is the same as provided by the netpgpkeys(1) command, using the --list-sigs modifier.

For this utility to provide the correct results, an hkpd server must be listening using the correct protocol family, on the provided port on the appropriate server. The default port for the HKP server is 11371, whilst the hostname defaults to localhost.

The netpgp suite of libraries and commands provides a convenient client in hkpd(1).

The information is sent to the server in the form of an HTTP GET command, and is returned as a JSON-encoded HKP packet. libmj(3) is used to decode the JSON in the returned HKP packet.

EXIT STATUS
The hkpc utility will return 0 for success, or 1 for failure. Output will be printed on stdout.

SEE ALSO
hkpd(1), netpgpkeys(1), ssh(1), libmj(3), libnetpgp(3)

STANDARDS
J. Callas, L. Donnerhacke, H. Finney, D. Shaw, R. Thayer, November 2007, RFC 4880, OpenPGP Message Format.

HISTORY
The hkpc command first appeared in NetBSD 6.0.

AUTHORS
Alistair Crooks <agc@NetBSD.org>.