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 | |
parent | 202cbdd2fc37257870eeb61629d8d4d6709df7f1 (diff) | |
download | openssl-4329f361ce75973ceca9d440e8430580ee515070.tar.gz |
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')
-rw-r--r-- | doc/build.info | 6 | ||||
-rw-r--r-- | doc/man3/ASN1_item_d2i_bio.pod | 45 |
2 files changed, 51 insertions, 0 deletions
diff --git a/doc/build.info b/doc/build.info index ec3baa2373..af0e0e0539 100644 --- a/doc/build.info +++ b/doc/build.info @@ -514,6 +514,10 @@ DEPEND[html/man3/ASN1_generate_nconf.html]=man3/ASN1_generate_nconf.pod GENERATE[html/man3/ASN1_generate_nconf.html]=man3/ASN1_generate_nconf.pod DEPEND[man/man3/ASN1_generate_nconf.3]=man3/ASN1_generate_nconf.pod GENERATE[man/man3/ASN1_generate_nconf.3]=man3/ASN1_generate_nconf.pod +DEPEND[html/man3/ASN1_item_d2i_bio.html]=man3/ASN1_item_d2i_bio.pod +GENERATE[html/man3/ASN1_item_d2i_bio.html]=man3/ASN1_item_d2i_bio.pod +DEPEND[man/man3/ASN1_item_d2i_bio.3]=man3/ASN1_item_d2i_bio.pod +GENERATE[man/man3/ASN1_item_d2i_bio.3]=man3/ASN1_item_d2i_bio.pod DEPEND[html/man3/ASN1_item_sign.html]=man3/ASN1_item_sign.pod GENERATE[html/man3/ASN1_item_sign.html]=man3/ASN1_item_sign.pod DEPEND[man/man3/ASN1_item_sign.3]=man3/ASN1_item_sign.pod @@ -2826,6 +2830,7 @@ html/man3/ASN1_STRING_print_ex.html \ html/man3/ASN1_TIME_set.html \ html/man3/ASN1_TYPE_get.html \ html/man3/ASN1_generate_nconf.html \ +html/man3/ASN1_item_d2i_bio.html \ html/man3/ASN1_item_sign.html \ html/man3/ASYNC_WAIT_CTX_new.html \ html/man3/ASYNC_start_job.html \ @@ -3413,6 +3418,7 @@ man/man3/ASN1_STRING_print_ex.3 \ man/man3/ASN1_TIME_set.3 \ man/man3/ASN1_TYPE_get.3 \ man/man3/ASN1_generate_nconf.3 \ +man/man3/ASN1_item_d2i_bio.3 \ man/man3/ASN1_item_sign.3 \ man/man3/ASYNC_WAIT_CTX_new.3 \ man/man3/ASYNC_start_job.3 \ 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 |