SSL_NEW(3)

✨ NAME ✨

okay so welcome to SSL_NEW(3) — yes bestie, this is the Library Functions Manual page for SSL_new and SSL_up_ref, and it is literally here to help you create a new SSL structure for a connection. 🎀

• SSL_new, SSL_up_ref — create a new SSL structure for a connection

🌸 SYNOPSIS 🌸

here's the exact synopsis, no cap:

library “libssl” libcrypto #include <openssl/ssl.h>

SSL *
SSL_new(SSL_CTX *ctx);

int
SSL_up_ref(SSL *ssl);

💖 DESCRIPTION 💖

SSL_new() creates a new SSL structure, and you literally need this 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. slay. ✨

SSL_up_ref() increments the reference count of ssl by 1. that's the whole assignment, bestie. 💅

🦋 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 🌈

go give these a vibe check:

• 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. that's some ancient icon behavior, fr fr. SSL_up_ref() first appeared in OpenSSL 1.1.0 and has been available since OpenBSD 6.3. periodt. 🧚

xoxo bestie, this page is from Debian, dated June 8, 2025, and it's the SSL_NEW(3) manual page — bye! 💖✨