Index for Section 3

Alphabetical listing for S

Bottom of page

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 session 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 synonyms
  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:

  0	  The operation failed. In the case of the add operation, it tried to
	  add the same session twice. In the case of the remove operation,
	  the  session was not found in the cache.

  1	  The operation succeeded.

SEE ALSO
  Functions: ssl(3), SSL_CTX_set_session_cache_mode(3), SSL_SESSION_free(3)

Index for Section 3

Alphabetical listing for S

Top of page