crypto/openssl/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)|X509_STORE_CTX_set_verify_cb(3)>
  45 L<CMS_verify(3)|CMS_verify(3)>
  46
  47 =head1 HISTORY
  48
  49 X509_STORE_set_verify_cb_func() is available in all versions of SSLeay and
  50 OpenSSL.
  51
  52 X509_STORE_set_verify_cb() was added to OpenSSL 1.0.0.
  53
  54 =cut