SSL_NEW(3)

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.