diff options
Diffstat (limited to 'src/lib/libcrypto/man/OpenSSL_add_all_algorithms.3')
-rw-r--r-- | src/lib/libcrypto/man/OpenSSL_add_all_algorithms.3 | 34 |
1 files changed, 13 insertions, 21 deletions
diff --git a/src/lib/libcrypto/man/OpenSSL_add_all_algorithms.3 b/src/lib/libcrypto/man/OpenSSL_add_all_algorithms.3 index ff1c3df6d9..64f71590fe 100644 --- a/src/lib/libcrypto/man/OpenSSL_add_all_algorithms.3 +++ b/src/lib/libcrypto/man/OpenSSL_add_all_algorithms.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: OpenSSL_add_all_algorithms.3,v 1.17 2025/06/08 22:40:30 schwarze Exp $ | 1 | .\" $OpenBSD: OpenSSL_add_all_algorithms.3,v 1.18 2025/06/09 12:43:53 schwarze Exp $ |
2 | .\" full merge up to: OpenSSL b3696a55 Sep 2 09:35:50 2017 -0400 | 2 | .\" full merge up to: OpenSSL b3696a55 Sep 2 09:35:50 2017 -0400 |
3 | .\" | 3 | .\" |
4 | .\" This file was written by Dr. Stephen Henson <steve@openssl.org>. | 4 | .\" This file was written by Dr. Stephen Henson <steve@openssl.org>. |
@@ -48,7 +48,7 @@ | |||
48 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED | 48 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED |
49 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. | 49 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. |
50 | .\" | 50 | .\" |
51 | .Dd $Mdocdate: June 8 2025 $ | 51 | .Dd $Mdocdate: June 9 2025 $ |
52 | .Dt OPENSSL_ADD_ALL_ALGORITHMS 3 | 52 | .Dt OPENSSL_ADD_ALL_ALGORITHMS 3 |
53 | .Os | 53 | .Os |
54 | .Sh NAME | 54 | .Sh NAME |
@@ -80,17 +80,21 @@ | |||
80 | These functions are deprecated. | 80 | These functions are deprecated. |
81 | It is never useful for any application program | 81 | It is never useful for any application program |
82 | to call any of them explicitly. | 82 | to call any of them explicitly. |
83 | The library automatically calls them internally whenever needed. | ||
84 | .Pp | 83 | .Pp |
85 | OpenSSL keeps an internal table of digest algorithms and ciphers. | 84 | The library contains internal tables of digest algorithms and ciphers. |
86 | It uses this table to look up ciphers via functions such as | 85 | It uses these tables to look up digests and ciphers via |
87 | .Xr EVP_get_cipherbyname 3 . | 86 | .Xr EVP_get_digestbyname 3 |
87 | and | ||
88 | .Xr EVP_get_cipherbyname 3 , | ||
89 | respectively. | ||
90 | In LibreSSL, these tables are static constants and do not require | ||
91 | initialization. | ||
88 | .Pp | 92 | .Pp |
89 | .Fn OpenSSL_add_all_algorithms | 93 | .Fn OpenSSL_add_all_algorithms |
90 | adds all algorithms to the table (digests and ciphers). | 94 | adds all algorithms to the table (digests and ciphers). |
91 | If an application is compiled with the preprocessor symbol | 95 | If an application is compiled with the preprocessor symbol |
92 | .Dv OPENSSL_LOAD_CONF | 96 | .Dv OPENSSL_LOAD_CONF |
93 | #define'd, it also calls | 97 | defined, it also calls |
94 | .Xr OPENSSL_config 3 | 98 | .Xr OPENSSL_config 3 |
95 | with a | 99 | with a |
96 | .Dv NULL | 100 | .Dv NULL |
@@ -103,17 +107,9 @@ adds all digest algorithms to the table. | |||
103 | adds all encryption algorithms to the table including password based | 107 | adds all encryption algorithms to the table including password based |
104 | encryption algorithms. | 108 | encryption algorithms. |
105 | .Pp | 109 | .Pp |
106 | If any of the above functions is called more than once, | ||
107 | only the first call has an effect. | ||
108 | .Pp | ||
109 | .Fn EVP_cleanup | 110 | .Fn EVP_cleanup |
110 | removes all ciphers and digests from the table and also calls | 111 | has no effect; it used to remove various kinds of application-supplied |
111 | .Xr OBJ_NAME_cleanup 3 | 112 | data that is no longer supported in the first place. |
112 | with an argument of \-1 , | ||
113 | thus resetting the global associative array of names | ||
114 | and all signature algorithm definitions to their default states, | ||
115 | removing all application-defined types, key-value pairs, and aliases, | ||
116 | including any that are unrelated to the EVP library. | ||
117 | .Pp | 113 | .Pp |
118 | .Fn SSLeay_add_all_algorithms | 114 | .Fn SSLeay_add_all_algorithms |
119 | is a deprecated alias for | 115 | is a deprecated alias for |
@@ -127,8 +123,6 @@ are implemented as macros. | |||
127 | .Xr evp 3 , | 123 | .Xr evp 3 , |
128 | .Xr EVP_DigestInit 3 , | 124 | .Xr EVP_DigestInit 3 , |
129 | .Xr EVP_EncryptInit 3 , | 125 | .Xr EVP_EncryptInit 3 , |
130 | .Xr OBJ_cleanup 3 , | ||
131 | .Xr OBJ_NAME_add 3 , | ||
132 | .Xr OPENSSL_config 3 | 126 | .Xr OPENSSL_config 3 |
133 | .Sh HISTORY | 127 | .Sh HISTORY |
134 | .Fn EVP_cleanup , | 128 | .Fn EVP_cleanup , |
@@ -149,5 +143,3 @@ first appeared in OpenSSL 0.9.5 and have been available since | |||
149 | .Sh BUGS | 143 | .Sh BUGS |
150 | Although the functions do not return error codes, it is possible for them | 144 | Although the functions do not return error codes, it is possible for them |
151 | to fail. | 145 | to fail. |
152 | This will only happen as a result of a memory allocation failure so this | ||
153 | is not too much of a problem in practice. | ||