HKPD(1)

NAME
hkpd - HTTP key protocol daemon

SYNOPSIS
hkpd [-DV] [-f -families] [-H -homedir] [-h -hostname] [-p -port] [-S -keyfilename] [-v -filename]

DESCRIPTION
The hkpd daemon is used to provide public key information on a socket to client programs. The client can request the information in two separate ways, “human” and “machine readable”.

The following options can be used to modify the behaviour of the daemon:

-D  Do not detach the daemon from the controlling tty, and keep the hkpd process running in the foreground.

-f protocol-families
    allows the address families for sockets to be selected. The argument is the string concatenating the families, with “4” representing INET4, and “6” representing INET6. The default value for this parameter is “46” which means that both INET4 and INET6 protocol families are used when setting up the sockets.

-H homedir
    Use the setting of homedir as the directory for the public key keyrings.

-h hostname
    Set the hostname (for use in binding sockets).

-p port
    Set the port number (for use in binding sockets). The default port number is the “hkp” service, defined as port 11371.

-S sshkeyfile
    Serve the ssh public keys found in the key file. The default file for the ssh key is $HOME/.ssh/id_rsa.pub.

-V  Display the version number of the daemon and exit.

-v filename
    Produce extra debugging output from the internal file named filename.

The hkpd daemon is built on libnetpgp(3) and returns public key information as held in the public keyring of the user running the hkpd daemon utility by default.

The information returned to the HKP client is encoded in JSON using the libmj(3) library.

EXIT STATUS
In normal operation, the hkpd daemon will not return.

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

HISTORY
The hkpd command first appeared in NetBSD 6.0.

AUTHORS
Alistair Crooks <agc@NetBSD.org>.