aboutsummaryrefslogtreecommitdiff
path: root/openssl/doc/crypto/X509_STORE_set_verify_cb_func.pod
blob: 29e3bbe3bce93259dd562a39e7b51efb7fabd1b0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
=pod

=head1 NAME

X509_STORE_set_verify_cb_func, X509_STORE_set_verify_cb - set verification callback

=head1 SYNOPSIS

 #include <openssl/x509_vfy.h>

 void X509_STORE_set_verify_cb(X509_STORE *st,
				int (*verify_cb)(int ok, X509_STORE_CTX *ctx));

 void X509_STORE_set_verify_cb_func(X509_STORE *st,
				int (*verify_cb)(int ok, X509_STORE_CTX *ctx));

=head1 DESCRIPTION

X509_STORE_set_verify_cb() sets the verification callback of B<ctx> to
B<verify_cb> overwriting any existing callback.

X509_STORE_set_verify_cb_func() also sets the verification callback but it
is implemented as a macro.

=head1 NOTES

The verification callback from an B<X509_STORE> is inherited by 
the corresponding B<X509_STORE_CTX> structure when it is initialized. This can
be used to set the verification callback when the B<X509_STORE_CTX> is 
otherwise inaccessible (for example during S/MIME verification).

=head1 BUGS

The macro version of this function was the only one available before 
OpenSSL 1.0.0.

=head1 RETURN VALUES

X509_STORE_set_verify_cb() and X509_STORE_set_verify_cb_func() do not return
a value.

=head1 SEE ALSO

L<X509_STORE_CTX_set_verify_cb(3)|X509_STORE_CTX_set_verify_cb(3)>
L<CMS_verify(3)|CMS_verify(3)>

=head1 HISTORY

X509_STORE_set_verify_cb_func() is available in all versions of SSLeay and
OpenSSL.

X509_STORE_set_verify_cb() was added to OpenSSL 1.0.0.

=cut