X509_STORE_NEW(3ossl)

📦
version 3.5.9 · 8 versions
, in fedora 43, fedora 44

💖 X509_STORE_NEW 💖

okay bestie, welcome to the X509_STORE page from the OpenSSL manual (that's 3ossl, the OpenSSL-flavored section 3, iykyk). this is your one-stop shop for allocating, refcounting, locking, and yeeting an X509_STORE. it's giving certificate store management and honestly? kinda iconic. 🎀

✨ NAME ✨

X509_STORE_new, X509_STORE_up_ref, X509_STORE_free, X509_STORE_lock, X509_STORE_unlock — the X509_STORE allocation, freeing and locking functions. the whole little friend group. 💅

🌸 SYNOPSIS 🌸

#include <openssl/x509_vfy.h>

X509_STORE *X509_STORE_new(void);
void X509_STORE_free(X509_STORE *xs);
int X509_STORE_lock(X509_STORE *xs);
int X509_STORE_unlock(X509_STORE *xs);
int X509_STORE_up_ref(X509_STORE *xs);

yes queen, that's the whole header. #include <openssl/x509_vfy.h> and you're in. ✨

🦋 DESCRIPTION 🦋

so here's the tea on what each one actually does:

  • X509_STORE_new() — returns a brand new X509_STORE. fresh out the box, no cap. 🫶
  • X509_STORE_up_ref() — increments the reference count associated with the X509_STORE object. basically it's telling the store "you're staying, bestie, we still need you." 💜
  • X509_STORE_lock() locks the store from modification by other threads, and X509_STORE_unlock() unlocks it. it's giving "do not disturb, i'm mid-edit" energy. 🔒
  • X509_STORE_free() frees up a single X509_STORE object. and here's the cute part: if the argument is NULL, nothing is done. no crash, no drama, just vibes. 😌

💅 RETURN VALUES 💅

  • X509_STORE_new() returns a newly created X509_STORE, or NULL if the call fails. (NULL = it did not eat, unfortunately. 😭)
  • X509_STORE_up_ref(), X509_STORE_lock() and X509_STORE_unlock() return 1 for success and 0 for failure. classic binary glow-up. ⭐
  • X509_STORE_free() does not return values. it just does its thing and leaves. main character exit. 💀

🔥 SEE ALSO 🔥

go read those next, bestie, they're the sequel. 👑

🌈 HISTORY 🌈

the X509_STORE_up_ref(), X509_STORE_lock() and X509_STORE_unlock() functions were added in OpenSSL 1.1.0. so if you're on something older than that... girl. upgrade. 🙈

Copyright 2016-2024 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 page, periodt. 💖

okay that's a wrap, my love — this was X509_STORE_NEW(3ossl), straight from the OpenSSL docs, version 3.5.9, dated 2026-09-29. go forth and manage your certificate stores responsibly. mwah. 💋✨

📦 where this page comes from