1.\" $OpenBSD: d2i_X509_CRL.3,v 1.7 2018/03/27 17:35:50 schwarze Exp $ 2.\" OpenSSL bb9ad09e Jun 6 00:43:05 2016 -0400 3.\" 4.\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org> 5.\" 6.\" Permission to use, copy, modify, and distribute this software for any 7.\" purpose with or without fee is hereby granted, provided that the above 8.\" copyright notice and this permission notice appear in all copies. 9.\" 10.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 11.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 12.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 13.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 14.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 15.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 16.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 17.\" 18.Dd $Mdocdate: March 27 2018 $ 19.Dt D2I_X509_CRL 3 20.Os 21.Sh NAME 22.Nm d2i_X509_CRL , 23.Nm i2d_X509_CRL , 24.Nm d2i_X509_CRL_bio , 25.Nm d2i_X509_CRL_fp , 26.Nm i2d_X509_CRL_bio , 27.Nm i2d_X509_CRL_fp , 28.Nm d2i_X509_CRL_INFO , 29.Nm i2d_X509_CRL_INFO , 30.Nm d2i_X509_REVOKED , 31.Nm i2d_X509_REVOKED 32.Nd decode and encode X.509 certificate revocation lists 33.Sh SYNOPSIS 34.In openssl/x509.h 35.Ft X509_CRL * 36.Fo d2i_X509_CRL 37.Fa "X509_CRL **val_out" 38.Fa "const unsigned char **der_in" 39.Fa "long length" 40.Fc 41.Ft int 42.Fo i2d_X509_CRL 43.Fa "X509_CRL *val_in" 44.Fa "unsigned char **der_out" 45.Fc 46.Ft X509_CRL * 47.Fo d2i_X509_CRL_bio 48.Fa "BIO *in_bio" 49.Fa "X509_CRL **der_out" 50.Fc 51.Ft X509_CRL * 52.Fo d2i_X509_CRL_fp 53.Fa "FILE *in_fp" 54.Fa "X509_CRL **der_out" 55.Fc 56.Ft int 57.Fo i2d_X509_CRL_bio 58.Fa "BIO *out_bio" 59.Fa "X509_CRL *der_in" 60.Fc 61.Ft int 62.Fo i2d_X509_CRL_fp 63.Fa "FILE *out_fp" 64.Fa "X509_CRL *der_in" 65.Fc 66.Ft X509_CRL_INFO * 67.Fo d2i_X509_CRL_INFO 68.Fa "X509_CRL_INFO **val_out" 69.Fa "const unsigned char **der_in" 70.Fa "long length" 71.Fc 72.Ft int 73.Fo i2d_X509_CRL_INFO 74.Fa "X509_CRL_INFO *val_in" 75.Fa "unsigned char **der_out" 76.Fc 77.Ft X509_REVOKED * 78.Fo d2i_X509_REVOKED 79.Fa "X509_REVOKED **val_out" 80.Fa "const unsigned char **der_in" 81.Fa "long length" 82.Fc 83.Ft int 84.Fo i2d_X509_REVOKED 85.Fa "X509_REVOKED *val_in" 86.Fa "unsigned char **der_out" 87.Fc 88.Sh DESCRIPTION 89These functions decode and encode X.509 certificate revocation lists. 90For details about the semantics, examples, caveats, and bugs, see 91.Xr ASN1_item_d2i 3 . 92.Pp 93.Fn d2i_X509_CRL 94and 95.Fn i2d_X509_CRL 96decode and encode an ASN.1 97.Vt CertificateList 98structure defined in RFC 5280 section 5.1. 99.Fn d2i_X509_CRL_bio , 100.Fn d2i_X509_CRL_fp , 101.Fn i2d_X509_CRL_bio , 102and 103.Fn i2d_X509_CRL_fp 104are similar except that they decode or encode using a 105.Vt BIO 106or 107.Vt FILE 108pointer. 109.Pp 110.Fn d2i_X509_CRL_INFO 111and 112.Fn i2d_X509_CRL_INFO 113decode and encode an ASN.1 114.Vt TBSCertList 115structure defined in RFC 5280 section 5.1. 116.Pp 117.Fn d2i_X509_REVOKED 118and 119.Fn i2d_X509_REVOKED 120decode and encode an ASN.1 structure representing one element of 121the revokedCertificates field of the ASN.1 122.Vt TBSCertList 123structure. 124.Sh SEE ALSO 125.Xr ASN1_item_d2i 3 , 126.Xr X509_CRL_new 3 , 127.Xr X509_REVOKED_new 3 128.Sh STANDARDS 129RFC 5280: Internet X.509 Public Key Infrastructure Certificate and 130Certificate Revocation List (CRL) Profile, 131section 5: CRL and CRL Extensions Profile 132.Sh HISTORY 133.Fn d2i_X509_CRL , 134.Fn i2d_X509_CRL , 135.Fn d2i_X509_CRL_fp , 136.Fn i2d_X509_CRL_fp , 137.Fn d2i_X509_CRL_INFO , 138.Fn i2d_X509_CRL_INFO , 139.Fn d2i_X509_REVOKED , 140and 141.Fn i2d_X509_REVOKED 142first appeared in SSLeay 0.5.1. 143.Fn d2i_X509_CRL_bio 144and 145.Fn i2d_X509_CRL_bio 146first appeared in SSLeay 0.6.0. 147These functions have been available since 148.Ox 2.4 . 149