SSL_COPY_SESSION_ID(3)

💅 SSL_COPY_SESSION_ID(3) — Library Functions Manual 💅

✨ NAME ✨

SSL_copy_session_id — okay so this is the little function that copies session details between SSL objects, periodt.

🌸 SYNOPSIS 🌸

#include <openssl/ssl.h>

int
SSL_copy_session_id(SSL *to, const SSL *from);

🦋 DESCRIPTION 🦋

SSL_copy_session_id() is giving “clone the session-ish bits from one SSL object into another.” It copies the following data from from to to:

• the pointer to the SSL_SESSION object — and its reference count gets incremented by 1, no cap
• the pointer to the SSL_METHOD object; if that changes the method, protocol-specific data is reinitialized
• the pointer to the CERT object — reference count incremented by 1 too, slay
• the session ID context

Fun fact iykyk: this function is used internally by SSL_dup(3) and by BIO_ssl_copy_session_id(3).

🎀 RETURN VALUES 🎀

SSL_copy_session_id() returns 1 on success and 0 on error. That’s it, bestie.

🌈 SEE ALSO 🌈

• BIO_ssl_copy_session_id(3)
• ssl(3)
• SSL_dup(3)
• SSL_get_session(3)
• SSL_SESSION_get_id(3)
• SSL_SESSION_new(3)
• SSL_set_session(3)
• SSL_set_session_id_context(3)

👑 HISTORY 👑

SSL_copy_session_id() appeared in SSLeay 0.4 or earlier and has been available since OpenBSD 2.4. lowkey iconic longevity.

💀 BUGS 💀

okay so this is the sketchy part: failures of CRYPTO_add(3) are silently ignored and may leave to in an invalid or inconsistent state. not the vibe.

---

source/version + date sign-off: source/version: Debian · date: June 12, 2019 · page name: SSL_COPY_SESSION_ID(3) 💖🫶