NAME

PEM_write_bio_ASN1_stream — generic PEM encoder

SYNOPSIS

#include <openssl/asn1.h> int
PEM_write_bio_ASN1_stream(BIO *out_bio, ASN1_VALUE *val_in, BIO *in_bio, int flags, const char *hdr, const ASN1_ITEM *it);

DESCRIPTION

PEM_write_bio_ASN1_stream() writes the val_in argument of type it to out_bio in PEM format, that is, BER- and base64-encoded and surrounded by “-----BEGIN ...-----” and “-----END ...-----” lines with the hdr argument in place of the ellipses. The flags are passed through to i2d_ASN1_bio_stream(3). In particular, if the bit SMIME_STREAM is set, streaming is performed, reading the content from in_bio. Streaming is only supported if val_in is of the type CMS_ContentInfo or PKCS7. If the bit SMIME_STREAM is not set, the arguments in_bio and flags are ignored and distinguished encoding rules (DER) are used.

RETURN VALUES

PEM_write_bio_ASN1_stream() is intended to return 1 on success or 0 on failure.

SEE ALSO

ASN1_item_i2d_bio(3), BIO_f_base64(3), BIO_new(3), i2d_ASN1_bio_stream(3), PEM_write_bio(3), PEM_write_bio_CMS_stream(3), PEM_write_bio_PKCS7_stream(3)

HISTORY

PEM_write_bio_ASN1_stream() first appeared in OpenSSL 1.0.0 and has been available since OpenBSD 4.9.

BUGS

Many kinds of errors are silently ignored. This function may return 1 even if it only produced partial output or no output at all.