NAME
X509_load_cert_file,
X509_load_crl_file,
X509_load_cert_crl_file —
read, decode, and cache certificates
and CRLs
SYNOPSIS
#include
<openssl/x509_vfy.h>
int
X509_load_cert_file(X509_LOOKUP
*ctx, const char *file, int
type);
int
X509_load_crl_file(X509_LOOKUP
*ctx, const char *file, int
type);
int
X509_load_cert_crl_file(X509_LOOKUP
*ctx, const char *file, int
type);
DESCRIPTION
X509_load_cert_file()
with a type of
X509_FILETYPE_PEM reads one or more certificates in
PEM format from the given file using
PEM_read_bio_X509_AUX(3); with a type of
X509_FILETYPE_ASN1, if reads one certificate in DER
format using d2i_X509_bio(3). The certificates read are added to the
X509_STORE memory cache object associated with the
given ctx using
X509_STORE_add_cert(3).
X509_load_crl_file()
with a type of
X509_FILETYPE_PEM reads one or more certificate
revocation lists in PEM format from the given file
using
PEM_read_bio_X509_CRL(3); with a type of
X509_FILETYPE_ASN1, if reads one certificate
revocation lists in DER format using
d2i_X509_CRL_bio(3). The certificate revocation lists read
are added to the X509_STORE memory cache object
associated with the given ctx using
X509_STORE_add_crl(3).
X509_load_cert_crl_file()
with a type of
X509_FILETYPE_PEM read one or more certificates
and/or certificate revocation lists in PEM format from the given
file using
PEM_X509_INFO_read_bio(3) and adds them to the
X509_STORE memory cache object associated with the
given ctx using
X509_STORE_add_cert(3) and
X509_STORE_add_crl(3), respectively.
X509_load_cert_crl_file()
with a type of
X509_FILETYPE_ASN1 is equivalent to
X509_load_cert_file() and cannot be used to read a
certificate revocation list.
RETURN VALUES
These functions return the number of objects loaded or 0 on error.
SEE ALSO
d2i_X509_bio(3), PEM_read_PrivateKey(3), X509_LOOKUP_new(3), X509_OBJECT_get0_X509(3), X509_STORE_load_locations(3), X509_STORE_new(3)
HISTORY
X509_load_cert_file() first appeared in
SSLeay 0.8.0 and X509_load_crl_file() in SSLeay
0.9.0. These functions have been available since OpenBSD
2.4.
X509_load_cert_crl_file() first appeared
in OpenSSL 0.9.5 and has been available since OpenBSD
2.7.