X509_CRL_PRINT(3)

NAME
X509_CRL_print, X509_CRL_print_fp - pretty-print a certificate revocation list

SYNOPSIS
#include <openssl/x509.h>
int
X509_CRL_print(BIO *bio, X509_CRL *crl);
int
X509_CRL_print_fp(FILE *fp, X509_CRL *crl);

DESCRIPTION
X509_CRL_print() prints information contained in crl to bio in human-readable form, in the following order:

•   The certificate revocation list version number as defined by the standard, followed in parentheses by the value contained in the version field in hexadecimal notation. See X509_CRL_get_version(3) for details.

•   The name of the signature algorithm is printed with X509_signature_print(3).

•   The issuer name as returned by X509_CRL_get_issuer(3).

•   The times of the last and next updates as returned by X509_CRL_get0_lastUpdate(3) and X509_CRL_get0_nextUpdate(3) are printed with ASN1_TIME_print(3).

•   All X.509 extensions directly contained in the certificate revocation list object crl are printed with X509V3_extensions_print(3).

•   Information about revoked certificates is retrieved with X509_CRL_get_REVOKED(3), and for each revoked certificate, the following is printed:

    •   The serial number of the certificate is printed with i2a_ASN1_INTEGER(3).

    •   The revocation date is printed with ASN1_TIME_print(3).

    •   All X.509 extensions contained in the revocation entry are printed with X509V3_extensions_print(3).

•   The signature of crl is printed with X509_signature_print(3).

X509_CRL_print_fp() is similar to X509_CRL_print() except that it prints to fp.

RETURN VALUES
These functions are intended to return 1 for success and 0 for error.

SEE ALSO
BIO_new(3), X509_CRL_new(3), X509_print_ex(3), X509_REVOKED_new(3)

HISTORY
These functions first appeared in OpenSSL 0.9.2 and have been available since OpenBSD 2.6.

BUGS
Most I/O errors are silently ignored. Even if the information printed is incomplete, these functions may return 1 anyway.

If the version number is invalid, no information from the CRL is printed and the functions fail.