tlshd - Man Page
TLS handshake for kernel TLS sockets
Synopsis
/usr/sbin/tlshd [options]
Description
The tlshd program implements a user agent that services TLS handshake requests on behalf of kernel TLS consumers. Using the accept(2) system call, it materializes kernel socket endpoints in user space in order to perform TLS handshakes using a TLS library. After each handshake completes, tlshd plants TLS session metadata into the kernel socket to enable the use of kTLS to secure subsequent communication on that socket.
Options
- -c or --config
When specified this option sets the location for tlshd's config file.
- -h or --help
When specified tlshd displays a help message then exits immediately.
- -s or --stderr
When specified this option forces messages to go to both stderr and the system log. By default, messages go only to the system log.
- -v or --version
When specified tlshd displays build version information then exits immediately.
Environment Variables
The GnuTLS library provides certain capabilities that can be enabled by setting environment variables before tlshd is started. More information about these variables is available in GnuTLS library documentation.
- SSLKEYLOGFILE
When set, this variable specifies the pathname of a file to which the GnuTLS library appends negotiated session keys in the NSS Key Log format. The NSS Key Log format can be read by wireshark, enabling decryption of recorded sessions.
- GNUTLS_FORCE_FIPS_MODE
When set to `1', this variable forces the TLS library into FIPS mode if FIPS140-2 support is available.
Notes
This software is a prototype. It's purpose is for demonstration and as a proof-of-concept. USE THIS SOFTWARE AT YOUR OWN RISK.
See Also
tlshd.conf(5), ssl(7)
Author
Chuck Lever