NAME

d2i_GENERAL_NAME, i2d_GENERAL_NAME, d2i_GENERAL_NAMES, i2d_GENERAL_NAMES, d2i_EDIPARTYNAME, i2d_EDIPARTYNAME, d2i_OTHERNAME, i2d_OTHERNAME — decode and encode names for use in X.509 extensions

SYNOPSIS

#include <openssl/x509v3.h>

GENERAL_NAME *
d2i_GENERAL_NAME(GENERAL_NAME **val_out, const unsigned char **der_in, long length);

int
i2d_GENERAL_NAME(GENERAL_NAME *val_in, unsigned char **der_out);

GENERAL_NAMES *
d2i_GENERAL_NAMES(GENERAL_NAMES **val_out, const unsigned char **der_in, long length);

int
i2d_GENERAL_NAMES(GENERAL_NAMES *val_in, unsigned char **der_out);

EDIPARTYNAME *
d2i_EDIPARTYNAME(EDIPARTYNAME **val_out, const unsigned char **der_in, long length);

int
i2d_EDIPARTYNAME(EDIPARTYNAME *val_in, unsigned char **der_out);

OTHERNAME *
d2i_OTHERNAME(OTHERNAME **val_out, const unsigned char **der_in, long length);

int
i2d_OTHERNAME(OTHERNAME *val_in, unsigned char **der_out);

DESCRIPTION

These functions decode and encode names that can be used in X.509 extensions. For details about the semantics, examples, caveats, and bugs, see ASN1_item_d2i(3).

d2i_GENERAL_NAME() and i2d_GENERAL_NAME() decode and encode an ASN.1 GeneralName structure defined in RFC 5280 section 4.2.1.6.

d2i_GENERAL_NAMES() and i2d_GENERAL_NAMES() decode and encode an ASN.1 GeneralNames structure defined in RFC 5280 section 4.2.1.6.

d2i_EDIPARTYNAME() and i2d_EDIPARTYNAME() decode and encode an ASN.1 EDIPartyName structure defined in RFC 5280 section 4.2.1.6.

d2i_OTHERNAME() and i2d_OTHERNAME() decode and encode an ASN.1 OtherName structure defined in RFC 5280 section 4.2.1.6.

RETURN VALUES

d2i_GENERAL_NAME(), d2i_GENERAL_NAMES(), d2i_EDIPARTYNAME(), and d2i_OTHERNAME() return a GENERAL_NAME, GENERAL_NAMES, EDIPARTYNAME, or OTHERNAME object, respectively, or NULL if an error occurs.

i2d_GENERAL_NAME(), i2d_GENERAL_NAMES(), i2d_EDIPARTYNAME(), and i2d_OTHERNAME() return the number of bytes successfully encoded or a negative value if an error occurs.

SEE ALSO

ASN1_item_d2i(3), d2i_X509_NAME(3), GENERAL_NAME_new(3), X509_EXTENSION_new(3)

STANDARDS

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

HISTORY

d2i_GENERAL_NAME(), i2d_GENERAL_NAME(), d2i_GENERAL_NAMES(), and i2d_GENERAL_NAMES() first appeared in OpenSSL 0.9.2b and have been available since OpenBSD 2.6.

d2i_OTHERNAME() and i2d_OTHERNAME() first appeared in OpenSSL 0.9.5 and have been available since OpenBSD 2.7.

d2i_EDIPARTYNAME() and i2d_EDIPARTYNAME() first appeared in OpenSSL 0.9.7 and have been available since OpenBSD 3.2.