libressl-SSL_get_server_tmp_key(3)

libressl-SSL_get_server_tmp_key3

Temporary server key during a handshake

Usage

SSL Library (libssl, -lssl) libcrypto

#include <openssl/ssl.h>

long

SSL_get_server_tmp_key(SSL *ssl, EVP_PKEY **key);

Overview

SSL_get_server_tmp_key() retrieves the temporary key provided by the server and used during key exchange. For example, if ECDHE is in use, this represents the server's public ECDHE key.

In case of success, a copy of the key is stored in *key. It is the caller's responsibility to free this key after use using EVP_PKEY_free(3).

This function may only be called by the client.

This function is implemented as a macro.

Return values

SSL_get_server_tmp_key() returns 1 on success or 0 on failure.

History

SSL_get_server_tmp_key() first appeared in OpenSSL 1.0.2 and has been available since OpenBSD 6.1.

From libressl 4.4.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's mdoc source.