0512ad3383217682ab90c319e0796c7f3b1ba526
[openssl.git] / doc / crypto / X509_STORE_new.pod
1 =pod
2
3 =head1 NAME
4
5 X509_STORE_new, X509_STORE_up_ref, X509_STORE_free - X509_STORE allocation and freeing functions
6
7 =head1 SYNOPSIS
8
9  #include <openssl/x509_vfy.h>
10
11  X509_STORE *X509_STORE_new(void);
12  void X509_STORE_free(X509_STORE *v);
13  int X509_STORE_up_ref(X509_STORE *v);
14
15 =head1 DESCRIPTION
16
17 The X509_STORE_new() function returns a new X509_STORE.
18
19 X509_STORE_up_ref() increments the reference count associated with the
20 X509_STORE object.
21
22 X509_STORE_free() frees up a single X509_STORE object.
23
24 =head1 RETURN VALUES
25
26 X509_STORE_new() returns a newly created X509_STORE or NULL if the call fails.
27
28 X509_STORE_up_ref() returns 1 for success and 0 for failure.
29
30 X509_STORE_free() does not return values.
31
32 =head1 SEE ALSO
33
34 L<X509_STORE_set_verify_cb_func(3)>
35 L<X509_STORE_get0_param(3)>
36
37 =head1 HISTORY
38
39 The B<X509_STORE_up_ref> function was added in OpenSSL 1.1.0
40
41 =cut