SSL_GET_RBIO(3)

📦 version 4.4.0, in alpine 3.24, arch rolling

💅 SSL_GET_RBIO 💅

okay bestie, welcome to the libssl girlies — this one's a tiny little cutie from the OpenSSL corner of the universe, and it's honestly so straightforward you're gonna slay it.

✨ NAME ✨

SSL_get_rbio, SSL_get_wbio — get the BIO that's linked to an SSL object 🎀

🦋 SYNOPSIS 🦋

library “libssl” libcrypto

#include <openssl/ssl.h>

BIO *
SSL_get_rbio(SSL *ssl);

BIO *
SSL_get_wbio(SSL *ssl);

🌸 DESCRIPTION 🌸

okay so picture this: your SSL object has a read channel and a write channel, and they're not necessarily the same thing, right? iconic behavior, honestly.

SSL_get_rbio() hands you back a pointer to the BIO for the read channel, and SSL_get_wbio() hands you back a pointer to the BIO for the write channel. two separate channels, two separate BIOs, they can totally be different. no cap.

⚠️ but listen — the reference count of the BIO is NOT incremented. so like, don't go freeing it and then acting surprised, bestie. it's giving "borrowed pointer energy." 💀

👑 RETURN VALUES 👑

here's what you might get back, fr fr:

  • NULL — absolutely no BIO was connected to the SSL object. empty. void. nothing. 😭
  • Any other pointer — that's the BIO linked to ssl. go off, it's yours (to look at, not to own, remember what we said about refcounts 💅).

🔥 SEE ALSO 🔥

⭐ HISTORY ⭐

SSL_get_rbio() and SSL_get_wbio() first appeared in SSLeay 0.6.0 — ancient times, main character origin story — and they've been available since OpenBSD 2.4. periodt. 💜

and that's the whole page, bestie 🫶 go forth and check your rbios responsibly ✨

this little legend comes to you from Debian, dated June 8, 2025 — mwah, ily, bye 💖🎀🦋

📦 where this page comes from