168651Skris=pod 268651Skris 368651Skris=head1 NAME 468651Skris 568651SkrisSSL_CTX_free - free an allocated SSL_CTX object 668651Skris 768651Skris=head1 SYNOPSIS 868651Skris 968651Skris #include <openssl/ssl.h> 1068651Skris 1168651Skris void SSL_CTX_free(SSL_CTX *ctx); 1268651Skris 1368651Skris=head1 DESCRIPTION 1468651Skris 1568651SkrisSSL_CTX_free() decrements the reference count of B<ctx>, and removes the 1668651SkrisSSL_CTX object pointed to by B<ctx> and frees up the allocated memory if the 1768651Skristhe reference count has reached 0. 1868651Skris 1968651SkrisIt also calls the free()ing procedures for indirectly affected items, if 2076866Skrisapplicable: the session cache, the list of ciphers, the list of Client CAs, 2168651Skristhe certificates and keys. 2268651Skris 23120631Snectar=head1 WARNINGS 24120631Snectar 25120631SnectarIf a session-remove callback is set (SSL_CTX_sess_set_remove_cb()), this 26120631Snectarcallback will be called for each session being freed from B<ctx>'s 27120631Snectarsession cache. This implies, that all corresponding sessions from an 28120631Snectarexternal session cache are removed as well. If this is not desired, the user 29120631Snectarshould explicitly unset the callback by calling 30120631SnectarSSL_CTX_sess_set_remove_cb(B<ctx>, NULL) prior to calling SSL_CTX_free(). 31120631Snectar 3268651Skris=head1 RETURN VALUES 3368651Skris 3468651SkrisSSL_CTX_free() does not provide diagnostic information. 3568651Skris 3689837Skris=head1 SEE ALSO 3789837Skris 38120631SnectarL<SSL_CTX_new(3)|SSL_CTX_new(3)>, L<ssl(3)|ssl(3)>, 39120631SnectarL<SSL_CTX_sess_set_get_cb(3)|SSL_CTX_sess_set_get_cb(3)> 4068651Skris 4168651Skris=cut 42