1=pod 2 3=head1 NAME 4 5OSSL_PROVIDER-legacy - OpenSSL legacy provider 6 7=head1 DESCRIPTION 8 9The OpenSSL legacy provider supplies OpenSSL implementations of algorithms 10that have been deemed legacy. Such algorithms have commonly fallen out of 11use, have been deemed insecure by the cryptography community, or something 12similar. 13 14We can consider this the retirement home of cryptographic algorithms. 15 16=head2 Properties 17 18The implementations in this provider specifically has this property 19defined: 20 21=over 4 22 23=item "provider=legacy" 24 25=back 26 27It may be used in a property query string with fetching functions such as 28L<EVP_MD_fetch(3)> or L<EVP_CIPHER_fetch(3)>, as well as with other 29functions that take a property query string, such as 30L<EVP_PKEY_CTX_new_from_name(3)>. 31 32It isn't mandatory to query for any of these properties, except to 33make sure to get implementations of this provider and none other. 34 35=head1 OPERATIONS AND ALGORITHMS 36 37The OpenSSL legacy provider supports these operations and algorithms: 38 39=head2 Hashing Algorithms / Message Digests 40 41=over 4 42 43=item MD2, see L<EVP_MD-MD2(7)> 44 45=item MD4, see L<EVP_MD-MD4(7)> 46 47=item MDC2, see L<EVP_MD-MDC2(7)> 48 49=item WHIRLPOOL, see L<EVP_MD-WHIRLPOOL(7)> 50 51=item RIPEMD160, see L<EVP_MD-RIPEMD160(7)> 52 53=back 54 55=head2 Symmetric Ciphers 56 57Not all of these symmetric cipher algorithms are enabled by default. 58 59=over 4 60 61=item Blowfish, see L<EVP_CIPHER-BLOWFISH(7)> 62 63=item CAST, see L<EVP_CIPHER-CAST(7)> 64 65=item DES, see L<EVP_CIPHER-DES(7)> 66 67The algorithm names are: DES_ECB, DES_CBC, DES_OFB, DES_CFB, DES_CFB1, DES_CFB8 68and DESX_CBC. 69 70=item IDEA, see L<EVP_CIPHER-IDEA(7)> 71 72=item RC2, see L<EVP_CIPHER-RC2(7)> 73 74=item RC4, see L<EVP_CIPHER-RC4(7)> 75 76=item RC5, see L<EVP_CIPHER-RC5(7)> 77 78Disabled by default. Use I<enable-rc5> config option to enable. 79 80=item SEED, see L<EVP_CIPHER-SEED(7)> 81 82=back 83 84=head2 Key Derivation Function (KDF) 85 86=over 4 87 88=item PBKDF1 89 90=back 91 92=begin comment 93 94When algorithms for other operations start appearing, the 95following =head2 titles are appropriate to use: 96 97- Message Authentication Code (MAC) 98 99- Key Derivation Function (KDF) 100 101- Key Exchange 102 103- Signature 104 105- Asymmetric Cipher 106 107- Asymmetric Key Management 108 109=end comment 110 111=head1 SEE ALSO 112 113L<OSSL_PARAM(3)>, 114L<openssl-core.h(7)>, 115L<openssl-core_dispatch.h(7)>, 116L<provider(7)> 117 118=head1 HISTORY 119 120This functionality was added in OpenSSL 3.0. 121 122=head1 COPYRIGHT 123 124Copyright 2020-2021 The OpenSSL Project Authors. All Rights Reserved. 125 126Licensed under the Apache License 2.0 (the "License"). You may not use 127this file except in compliance with the License. You can obtain a copy 128in the file LICENSE in the source distribution or at 129L<https://www.openssl.org/source/license.html>. 130 131=cut 132