NAME
SSL_SESSION_get_id
,
SSL_SESSION_set1_id
—
get and set the SSL session
ID
SYNOPSIS
#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);
DESCRIPTION
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
.
SEE ALSO
ssl(3), SSL_copy_session_id(3), SSL_get_session(3), SSL_SESSION_get_compress_id(3), SSL_SESSION_get_protocol_version(3), SSL_SESSION_has_ticket(3), SSL_SESSION_new(3)
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.