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, security level. 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_CTX_set_security_level(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.