=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)>
L<CMS_verify(3)>

=head1 HISTORY

X509_STORE_set_verify_cb() was added to OpenSSL 1.0.0.

=head1 COPYRIGHT

Copyright 2009-2016 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the OpenSSL license (the "License").  You may not use
this file except in compliance with the License.  You can obtain a copy
in the file LICENSE in the source distribution or at
L<https://www.openssl.org/source/license.html>.

=cut
