1.\" $OpenBSD: OpenSSL_add_all_algorithms.3,v 1.8 2019/06/14 13:41:31 schwarze Exp $ 2.\" full merge up to: OpenSSL b3696a55 Sep 2 09:35:50 2017 -0400 3.\" 4.\" This file was written by Dr. Stephen Henson <steve@openssl.org>. 5.\" Copyright (c) 2000, 2003, 2013 The OpenSSL Project. All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 11.\" 1. Redistributions of source code must retain the above copyright 12.\" notice, this list of conditions and the following disclaimer. 13.\" 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in 16.\" the documentation and/or other materials provided with the 17.\" distribution. 18.\" 19.\" 3. All advertising materials mentioning features or use of this 20.\" software must display the following acknowledgment: 21.\" "This product includes software developed by the OpenSSL Project 22.\" for use in the OpenSSL Toolkit. (http://www.openssl.org/)" 23.\" 24.\" 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to 25.\" endorse or promote products derived from this software without 26.\" prior written permission. For written permission, please contact 27.\" openssl-core@openssl.org. 28.\" 29.\" 5. Products derived from this software may not be called "OpenSSL" 30.\" nor may "OpenSSL" appear in their names without prior written 31.\" permission of the OpenSSL Project. 32.\" 33.\" 6. Redistributions of any form whatsoever must retain the following 34.\" acknowledgment: 35.\" "This product includes software developed by the OpenSSL Project 36.\" for use in the OpenSSL Toolkit (http://www.openssl.org/)" 37.\" 38.\" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY 39.\" EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 40.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 41.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR 42.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 43.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 44.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 45.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 46.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 47.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 50.\" 51.Dd $Mdocdate: June 14 2019 $ 52.Dt OPENSSL_ADD_ALL_ALGORITHMS 3 53.Os 54.Sh NAME 55.Nm OpenSSL_add_all_algorithms , 56.Nm OpenSSL_add_all_ciphers , 57.Nm OpenSSL_add_all_digests , 58.Nm EVP_cleanup 59.Nd add algorithms to internal table 60.Sh SYNOPSIS 61.In openssl/evp.h 62.Ft void 63.Fn OpenSSL_add_all_algorithms void 64.Ft void 65.Fn OpenSSL_add_all_ciphers void 66.Ft void 67.Fn OpenSSL_add_all_digests void 68.Ft void 69.Fn EVP_cleanup void 70.Sh DESCRIPTION 71These functions are deprecated. 72It is never useful for any application program 73to call any of them explicitly. 74The library automatically calls them internally whenever needed. 75.Pp 76OpenSSL keeps an internal table of digest algorithms and ciphers. 77It uses this table to look up ciphers via functions such as 78.Xr EVP_get_cipherbyname 3 . 79.Pp 80.Fn OpenSSL_add_all_algorithms 81adds all algorithms to the table (digests and ciphers). 82If an application is compiled with the preprocessor symbol 83.Dv OPENSSL_LOAD_CONF 84#define'd, it also calls 85.Xr OPENSSL_config 3 86with a 87.Dv NULL 88argument, loading the default configuration file. 89.Pp 90.Fn OpenSSL_add_all_digests 91adds all digest algorithms to the table. 92.Pp 93.Fn OpenSSL_add_all_ciphers 94adds all encryption algorithms to the table including password based 95encryption algorithms. 96.Pp 97If any of the above functions is called more than once, 98only the first call has an effect. 99.Pp 100.Fn EVP_cleanup 101removes all ciphers and digests from the table. 102.Sh SEE ALSO 103.Xr evp 3 , 104.Xr EVP_DigestInit 3 , 105.Xr EVP_EncryptInit 3 , 106.Xr OPENSSL_config 3 107.Sh HISTORY 108.Fn EVP_cleanup 109and precursor functions 110.Fn SSLeay_add_all_algorithms , 111.Fn SSLeay_add_all_ciphers , 112and 113.Fn SSLeay_add_all_digests 114first appeared in SSLeay 0.8.0 and have been available since 115.Ox 2.4 . 116.Pp 117.Fn OpenSSL_add_all_algorithms , 118.Fn OpenSSL_add_all_ciphers , 119and 120.Fn OpenSSL_add_all_digests 121first appeared in OpenSSL 0.9.5 and have been available since 122.Ox 2.7 . 123.Sh BUGS 124Although the functions do not return error codes, it is possible for them 125to fail. 126This will only happen as a result of a memory allocation failure so this 127is not too much of a problem in practice. 128