OpenBSD manual page server

NAME

OpenSSL_add_all_algorithms, OpenSSL_add_all_ciphers, OpenSSL_add_all_digests, EVP_cleanup, SSLeay_add_all_algorithms — add algorithms to internal table

SYNOPSIS

#include <openssl/evp.h>

void
OpenSSL_add_all_algorithms(void);

void
OpenSSL_add_all_ciphers(void);

void
OpenSSL_add_all_digests(void);

void
EVP_cleanup(void);

void
SSLeay_add_all_algorithms(void);

DESCRIPTION

These functions are deprecated. It is never useful for any application program to call any of them explicitly. The library automatically calls them internally whenever needed.

OpenSSL keeps an internal table of digest algorithms and ciphers. It uses this table to look up ciphers via functions such as EVP_get_cipherbyname(3).

OpenSSL_add_all_algorithms() adds all algorithms to the table (digests and ciphers). If an application is compiled with the preprocessor symbol OPENSSL_LOAD_CONF #define'd, it also calls OPENSSL_config(3) with a NULL argument, loading the default configuration file.

OpenSSL_add_all_digests() adds all digest algorithms to the table.

OpenSSL_add_all_ciphers() adds all encryption algorithms to the table including password based encryption algorithms.

If any of the above functions is called more than once, only the first call has an effect.

EVP_cleanup() removes all ciphers and digests from the table and also calls OBJ_NAME_cleanup(3) with an argument of -1 , 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.

SSLeay_add_all_algorithms() is a deprecated alias for OpenSSL_add_all_algorithms().

OpenSSL_add_all_algorithms() and SSLeay_add_all_algorithms() are implemented as macros.

SEE ALSO

evp(3), EVP_DigestInit(3), EVP_EncryptInit(3), OBJ_cleanup(3), OBJ_NAME_add(3), OPENSSL_config(3)

HISTORY

EVP_cleanup(), SSLeay_add_all_algorithms(), and precursor functions SSLeay_add_all_ciphers() and SSLeay_add_all_digests() first appeared in SSLeay 0.8.0 and have been available since OpenBSD 2.4.

OpenSSL_add_all_algorithms(), OpenSSL_add_all_ciphers(), and OpenSSL_add_all_digests() first appeared in OpenSSL 0.9.5 and have been available since OpenBSD 2.7.

BUGS

Although the functions do not return error codes, it is possible for them to fail. This will only happen as a result of a memory allocation failure so this is not too much of a problem in practice.