Commit 7afe1f9597 for openssl.org
commit 7afe1f95977fd2ddbf09127a32a114fa9f019bb6
Author: Eugene Syromiatnikov <esyr@openssl.org>
Date: Tue Sep 22 17:30:43 2026 +0200
doc/man3/ASN1_STRING_length.pod: document ASN1_STRING_copy()
Signed-off-by: Eugene Syromiatnikov <esyr@openssl.org>
Reviewed-by: Tomas Mraz <tomas@openssl.foundation>
Reviewed-by: Nikola Pajkovsky <nikolap@openssl.org>
Merge-date: Tue Nov 10 15:06:57 2026
Merged-from: https://github.com/openssl/openssl/pull/32937
diff --git a/doc/man3/ASN1_STRING_length.pod b/doc/man3/ASN1_STRING_length.pod
index e3b1bfe16a..4f982f0a0f 100644
--- a/doc/man3/ASN1_STRING_length.pod
+++ b/doc/man3/ASN1_STRING_length.pod
@@ -3,6 +3,7 @@
=head1 NAME
ASN1_STRING_get0_data,
+ASN1_STRING_copy,
ASN1_STRING_dup,
ASN1_STRING_cmp,
ASN1_STRING_type,
@@ -20,6 +21,8 @@ ASN1_STRING_length
const unsigned char *ASN1_STRING_get0_data(const ASN1_STRING *x);
+ int ASN1_STRING_copy(ASN1_STRING *dst, const ASN1_STRING *str);
+
ASN1_STRING *ASN1_STRING_dup(const ASN1_STRING *a);
int ASN1_STRING_cmp(ASN1_STRING *a, ASN1_STRING *b);
@@ -52,6 +55,9 @@ ASN1_STRING_get0_data() returns an internal pointer to the data of I<x>.
Since this is an internal pointer it should B<not> be freed or
modified in any way. I<x> B<MUST NOT> be NULL.
+ASN1_STRING_copy() copies the string type and content (along with the relevant
+internal attributes) from I<str> to I<dst>.
+
ASN1_STRING_dup() returns a copy of the structure I<a>.
ASN1_STRING_cmp() compares I<a> and I<b> returning 0 if the two
@@ -128,6 +134,10 @@ ASN1_STRING_length() returns the length of the content of I<x>.
ASN1_STRING_get0_data() returns an internal pointer to
the data of I<x>.
+ASN1_STRING_copy() returns 1 on success, or 0 on error or failure.
+If the call was not successful, I<dst> may be left in an inconsistent state,
+and can no longer be used.
+
ASN1_STRING_dup() returns a valid B<ASN1_STRING> structure or NULL if an
error occurred.
diff --git a/util/missingcrypto.txt b/util/missingcrypto.txt
index 13296b7c9e..69fe684203 100644
--- a/util/missingcrypto.txt
+++ b/util/missingcrypto.txt
@@ -82,7 +82,6 @@ ASN1_SCTX_set_app_data(3)
ASN1_SEQUENCE_ANY_it(3)
ASN1_SEQUENCE_it(3)
ASN1_SET_ANY_it(3)
-ASN1_STRING_copy(3)
ASN1_STRING_get_default_mask(3)
ASN1_STRING_length_set(3)
ASN1_STRING_set0(3)