X509_CRL_PRINT(3) Library Functions Manual 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. GNU July 19, 2021 X509_CRL_PRINT(3)