NAME    [Toc]    [Back]

       SSL_free - Free an allocated SSL structure

SYNOPSIS    [Toc]    [Back]

       #include <openssl/ssl.h>

       void SSL_free(
               SSL *ssl );

DESCRIPTION    [Toc]    [Back]

       The  SSL_free() function decrements the reference count of
       ssl, and removes the SSL structure pointed to by  ssl  and
       frees  up  the allocated memory if the the reference count
       has reached 0.

NOTES    [Toc]    [Back]

       The SSL_free() function also calls the freeing  procedures
       for  indirectly affected items, if applicable: the buffering
 BIO, the read and write BIOs, cipher  lists  specially
       created  for  this ssl, the SSL_SESSION. Do not explicitly
       free these indirectly freed up items before or after calling
  the SSL_free() function.  Trying to free things twice
       may lead to program failure.

       The ssl session has reference counts from two  users:  the
       SSL  object,  for  which the reference count is removed by
       the SSL_free() function and the internal session cache. If
       the  session is considered bad, because the SSL_shutdown()
       function  was  not  called  for  the  connection  and  the
       SSL_set_shutdown()  function  was  not  used  to  set  the
       SSL_SENT_SHUTDOWN state. The session will also be  removed
       from the session cache as required by RFC2246.

RETURN VALUES    [Toc]    [Back]

       The SSL_free() function does not provide diagnostic information.

SEE ALSO    [Toc]    [Back]

       Functions:  SSL_new(3),   SSL_clear(3),   SSL_shutdown(3),
       SSL_set_shutdown(3), ssl(3)



                                                      SSL_free(3)