SSL_CTX_add_session(3)SSL_CTX_add_session(3)NAME
SSL_CTX_add_session, SSL_add_session, SSL_CTX_remove_session,
SSL_remove_session - Manipulate session cache
SYNOPSIS
#include <openssl/ssl.h>
int SSL_CTX_add_session(
SSL_CTX *ctx, SSL_SESSION *c ); int SSL_add_session(
SSL_CTX *ctx, SSL_SESSION *c ); int SSL_CTX_remove_session(
SSL_CTX *ctx, SSL_SESSION *c ); int SSL_remove_session(
SSL_CTX *ctx, SSL_SESSION *c );
DESCRIPTION
The SSL_CTX_add_session() function adds the session c to the context
ctx. The reference count for session c is incremented by 1. If a ses‐
sion with the same session id already exists, the old session is
removed by calling SSL_SESSION_free().
The SSL_CTX_remove_session() function removes the session c from the
context ctx. The SSL_SESSION_free() function is called once for c.
The SSL_add_session() and the SSL_remove_session() functions are syn‐
onyms for their SSL_CTX_*() function counterparts.
NOTES
When adding a new session to the internal session cache, it is examined
whether a session with the same session id already exists. In this case
it is assumed that both sessions are identical. If the same session is
stored in a different SSL_SESSION object, the old session is removed
and replaced by the new session. If the session is identical (the
SSL_SESSION object is identical), the SSL_CTX_add_session() function is
a no-op, and the return value is 0.
RETURN VALUES
The following values are returned by all functions: The operation
failed. In the case of the add operation, it tried to add the same ses‐
sion twice. In the case of the remove operation, the session was not
found in the cache. The operation succeeded.
SEE ALSO
Functions: ssl(3), SSL_CTX_set_session_cache_mode(3), SSL_SES‐
SION_free(3)SSL_CTX_add_session(3)