NAME

d2i_PKCS12, i2d_PKCS12, d2i_PKCS12_bio, i2d_PKCS12_bio, d2i_PKCS12_fp, i2d_PKCS12_fp, d2i_PKCS12_MAC_DATA, i2d_PKCS12_MAC_DATA, d2i_PKCS12_SAFEBAG, i2d_PKCS12_SAFEBAG, d2i_PKCS12_BAGS, i2d_PKCS12_BAGS — decode and encode PKCS#12 structures

SYNOPSIS

#include <openssl/pkcs12.h>

PKCS12 *
d2i_PKCS12(PKCS12 **val_out, const unsigned char **der_in, long length);

int
i2d_PKCS12(PKCS12 *val_in, unsigned char **der_out);

PKCS12 *
d2i_PKCS12_bio(BIO *in_bio, PKCS12 **val_out);

int
i2d_PKCS12_bio(BIO *out_bio, PKCS12 *val_in);

PKCS12 *
d2i_PKCS12_fp(FILE *in_fp, PKCS12 **val_out);

int
i2d_PKCS12_fp(FILE *out_fp, PKCS12 *val_in);

PKCS12_MAC_DATA *
d2i_PKCS12_MAC_DATA(PKCS12_MAC_DATA **val_out, const unsigned char **der_in, long length);

int
i2d_PKCS12_MAC_DATA(PKCS12_MAC_DATA *val_in, unsigned char **der_out);

PKCS12_SAFEBAG *
d2i_PKCS12_SAFEBAG(PKCS12_SAFEBAG **val_out, const unsigned char **der_in, long length);

int
i2d_PKCS12_SAFEBAG(PKCS12_SAFEBAG *val_in, unsigned char **der_out);

PKCS12_BAGS *
d2i_PKCS12_BAGS(PKCS12_BAGS **val_out, const unsigned char **der_in, long length);

int
i2d_PKCS12_BAGS(PKCS12_BAGS *val_in, unsigned char **der_out);

DESCRIPTION

These functions decode and encode PKCS#12 structures. For details about the semantics, examples, caveats, and bugs, see ASN1_item_d2i(3).

d2i_PKCS12() and i2d_PKCS12() decode and encode an ASN.1 PFX (personal information exchange) structure defined in RFC 7292 section 4. d2i_PKCS12_bio(), i2d_PKCS12_bio(), d2i_PKCS12_fp(), and i2d_PKCS12_fp() are similar except that they decode or encode using a BIO or FILE pointer.

d2i_PKCS12_MAC_DATA() and i2d_PKCS12_MAC_DATA() decode and encode an ASN.1 MacData structure defined in RFC 7292 section 4.

d2i_PKCS12_SAFEBAG() and i2d_PKCS12_SAFEBAG() decode and encode an ASN.1 SafeBag structure defined in RFC 7292 section 4.2.

d2i_PKCS12_BAGS() and i2d_PKCS12_BAGS() decode and encode the bagValue field of an ASN.1 SafeBag structure.

RETURN VALUES

d2i_PKCS12(), d2i_PKCS12_bio(), and d2i_PKCS12_fp() return a PKCS12 object or NULL if an error occurs.

d2i_PKCS12_MAC_DATA(), d2i_PKCS12_SAFEBAG(), and d2i_PKCS12_BAGS() return a PKCS12_MAC_DATA, PKCS12_SAFEBAG, or PKCS12_BAGS object, respectively, or NULL if an error occurs.

i2d_PKCS12(), i2d_PKCS12_MAC_DATA(), i2d_PKCS12_SAFEBAG(), and i2d_PKCS12_BAGS() return the number of bytes successfully encoded or a negative value if an error occurs.

i2d_PKCS12_bio() and i2d_PKCS12_fp() return 1 for success or 0 if an error occurs.

SEE ALSO

ASN1_item_d2i(3), PKCS12_create(3), PKCS12_new(3), PKCS12_parse(3), PKCS12_SAFEBAG_new(3)

STANDARDS

RFC 7292: PKCS #12: Personal Information Exchange Syntax

HISTORY

d2i_PKCS12(), i2d_PKCS12(), d2i_PKCS12_bio(), i2d_PKCS12_bio(), d2i_PKCS12_fp(), i2d_PKCS12_fp(), d2i_PKCS12_MAC_DATA(), i2d_PKCS12_MAC_DATA(), d2i_PKCS12_SAFEBAG(), i2d_PKCS12_SAFEBAG(), d2i_PKCS12_BAGS(), and i2d_PKCS12_BAGS() first appeared in OpenSSL 0.9.3 and have been available since OpenBSD 2.6.