libressl-SSL_CTX_sessions(3)

libressl-SSL_CTX_sessions3

Access internal session cache

Usage

SSL Library (libssl, -lssl) libcrypto

#include <openssl/ssl.h>

LHASH_OF(SSL_SESSION) *

SSL_CTX_sessions(SSL_CTX *ctx);

Overview

SSL_CTX_sessions() returns a pointer to the lhash databases containing the internal session cache for ctx.

The sessions in the internal session cache are kept in an lhash-type database (see lh_new(3)). It is possible to directly access this database, e.g., for searching. In parallel, the sessions form a linked list which is maintained separately from the lhash operations, so that the database must not be modified directly but by using the SSL_CTX_add_session(3) family of functions.

History

SSL_CTX_sessions() first appeared in SSLeay 0.5.2 and has been available since OpenBSD 2.4.

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