openssl/doc/crypto/X509_STORE_set_verify_cb_func.pod
Rich Salz 05ea606a25 Doc nits cleanup, round 2
Fix some code examples, trailing whitespace
Fix TBA sections in verify, remove others.
Remove empty sections
Use Mixed Case not ALL CAPS in head2
Enhance doc-nits script.
Remove extra =cut line

Reviewed-by: Richard Levitte <levitte@openssl.org>
2016-05-20 20:54:00 -04:00

60 lines
1.6 KiB
Text

=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