libressl-SSL_new(3)

libressl-SSL_new3

Create a new ssl structure for a connection

Usage

SSL Library (libssl, -lssl) libcrypto

#include <openssl/ssl.h>

SSL *

SSL_new(SSL_CTX *ctx);

int

SSL_up_ref(SSL *ssl);

Overview

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.

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.

From libressl 4.4.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's mdoc source.