libressl-X509_get_subject_name(3)

libressl-X509_get_subject_name3

Get and set issuer or subject names

Usage

Crypto Library (libcrypto, -lcrypto)

#include <openssl/x509.h>

X509_NAME *

X509_get_subject_name(const X509 *x);

int

X509_set_subject_name(X509 *x, X509_NAME *name);

X509_NAME *

X509_get_issuer_name(const X509 *x);

int

X509_set_issuer_name(X509 *x, X509_NAME *name);

X509_NAME *

X509_REQ_get_subject_name(const X509_REQ *req);

int

X509_REQ_set_subject_name(X509_REQ *req, X509_NAME *name);

X509_NAME *

X509_CRL_get_issuer(const X509_CRL *crl);

int

X509_CRL_set_issuer_name(X509_CRL *x, X509_NAME *name);

Overview

X509_get_subject_name() returns the subject name of certificate x. The returned value is an internal pointer which must not be freed.

X509_set_subject_name() sets the issuer name of certificate x to name. The name parameter is copied internally and should be freed up when it is no longer needed.

X509_get_issuer_name() and X509_set_issuer_name() are identical to X509_get_subject_name() and X509_set_subject_name() except that they get and set the issuer name of x.

Similarly X509_REQ_get_subject_name(), X509_REQ_set_subject_name(), X509_CRL_get_issuer(), and X509_CRL_set_issuer_name() get or set the subject or issuer names of certificate requests of CRLs, respectively.

Return values

X509_get_subject_name(), X509_get_issuer_name(), X509_REQ_get_subject_name(), and X509_CRL_get_issuer() return a pointer to an X509_NAME object.

X509_set_subject_name(), X509_set_issuer_name(), X509_REQ_set_subject_name(), and X509_CRL_set_issuer_name() return 1 for success or 0 for failure. In some cases of failure, the reason can be determined with ERR_get_error(3).

History

X509_get_subject_name() and X509_get_issuer_name() appeared in SSLeay 0.4 or earlier. X509_set_subject_name(), X509_set_issuer_name(), X509_REQ_get_subject_name(), and X509_REQ_set_subject_name() first appeared in SSLeay 0.6.5. These functions have been available since OpenBSD 2.4.

X509_CRL_get_issuer() first appeared in OpenSSL 0.9.2b and has been available since OpenBSD 2.6.

X509_CRL_set_issuer_name() first appeared in OpenSSL 0.9.7 and has been available since OpenBSD 3.2.

From libressl 4.4.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's mdoc source.