X509_STORE_new.3ossl - Man Page

X509_STORE_new, X509_STORE_up_ref, X509_STORE_free, X509_STORE_lock,X509_STORE_unlock ​- X509_STORE allocation, freeing and locking functions

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

Description

The X509_STORE_new() function returns a new X509_STORE.

X509_STORE_up_ref() increments the reference count associated with the X509_STORE object.

X509_STORE_lock() locks the store from modification by other threads, ​X509_STORE_unlock() unlocks it.

X509_STORE_free() frees up a single X509_STORE object. If the argument is NULL, nothing is done.

Return Values

X509_STORE_new() returns a newly created X509_STORE or NULL if the call fails.

X509_STORE_up_ref(), X509_STORE_lock() and X509_STORE_unlock() return 1 for success and 0 for failure.

X509_STORE_free() does not return values.

See Also

X509_STORE_set_verify_cb_func(3) ​X509_STORE_get0_param(3)

History

The X509_STORE_up_ref(), X509_STORE_lock() and X509_STORE_unlock() functions were added in OpenSSL 1.1.0.

Referenced By

X509_LOOKUP_meth_new.3ossl(3), X509_STORE_add_cert.3ossl(3), X509_STORE_get0_param.3ossl(3).

The man pages X509_STORE_free.3ossl(3), X509_STORE_lock.3ossl(3), X509_STORE_unlock.3ossl(3) and X509_STORE_up_ref.3ossl(3) are aliases of X509_STORE_new.3ossl(3).

2026-08-25 3.5.8 OpenSSL