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 =cut
  52
  53 =head1 COPYRIGHT
  54
  55 Copyright 2009-2016 The OpenSSL Project Authors. All Rights Reserved.
  56
  57 Licensed under the OpenSSL license (the "License").  You may not use
  58 this file except in compliance with the License.  You can obtain a copy
  59 in the file LICENSE in the source distribution or at
  60 L<https://www.openssl.org/source/license.html>.
  61
  62 =cut