Commit 76d410e11d for openssl.org

commit 76d410e11de22f12c2d423bb4171ee0175d67ae3
Author: Eugene Syromiatnikov <esyr@openssl.org>
Date:   Tue Sep 22 16:43:33 2026 +0200

    doc/man3/ASN1_STRING_new.pod: document ASN1_STRING_clear_free()

    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:55 2026
    Merged-from: https://github.com/openssl/openssl/pull/32937

diff --git a/doc/man3/ASN1_STRING_new.pod b/doc/man3/ASN1_STRING_new.pod
index 6f8abc6f87..c6fbb9b67f 100644
--- a/doc/man3/ASN1_STRING_new.pod
+++ b/doc/man3/ASN1_STRING_new.pod
@@ -5,7 +5,8 @@
 ASN1_STRING_new,
 ASN1_STRING_type_new,
 ASN1_STRING_new_not_owned,
-ASN1_STRING_free
+ASN1_STRING_free,
+ASN1_STRING_clear_free
 - ASN1_STRING allocation functions

 =head1 SYNOPSIS
@@ -21,6 +22,8 @@ ASN1_STRING_free

  void ASN1_STRING_free(ASN1_STRING *a);

+ void ASN1_STRING_clear_free(ASN1_STRING *a);
+
 =head1 DESCRIPTION

 ASN1_STRING_new() returns an allocated B<ASN1_STRING> structure. Its type
@@ -41,6 +44,9 @@ data size exceeds the internal limit of the B<ASN1_STRING> implementation.
 ASN1_STRING_free() frees up I<a>.
 If I<a> is NULL nothing is done.

+ASN1_STRING_clear_free() is similar to ASN1_STRING_free() in behaviour,
+but uses OPENSSL_clear_free() instead of OPENSSL_free() to free up memory.
+
 =head1 NOTES

 Other string types call the B<ASN1_STRING> functions. For example
@@ -57,7 +63,7 @@ ASN1_STRING_new(), ASN1_STRING_type_new(), and
 ASN1_STRING_new_not_owned() return a valid B<ASN1_STRING>
 structure or NULL if an error occurred.

-ASN1_STRING_free() does not return a value.
+ASN1_STRING_free() and ASN1_STRING_clear_free() do not return a value.

 =head1 SEE ALSO

diff --git a/util/missingcrypto.txt b/util/missingcrypto.txt
index bbf4f086ed..13296b7c9e 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_clear_free(3)
 ASN1_STRING_copy(3)
 ASN1_STRING_get_default_mask(3)
 ASN1_STRING_length_set(3)