SSL_CTX_ADD_SESSION(3) OpenSSL SSL_CTX_ADD_SESSION(3)
SSL_CTX_add_session, SSL_add_session,
SSL_CTX_remove_session, SSL_remove_session - manipulate ses-
sion cache
#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);
SSL_CTX_add_session() adds the session c to the context ctx.
The reference count for session c is incremented by 1. If a
session with the same session id already exists, the old
session is removed by calling SSL_SESSION_free(3).
SSL_CTX_remove_session() removes the session c from the con-
text ctx. SSL_SESSION_free(3) is called once for c.
SSL_add_session() and SSL_remove_session() are synonyms for
their SSL_CTX_*() counterparts.
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 ses-
sions are identical. If the same session is stored in a dif-
ferent SSL_SESSION object, The old session is removed and
replaced by the new session. If the session is actually
identical (the SSL_SESSION object is identical),
SSL_CTX_add_session() is a no-op, and the return value is 0.
If a server SSL_CTX is configured with the
SSL_SESS_CACHE_NO_INTERNAL_STORE flag then the internal
cache will not be populated automatically by new sessions
negotiated by the SSL/TLS implementation, even though the
internal cache will be searched automatically for session-
resume requests (the latter can be surpressed by
SSL_SESS_CACHE_NO_INTERNAL_LOOKUP). So the application can
use SSL_CTX_add_session() directly to have full control over
the sessions that can be resumed if desired.
The following values are returned by all functions:
0
MirOS BSD #10-current 2005-02-05 1
SSL_CTX_ADD_SESSION(3) OpenSSL SSL_CTX_ADD_SESSION(3)
The operation failed. In case of the add operation, it was tried to add
the same (identical) session twice. In case of the remove operation, the
session was not found in the cache.
1
The operation succeeded.
ssl(3), SSL_CTX_set_session_cache_mode(3),
SSL_SESSION_free(3)
MirOS BSD #10-current 2005-02-05 2
Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $
These manual pages and other documentation are copyrighted by their respective writers;
their source is available at our CVSweb,
AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material
provided by Thorsten Glaser.
This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.