lib/libcrypto/man/OpenSSL_add_all_algorithms.3

   1 .\" $OpenBSD: OpenSSL_add_all_algorithms.3,v 1.7 2018/03/27 17:35:50 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: March 27 2018 $
  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
  71 These functions are deprecated.
  72 It is never useful for any application program
  73 to call any of them explicitly.
  74 The library automatically calls them internally whenever needed.
  75 .Pp
  76 OpenSSL keeps an internal table of digest algorithms and ciphers.
  77 It 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
  81 adds all algorithms to the table (digests and ciphers).
  82 .Pp
  83 .Fn OpenSSL_add_all_digests
  84 adds all digest algorithms to the table.
  85 .Pp
  86 .Fn OpenSSL_add_all_ciphers
  87 adds all encryption algorithms to the table including password based
  88 encryption algorithms.
  89 .Pp
  90 If any of the above functions is called more than once,
  91 only the first call has an effect.
  92 .Pp
  93 .Fn EVP_cleanup
  94 removes all ciphers and digests from the table.
  95 .Sh SEE ALSO
  96 .Xr evp 3 ,
  97 .Xr EVP_DigestInit 3 ,
  98 .Xr EVP_EncryptInit 3 ,
  99 .Xr OPENSSL_config 3 ,
 100 .Xr OPENSSL_init_crypto 3
 101 .Sh HISTORY
 102 .Fn EVP_cleanup
 103 and precursor functions
 104 .Fn SSLeay_add_all_algorithms ,
 105 .Fn SSLeay_add_all_ciphers ,
 106 and
 107 .Fn SSLeay_add_all_digests
 108 first appeared in SSLeay 0.8.0 and have been available since
 109 .Ox 2.4 .
 110 .Pp
 111 .Fn OpenSSL_add_all_algorithms ,
 112 .Fn OpenSSL_add_all_ciphers ,
 113 and
 114 .Fn OpenSSL_add_all_digests
 115 first appeared in OpenSSL 0.9.5 and have been available since
 116 .Ox 2.7 .
 117 .Sh BUGS
 118 Although the functions do not return error codes, it is possible for them
 119 to fail.
 120 This will only happen as a result of a memory allocation failure so this
 121 is not too much of a problem in practice.