diff options
author | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2021-05-07 17:16:48 +0200 |
---|---|---|
committer | Dr. David von Oheimb <dev@ddvo.net> | 2021-05-12 15:04:01 +0200 |
commit | 4329f361ce75973ceca9d440e8430580ee515070 (patch) | |
tree | 409fafba01b0bebb5d246b0854517baf1e8bddb6 /doc/man3 | |
parent | 202cbdd2fc37257870eeb61629d8d4d6709df7f1 (diff) |
Add ASN1_item_i2d_mem_bio(); document and improve also ASN1_item_d2i_bio()
ASN1_item_d2i_bio(): Do not report errors in queue on BIO input being NULL
Reviewed-by: Tomas Mraz <tomas@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/15147)
Diffstat (limited to 'doc/man3')
-rw-r--r-- | doc/man3/ASN1_item_d2i_bio.pod | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/doc/man3/ASN1_item_d2i_bio.pod b/doc/man3/ASN1_item_d2i_bio.pod new file mode 100644 index 0000000000..4ec7da838c --- /dev/null +++ b/doc/man3/ASN1_item_d2i_bio.pod @@ -0,0 +1,45 @@ +=pod + +=head1 NAME + +ASN1_item_d2i_bio, +ASN1_item_i2d_mem_bio +- decode and encode DER-encoded ASN.1 structures + +=head1 SYNOPSIS + + #include <openssl/asn1.h> + + void *ASN1_item_d2i_bio(const ASN1_ITEM *it, BIO *in, void *pval); + BIO *ASN1_item_i2d_mem_bio(const ASN1_ITEM *it, const ASN1_VALUE *val); + +=head1 DESCRIPTION + +ASN1_item_d2i_bio() decodes the contents of its input BIO I<in>, +which must be a DER-encoded ASN.1 structure, using the ASN.1 template I<it> +and places the result in I<*pval> unless I<pval> is NULL. +If I<in> is NULL it returns NULL, else a pointer to the parsed structure. + +ASN1_item_i2d_mem_bio() encodes the given ASN.1 value I<val> +using the ASN.1 template I<it> and returns the result in a memory BIO. + +=head1 RETURN VALUES + +ASN1_item_d2i_bio() returns a pointer to an B<ASN1_VALUE> or NULL. + +ASN1_item_i2d_mem_bio() returns a pointer to a memory BIO or NULL on error. + +=head1 HISTORY + +The functions described here were added in OpenSSL 3.0. + +=head1 COPYRIGHT + +Copyright 2021 The OpenSSL Project Authors. All Rights Reserved. + +Licensed under the Apache License 2.0 (the "License"). You may not use +this file except in compliance with the License. You can obtain a copy +in the file LICENSE in the source distribution or at +L<https://www.openssl.org/source/license.html>. + +=cut |