7e66b23e04b7ce4f05aaf69beb07cf72de93ad88
[openssl.git] / doc / crypto / X509_STORE_set_verify_cb_func.pod
1 =pod
2
3 =head1 NAME
4
5 X509_STORE_set_verify_cb_func, X509_STORE_set_verify_cb - set verification callback
6
7 =head1 SYNOPSIS
8
9  #include <openssl/x509_vfy.h>
10
11  void X509_STORE_set_verify_cb(X509_STORE *st,
12                                 int (*verify_cb)(int ok, X509_STORE_CTX *ctx));
13
14  void X509_STORE_set_verify_cb_func(X509_STORE *st,
15                                 int (*verify_cb)(int ok, X509_STORE_CTX *ctx));
16
17 =head1 DESCRIPTION
18
19 X509_STORE_set_verify_cb() sets the verification callback of B<ctx> to
20 B<verify_cb> overwriting any existing callback.
21
22 X509_STORE_set_verify_cb_func() also sets the verification callback but it
23 is implemented as a macro.
24
25 =head1 NOTES
26
27 The verification callback from an B<X509_STORE> is inherited by
28 the corresponding B<X509_STORE_CTX> structure when it is initialized. This can
29 be used to set the verification callback when the B<X509_STORE_CTX> is
30 otherwise inaccessible (for example during S/MIME verification).
31
32 =head1 BUGS
33
34 The macro version of this function was the only one available before
35 OpenSSL 1.0.0.
36
37 =head1 RETURN VALUES
38
39 X509_STORE_set_verify_cb() and X509_STORE_set_verify_cb_func() do not return
40 a value.
41
42 =head1 SEE ALSO
43
44 L<X509_STORE_CTX_set_verify_cb(3)>
45 L<CMS_verify(3)>
46
47 =head1 HISTORY
48
49 X509_STORE_set_verify_cb() was added to OpenSSL 1.0.0.
50
51 =head1 COPYRIGHT
52
53 Copyright 2009-2016 The OpenSSL Project Authors. All Rights Reserved.
54
55 Licensed under the OpenSSL license (the "License").  You may not use
56 this file except in compliance with the License.  You can obtain a copy
57 in the file LICENSE in the source distribution or at
58 L<https://www.openssl.org/source/license.html>.
59
60 =cut