NAME
X509_get_subject_name
,
X509_set_subject_name
,
X509_get_issuer_name
,
X509_set_issuer_name
,
X509_REQ_get_subject_name
,
X509_REQ_set_subject_name
,
X509_CRL_get_issuer
,
X509_CRL_set_issuer_name
—
get and set issuer or subject
names
SYNOPSIS
#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);
DESCRIPTION
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.
X509_REQ_get_subject_name
()
and
X509_CRL_get_issuer
()
are implemented as macros.
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.
SEE ALSO
d2i_X509_NAME(3), ERR_get_error(3), X509_CRL_get0_by_serial(3), X509_get_pubkey(3), X509_NAME_add_entry_by_txt(3), X509_NAME_ENTRY_get_object(3), X509_NAME_get_index_by_NID(3), X509_NAME_new(3), X509_NAME_print_ex(3), X509_new(3), X509_sign(3), X509_verify_cert(3), X509V3_get_d2i(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.