create a new SSL structure for a
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
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
SSL_up_ref() first appeared in OpenSSL
1.1.0 and has been available since OpenBSD 6.3.