OSSL_STORE_ATTACH(3ossl)

📦
version 15.1 · 3 versions
, in freebsd 15.1

💾 NAME 💾

Okay bestie, welcome to the OSSL_STORE_ATTACH(3ossl) page — yes, the manual name is a whole mouthful, but we move. The headline is: OSSL_STORE_attach — Functions to read objects from a BIO. We love a descriptive name. ✨

🌸 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);

🎀 DESCRIPTION 🎀

So OSSL_STORE_attach() is basically doing the same job as OSSL_STORE_open(3), but with a plot twist: instead of a uri, it takes a BIO bio, plus a scheme that tells it which loader should be used to process the data. Slay. 💅

And here's the important receipt: if the call is successful, the reference count of the BIO object is increased by 1. Not 2, bestie — by 1. 🫶

🔥 RETURN VALUES 🔥

On success, OSSL_STORE_attach() returns a pointer to a OSSL_STORE_CTX. On failure? It returns NULL. That's the whole vibe. 😭

👑 SEE ALSO 👑

⭐ HISTORY ⭐

OSSL_STORE_attach() was added in OpenSSL 3.0. Periodt. 🌈

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

And that's the page, bestie! 🦋 This was the <pink>3.5.6</pink> version, dated <purple>2026-04-07</purple>, for OSSL_STORE_ATTACH(3ossl). Bye bestie! 💜

📦 where this page comes from