Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

SSL_CTX_free (3openssl)

Name

SSL_CTX_free - free an allocated SSL_CTX object

Synopsis

#include <openssl/ssl.h>

void SSL_CTX_free(SSL_CTX *ctx);

Description

SSL_CTX_free(3openssl)              OpenSSL             SSL_CTX_free(3openssl)



NAME
       SSL_CTX_free - free an allocated SSL_CTX object

SYNOPSIS
        #include <openssl/ssl.h>

        void SSL_CTX_free(SSL_CTX *ctx);

DESCRIPTION
       SSL_CTX_free() decrements the reference count of ctx, and removes the
       SSL_CTX object pointed to by ctx and frees up the allocated memory if
       the the reference count has reached 0.

       It also calls the free()ing procedures for indirectly affected items,
       if applicable: the session cache, the list of ciphers, the list of
       Client CAs, the certificates and keys.

WARNINGS
       If a session-remove callback is set (SSL_CTX_sess_set_remove_cb()),
       this callback will be called for each session being freed from ctx's
       session cache. This implies, that all corresponding sessions from an
       external session cache are removed as well. If this is not desired, the
       user should explicitly unset the callback by calling
       SSL_CTX_sess_set_remove_cb(ctx, NULL) prior to calling SSL_CTX_free().

RETURN VALUES
       SSL_CTX_free() does not provide diagnostic information.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+--------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE      |
       +---------------+--------------------------+
       |Availability   | library/security/openssl |
       +---------------+--------------------------+
       |Stability      | Pass-through uncommitted |
       +---------------+--------------------------+

SEE ALSO
       SSL_CTX_new(3), ssl(3), SSL_CTX_sess_set_get_cb(3)



NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       https://www.openssl.org/source/openssl-1.0.2ze.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.openssl.org/.



1.0.2ze                           2022-05-03            SSL_CTX_free(3openssl)