doc/man3/X509v3_cache_extensions.pod

   1 =pod
   2
   3 =head1 NAME
   4
   5 X509v3_cache_extensions
   6 - cache info on various X.509v3 extensions and further derived certificate data
   7
   8 =head1 SYNOPSIS
   9
  10  #include <openssl/x509v3.h>
  11
  12  int X509v3_cache_extensions(X509 *x, OPENSSL_CTX *libctx, const char *propq);
  13
  14 =head1 DESCRIPTION
  15
  16 This function processes any X509v3 extensions that might be present in an X509
  17 object and caches the result of that processing as well as further derived info,
  18 for instance if the certificate is self-issued. Many OpenSSL functions that use
  19 an X509 object will cause extensions to be processed and cached implicitly. If
  20 this is done implicitly then the default library context and property query
  21 string will be used. In some cases it may be desirable to use some other library
  22 context and property query string. If so then an application can call
  23 X509v3_cache_extensions() explicitly. This should be done before any function
  24 that needs to use those extensions is called - otherwise calling
  25 X509v3_cache_extensions() will have no effect. Typically this means calling this
  26 soon after creation of the X509 object. The X509 object to be processed is
  27 given in I<x> and the library context and property query string to use are given
  28 in I<libctx> and I<propq>.
  29
  30 =head1 RETURN VALUES
  31
  32 This function returns 0 if the extensions are invalid or an error occurred.
  33 Otherwise it returns 1.
  34
  35 =head1 COPYRIGHT
  36
  37 Copyright 2020 The OpenSSL Project Authors. All Rights Reserved.
  38
  39 Licensed under the Apache License 2.0 (the "License").  You may not use
  40 this file except in compliance with the License.  You can obtain a copy
  41 in the file LICENSE in the source distribution or at
  42 L<https://www.openssl.org/source/license.html>.
  43
  44 =cut