SSL_clear

Section: OpenSSL (3ssl)
Updated: 0.9.6c
Index
Return to Main Contents

NAME

SSL_clear - reset SSL object to allow another connection

SYNOPSIS

 #include <openssl/ssl.h>

 int SSL_clear(SSL *ssl);

DESCRIPTION

Reset ssl to allow another connection. All settings (method, ciphers, BIOs) are kept.

NOTES

SSL_clear is used to prepare an SSL object for a new connection. While all settings are kept, a side effect is the handling of the current SSL session. If a session is still open, it is considered bad and will be removed from the session cache, as required by RFC2246. A session is considered open, if SSL_shutdown(3) was not called for the connection or at least SSL_set_shutdown(3) was used to set the SSL_SENT_SHUTDOWN state.

RETURN VALUES

The following return values can occur:

0: The SSL_clear() operation could not be performed. Check the error stack to find out the reason.
1: The SSL_clear() operation was successful.

SSL_new(3), SSL_free(3), SSL_shutdown(3), SSL_set_shutdown(3), SSL_CTX_set_options(3), ssl(3)

This document was created by man2html, using the manual pages.
Time: 10:51:41 GMT, April 25, 2024