OSSL_STORE_ATTACH(3SSL)

📦
version 4.0.3 · 13 versions
, in ubuntu stonking

💖 OSSL_STORE_ATTACH — bestie, let's read objects straight off a BIO

okay so this is the OpenSSL manpage OSSL_STORE_ATTACH(3SSL) and honestly? it's a tiny page but it's lowkey iconic. basically it's the "i already have a BIO, don't make me find a URI" girl. let's get into it 🎀

✨ NAME ✨

OSSL_STORE_attach — functions to read objects from a BIO. yes that's literally the whole job description, she's focused 💅

🌸 SYNOPSIS 🌸

#include <openssl/store.h>

OSSL_STORE_CTX *OSSL_STORE_attach(BIO *bio, const char *scheme,
                                  OSSL_LIB_CTX *libctx, const char *propq,
                                  const UI_METHOD *ui_method, void *ui_data,
                                  const OSSL_PARAM params[],
                                  OSSL_STORE_post_process_info_fn post_process,
                                  void *post_process_data);

look at all those parameters. she's got range, fr fr 🦋

🦋 DESCRIPTION 🦋

So the tea is: OSSL_STORE_attach() works exactly like OSSL_STORE_open(3), with one glow-up difference — instead of handing her a <italic>uri</italic>, you hand her a <italic>bio</italic> directly. that's the whole plot twist, bestie 🫶

And you also pass in a <italic>scheme</italic>, which is what tells her which loader should be doing the processing of your data. like picking which friend handles the aux cord — somebody's gotta decide the vibe 😌

💡 IMPORTANT LITTLE DETAIL (no cap): if the call is successful, the reference count of the BIO object gets increased by 1. so like… she's holding onto your BIO now. the relationship is real. be aware 🫶

🔥 RETURN VALUES 🔥

  • On success: OSSL_STORE_attach() returns a pointer to an OSSL_STORE_CTX. slay ✨
  • On failure: it returns NULL. it's giving "not today" 😭

👑 SEE ALSO 👑

go read those too, iykyk 💜

🌈 HISTORY 🌈

OSSL_STORE_attach() was added in OpenSSL 3.0. so she's not even old, she's just experienced 💅

Copyright 2020-2021 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>.

okay and for the little sign-off situation: this page is from OpenSSL 4.0.3, dated 2026-09-29, and she lives under the name OSSL_STORE_ATTACH(3SSL). periodt 💖✨🦋 go attach some BIOs bestie, you're gonna do great 🫶🌸

📦 where this page comes from