NAME¶

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

SYNOPSIS¶

#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¶

X509_STORE_new() allocates and initializes an empty X.509 certificate store and sets its reference count to 1.

X509_STORE_up_ref() increments the reference count of store by 1.

X509_STORE_free() 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.

SEE ALSO¶

PKCS7_verify(3), SSL_CTX_set_cert_store(3), X509_load_cert_file(3), X509_LOOKUP_hash_dir(3), X509_OBJECT_get0_X509(3), X509_STORE_CTX_new(3), X509_STORE_get_ex_new_index(3), X509_STORE_load_locations(3), X509_STORE_set1_param(3), X509_STORE_set_verify_cb(3), X509_verify_cert(3)

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.