libressl-SSL_SESSION_get_id(3)

libressl-SSL_SESSION_get_id3

Get and set the ssl session id

Usage

SSL Library (libssl, -lssl) libcrypto

#include <openssl/ssl.h>

const unsigned char *

SSL_SESSION_get_id(const SSL_SESSION *s, unsigned int *len);

int

SSL_SESSION_set1_id(SSL_SESSION *s, const unsigned char *sid, unsigned int sid_len);

Overview

SSL_SESSION_get_id() returns a pointer to the internal session ID value for the session s. The length of the ID in bytes is stored in *len. The length may be 0. The caller should not free the returned pointer directly.

SSL_SESSION_set1_id() sets the session ID for s to a copy of the sid of length sid_len.

Return values

SSL_SESSION_get_id() returns a pointer to the session ID value.

SSL_SESSION_set1_id() returns 1 for success and 0 for failure, for example if the supplied session ID length exceeds SSL_MAX_SSL_SESSION_ID_LENGTH.

History

SSL_SESSION_get_id() first appeared in OpenSSL 0.9.8 and has been available since OpenBSD 4.5.

SSL_SESSION_set1_id() first appeared in OpenSSL 1.1.0 and has been available since OpenBSD 6.3.

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