NAME

X509_CINF_new, X509_CINF_free, X509_VAL_new, X509_VAL_free, X509_CERT_AUX_new, X509_CERT_AUX_free — X.509 certificate information objects

SYNOPSIS

#include <openssl/x509.h>

X509_CINF *
X509_CINF_new(void);

void
X509_CINF_free(X509_CINF *inf);

X509_VAL *
X509_VAL_new(void);

void
X509_VAL_free(X509_VAL *val);

X509_CERT_AUX *
X509_CERT_AUX_new(void);

void
X509_CERT_AUX_free(X509_CERT_AUX *aux);

DESCRIPTION

X509_CINF_new() allocates and initializes an empty X509_CINF object, representing an ASN.1 TBSCertificate structure defined in RFC 5280 section 4.1. It is used inside the X509 object and holds the main information contained in the X.509 certificate including subject, public key, issuer, serial number, validity period, and extensions. X509_CINF_free() frees inf.

X509_VAL_new() allocates and initializes an empty X509_VAL object, representing an ASN.1 Validity structure defined in RFC 5280 section 4.1. It is used inside the X509_CINF object and holds the validity period of the certificate. X509_VAL_free() frees val.

X509_CERT_AUX_new() allocates and initializes an empty X509_CERT_AUX structure. It can be used inside an X509 object to hold optional non-standard auxiliary data appended to a certificate, for example friendly alias names and trust data. X509_CERT_AUX_free() frees aux.

RETURN VALUES

X509_CINF_new(), X509_VAL_new(), and X509_CERT_AUX_new() return the new X509_CINF, X509_VAL, or X509_CERT_AUX object, respectively, or NULL if an error occurs.

SEE ALSO

d2i_X509_CINF(3), X509_add1_trust_object(3), X509_CERT_AUX_print(3), X509_keyid_set1(3), X509_new(3)

STANDARDS

RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile

HISTORY

X509_CINF_new(), X509_CINF_free(), X509_VAL_new(), and X509_VAL_free() appeared in SSLeay 0.4 or earlier and have been available since OpenBSD 2.4.

X509_CERT_AUX_new() and X509_CERT_AUX_free() first appeared in OpenSSL 0.9.5 and have been available since OpenBSD 2.7.