OpenBSD manual page server

Manual Page Search Parameters

SSL_NEW(3) Library Functions Manual SSL_NEW(3)

SSL_new, SSL_up_refcreate a new SSL structure for a connection

#include <openssl/ssl.h>

SSL *
SSL_new(SSL_CTX *ctx);

int
SSL_up_ref(SSL *ssl);

() 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.

() increments the reference count of ssl by 1.

The following return values can occur:

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.

ssl(3), SSL_clear(3), SSL_CTX_set_options(3), SSL_CTX_set_security_level(3), SSL_free(3), SSL_get_SSL_CTX(3)

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.

July 13, 2022 OpenBSD-current