X509_STORE_NEW(3)

📦 version 4.4.0, in alpine 3.24, arch rolling

okay so welcome to X509_STORE_NEW(3), bestie — this page lives in the Library Functions Manual, and it’s all about the allocation + freeing of X.509 certificate stores 💅✨

💖 NAME 💖

X509_STORE_new, X509_STORE_up_ref, X509_STORE_free — allocate and free X.509 certificate stores 🎀

🌸 SYNOPSIS 🌸

first up, the actual signatures — keep these exactly as written, no cap:

library “libcrypto”
#include <openssl/x509_vfy.h>

X509_STORE *
X509_STORE_new(void);

int
X509_STORE_up_ref(X509_STORE *store);

void
X509_STORE_free(X509_STORE *store);

🦋 DESCRIPTION 🦋

okay so here’s the vibe check on these three functions:

  • X509_STORE_new(void) — allocates and initializes an empty X.509 certificate store, and sets its reference count to 1 ✨
  • X509_STORE_up_ref(X509_STORE *store) — increments the reference count of store by 1 🫶
  • X509_STORE_free(X509_STORE *store) — decrements the reference count of store by 1. If the reference count reaches 0, all resources used by the store, including all certificates contained in it, are released and store itself is freed. If store is a NULL pointer, no action occurs 🙈

✨ RETURN VALUES ✨

  • X509_STORE_new() returns a newly created X509_STORE object or NULL if an error occurs 😭
  • X509_STORE_up_ref() returns 1 for success and 0 for failure — that’s the whole return tea 🍵

🎀 SEE ALSO 🎀

go sip some more manpages, bestie 🫶:

👑 HISTORY 👑

  • X509_STORE_new() and X509_STORE_free() first appeared in SSLeay 0.8.0 and have been available since OpenBSD 2.4 🌈
  • X509_STORE_up_ref() first appeared in OpenSSL 1.1.0 and has been available since OpenBSD 6.3 ⭐

okay that’s the page, bestie — mwah 💋🫶. this footer tea is from Debian, dated June 8, 2025.

📦 where this page comes from