NAME
SSL_new
,
SSL_up_ref
—
create a new SSL structure for a
connection
SYNOPSIS
#include
<openssl/ssl.h>
SSL *
SSL_new
(SSL_CTX
*ctx);
int
SSL_up_ref
(SSL
*ssl);
DESCRIPTION
SSL_new
()
creates a new SSL structure which is needed to hold
the data for a TLS/SSL connection. The new structure inherits the settings
of the underlying context ctx: connection method,
options, verification settings, timeout settings. The reference count of the
new structure is set to 1.
SSL_up_ref
()
increments the reference count of ssl by 1.
RETURN VALUES
The following return values can occur:
NULL
- The creation of a new SSL structure failed. Check the error stack to find out the reason.
- Pointer to an SSL structure
- The return value points to an allocated SSL structure.
SSL_up_ref
() returns 1 for success or 0
for failure.
SEE ALSO
ssl(3), SSL_clear(3), SSL_CTX_set_options(3), SSL_free(3), SSL_get_SSL_CTX(3)
HISTORY
SSL_new
() appeared in SSLeay 0.4 or
earlier and has been available since OpenBSD
2.4.
SSL_up_ref
() first appeared in OpenSSL
1.1.0 and has been available since OpenBSD 6.3.