NAME    [Toc]    [Back]

       SSL_CTX_add_session,  SSL_add_session, SSL_CTX_remove_session,
 SSL_remove_session - Manipulate session cache

SYNOPSIS    [Toc]    [Back]

       #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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       The  following  values  are returned by all functions: 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.
       The operation succeeded.

SEE ALSO    [Toc]    [Back]

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



                                           SSL_CTX_add_session(3)