Briefly mention SSLeay_add_all_algorithms(3) because
authorschwarze <schwarze@openbsd.org>
Sun, 10 Sep 2023 14:39:58 +0000 (14:39 +0000)
committerschwarze <schwarze@openbsd.org>
Sun, 10 Sep 2023 14:39:58 +0000 (14:39 +0000)
surprisingly large numbers of software packages still call it.

Mark the unused aliases OPENSSL_add_all_algorithms_conf(3),
OPENSSL_add_all_algorithms_noconf(3), SSLeay_add_all_ciphers(3),
and SSLeay_add_all_digests(3) as intentionally undicumented.

lib/libcrypto/man/OpenSSL_add_all_algorithms.3

index 7c4a4cd..0c41120 100644 (file)
@@ -1,4 +1,4 @@
-.\" $OpenBSD: OpenSSL_add_all_algorithms.3,v 1.13 2023/08/25 05:38:52 tb Exp $
+.\" $OpenBSD: OpenSSL_add_all_algorithms.3,v 1.14 2023/09/10 14:39:58 schwarze Exp $
 .\" full merge up to: OpenSSL b3696a55 Sep 2 09:35:50 2017 -0400
 .\"
 .\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: August 25 2023 $
+.Dd $Mdocdate: September 10 2023 $
 .Dt OPENSSL_ADD_ALL_ALGORITHMS 3
 .Os
 .Sh NAME
 .Nm OpenSSL_add_all_algorithms ,
 .Nm OpenSSL_add_all_ciphers ,
 .Nm OpenSSL_add_all_digests ,
-.Nm EVP_cleanup
+.Nm EVP_cleanup ,
+.Nm SSLeay_add_all_algorithms
+.\" .Nm OPENSSL_add_all_algorithms_conf ,
+.\" .Nm OPENSSL_add_all_algorithms_noconf ,
+.\" .Nm SSLeay_add_all_ciphers , and
+.\" .Nm SSLeay_add_all_digests are intentionally undocumented
+.\" because they are unused aliases.
 .Nd add algorithms to internal table
 .Sh SYNOPSIS
 .In openssl/evp.h
@@ -67,6 +73,8 @@
 .Fn OpenSSL_add_all_digests void
 .Ft void
 .Fn EVP_cleanup void
+.Ft void
+.Fn SSLeay_add_all_algorithms void
 .Sh DESCRIPTION
 These functions are deprecated.
 It is never useful for any application program
@@ -105,6 +113,10 @@ thus resetting the global associative array of names
 and all signature algorithm definitions to their default states,
 removing all application-defined types, key-value pairs, and aliases,
 including any that are unrelated to the EVP library.
+.Pp
+.Fn SSLeay_add_all_algorithms
+is a deprecated alias for
+.Fn OpenSSL_add_all_algorithms .
 .Sh SEE ALSO
 .Xr evp 3 ,
 .Xr EVP_add_cipher 3 ,
@@ -114,10 +126,10 @@ including any that are unrelated to the EVP library.
 .Xr OBJ_NAME_add 3 ,
 .Xr OPENSSL_config 3
 .Sh HISTORY
-.Fn EVP_cleanup
-and precursor functions
+.Fn EVP_cleanup ,
 .Fn SSLeay_add_all_algorithms ,
-.Fn SSLeay_add_all_ciphers ,
+and precursor functions
+.Fn SSLeay_add_all_ciphers
 and
 .Fn SSLeay_add_all_digests
 first appeared in SSLeay 0.8.0 and have been available since