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.