lib/libcrypto/man/X509_CRL_new.3

   1 .\"     $OpenBSD: X509_CRL_new.3,v 1.3 2016/12/25 22:15:10 schwarze Exp $
   2 .\"
   3 .\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
   4 .\"
   5 .\" Permission to use, copy, modify, and distribute this software for any
   6 .\" purpose with or without fee is hereby granted, provided that the above
   7 .\" copyright notice and this permission notice appear in all copies.
   8 .\"
   9 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  10 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  12 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  15 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16 .\"
  17 .Dd $Mdocdate: December 25 2016 $
  18 .Dt X509_CRL_NEW 3
  19 .Os
  20 .Sh NAME
  21 .Nm X509_CRL_new ,
  22 .Nm X509_CRL_free ,
  23 .Nm X509_CRL_INFO_new ,
  24 .Nm X509_CRL_INFO_free
  25 .Nd X.509 certificate revocation lists
  26 .Sh SYNOPSIS
  27 .In openssl/x509.h
  28 .Ft X509_CRL *
  29 .Fn X509_CRL_new void
  30 .Ft void
  31 .Fn X509_CRL_free "X509_CRL *crl"
  32 .Ft X509_CRL_INFO *
  33 .Fn X509_CRL_INFO_new void
  34 .Ft void
  35 .Fn X509_CRL_INFO_free "X509_CRL_INFO *crl_info"
  36 .Sh DESCRIPTION
  37 .Fn X509_CRL_new
  38 allocates and initializes an empty
  39 .Vt X509_CRL
  40 object, representing an ASN.1
  41 .Vt CertificateList
  42 structure defined in RFC 5280 section 5.1.
  43 It can hold a pointer to an
  44 .Vt X509_CRL_INFO
  45 object discussed below together with a cryptographic signature
  46 and information about the signature algorithm used.
  47 .Fn X509_CRL_free
  48 frees
  49 .Fa crl .
  50 .Pp
  51 .Fn X509_CRL_INFO_new
  52 allocates and initializes an empty
  53 .Vt X509_CRL_INFO
  54 object, representing an ASN.1
  55 .Vt TBSCertList
  56 structure defined in RFC 5280 section 5.1.
  57 It is used inside the
  58 .Vt X509_CRL
  59 object and can hold a list of revoked certificates, an issuer name,
  60 the time the list was issued, the time when the next update of the
  61 list is due, and optional extensions.
  62 .Fn X509_CRL_INFO_free
  63 frees
  64 .Fa crl_info .
  65 .Sh RETURN VALUES
  66 .Fn X509_CRL_new
  67 and
  68 .Fn X509_CRL_INFO_new
  69 return the new
  70 .Vt X509_CRL
  71 or
  72 .Vt X509_CRL_INFO
  73 object, respectively, or
  74 .Dv NULL
  75 if an error occurs.
  76 .Sh SEE ALSO
  77 .Xr ACCESS_DESCRIPTION_new 3 ,
  78 .Xr AUTHORITY_KEYID_new 3 ,
  79 .Xr d2i_X509_CRL 3 ,
  80 .Xr DIST_POINT_new 3 ,
  81 .Xr PEM_read_X509_CRL 3 ,
  82 .Xr X509_CRL_get0_by_serial 3 ,
  83 .Xr X509_CRL_get_ext 3 ,
  84 .Xr X509_CRL_get_ext_d2i 3 ,
  85 .Xr X509_CRL_get_issuer 3 ,
  86 .Xr X509_CRL_get_version 3 ,
  87 .Xr X509_CRL_sign 3 ,
  88 .Xr X509_EXTENSION_new 3 ,
  89 .Xr X509_load_crl_file 3 ,
  90 .Xr X509_new 3 ,
  91 .Xr X509_REVOKED_new 3 ,
  92 .Xr X509_STORE_CTX_set0_crls 3
  93 .Sh STANDARDS
  94 RFC 5280: Internet X.509 Public Key Infrastructure Certificate and
  95 Certificate Revocation List (CRL) Profile, section 5: CRL and CRL
  96 Extensions Profile