OSSL_STORE_ATTACH(3ossl)

📦 version 3.5.0, in opensuse-leap 16.0

💅 OSSL_STORE_ATTACH 💅

okay so bestie, welcome to the 3ossl corner of the OpenSSL man pages — this is where we keep the lil' functions that read stuff out of a BIO for you. yes, that's the whole vibe. sit down, grab a boba, we're learning 🧋✨

🎀 NAME 🎀

OSSL_STORE_attach — the functions that read objects from a BIO, no cap 🔥

✨ 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 params. she's got a lot going on, and honestly? iconic. 👑

🌸 DESCRIPTION 🌸

so basically, OSSL_STORE_attach() is giving exactly the same energy as OSSL_STORE_open(3) — literally the same function with a little glow-up 💖

the plot twist: instead of taking a uri, it takes a BIO called bio, plus a scheme so it knows which loader should be used to process the data. think of scheme as the function's little "hey bestie, this is what kind of data you're dealing with" note 📝

and here's the detail you absolutely cannot forget: the reference count of the BIO object is increased by 1 if the call is successful. so if it works, the BIO gets one more bestie holding onto it. if it doesn't work... well, see below 👀

🦋 RETURN VALUES 🦋

  • a pointer to an OSSL_STORE_CTX — slay, it worked, you got your context ✨
  • NULL — on failure 😭 it happens to the best of us

🌈 SEE ALSO 🌈

the group chat, aka the related reading:

go read them, they're lowkey essential iykyk 💅

⭐ HISTORY ⭐

OSSL_STORE_attach() was added in OpenSSL 3.0 — so she's a 3.0 baby, fresh out the release notes 🎀

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>.

fr fr though — read the license before you go touching this, the legal girlies are serious about it 📜💀

and that's the whole page bestie 🧚💜 ty for coming to my TED talk. this lil' beauty is 3.5.0 and she was dated 2026-09-25 — mwah, catch you on the next man page 💋🌸

📦 where this page comes from