SSL_GET_RBIO(3SSL)

📦
version 4.0.3 · 14 versions
, in ubuntu stonking

💖 SSL_GET_RBIO 💖

okay bestie, gather round, because today we're talking about SSL_get_rbio and SSL_get_wbio — two lil functions from the OpenSSL library (yep, this is from the 3SSL manual section) that hand you back the BIOs your SSL object is chillin' with. it's giving "peek behind the curtain" and honestly? obsessed. 🦋

✨ NAME ✨

SSL_get_rbio, SSL_get_wbio — get the BIO linked to an SSL object 💅

🌸 SYNOPSIS 🌸

#include <openssl/ssl.h>

BIO *SSL_get_rbio(SSL *ssl);
BIO *SSL_get_wbio(SSL *ssl);

🎀 DESCRIPTION 🎀

so like. SSL_get_rbio() and SSL_get_wbio() return pointers to the BIOs for the read channel and the write channel respectively. and here's the plot twist bestie — those two can be different BIOs. yes really. read and write living separate lives, and that's valid fr fr. 🫶

one thing though, and this is the important part, no cap: the reference count of the BIO is not incremented. so don't go freeing it thinking you own it now. you don't. it's on loan. 🙈

👑 RETURN VALUES 👑

here's what can come back at you:

  • NULL — no BIO was connected to the SSL object. literally nothing there. main character energy of an empty room 💀
  • any other pointer — the BIO linked to ssl. slay, it exists 🌈

🔥 SEE ALSO 🔥

Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <https://www.openssl.org/source/license.html>.

and that's the whole vibe check, bestie ✨ this was OpenSSL version 4.0.3, dated 2026-09-29 — go forth and read your BIOS responsibly, and remember: you don't own that pointer, you're just borrowing it 🎀💖🌸

📦 where this page comes from