OSSL_PROVIDER-legacy.7ossl 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155
  1. .\" -*- mode: troff; coding: utf-8 -*-
  2. .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
  3. .\"
  4. .\" Standard preamble:
  5. .\" ========================================================================
  6. .de Sp \" Vertical space (when we can't use .PP)
  7. .if t .sp .5v
  8. .if n .sp
  9. ..
  10. .de Vb \" Begin verbatim text
  11. .ft CW
  12. .nf
  13. .ne \\$1
  14. ..
  15. .de Ve \" End verbatim text
  16. .ft R
  17. .fi
  18. ..
  19. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
  20. .ie n \{\
  21. . ds C` ""
  22. . ds C' ""
  23. 'br\}
  24. .el\{\
  25. . ds C`
  26. . ds C'
  27. 'br\}
  28. .\"
  29. .\" Escape single quotes in literal strings from groff's Unicode transform.
  30. .ie \n(.g .ds Aq \(aq
  31. .el .ds Aq '
  32. .\"
  33. .\" If the F register is >0, we'll generate index entries on stderr for
  34. .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
  35. .\" entries marked with X<> in POD. Of course, you'll have to process the
  36. .\" output yourself in some meaningful fashion.
  37. .\"
  38. .\" Avoid warning from groff about undefined register 'F'.
  39. .de IX
  40. ..
  41. .nr rF 0
  42. .if \n(.g .if rF .nr rF 1
  43. .if (\n(rF:(\n(.g==0)) \{\
  44. . if \nF \{\
  45. . de IX
  46. . tm Index:\\$1\t\\n%\t"\\$2"
  47. ..
  48. . if !\nF==2 \{\
  49. . nr % 0
  50. . nr F 2
  51. . \}
  52. . \}
  53. .\}
  54. .rr rF
  55. .\" ========================================================================
  56. .\"
  57. .IX Title "OSSL_PROVIDER-LEGACY 7ossl"
  58. .TH OSSL_PROVIDER-LEGACY 7ossl 2025-01-17 3.4.0 OpenSSL
  59. .\" For nroff, turn off justification. Always turn off hyphenation; it makes
  60. .\" way too many mistakes in technical documents.
  61. .if n .ad l
  62. .nh
  63. .SH NAME
  64. OSSL_PROVIDER\-legacy \- OpenSSL legacy provider
  65. .SH DESCRIPTION
  66. .IX Header "DESCRIPTION"
  67. The OpenSSL legacy provider supplies OpenSSL implementations of algorithms
  68. that have been deemed legacy. Such algorithms have commonly fallen out of
  69. use, have been deemed insecure by the cryptography community, or something
  70. similar.
  71. .PP
  72. We can consider this the retirement home of cryptographic algorithms.
  73. .SS Properties
  74. .IX Subsection "Properties"
  75. The implementations in this provider specifically has this property
  76. defined:
  77. .IP """provider=legacy""" 4
  78. .IX Item """provider=legacy"""
  79. .PP
  80. It may be used in a property query string with fetching functions such as
  81. \&\fBEVP_MD_fetch\fR\|(3) or \fBEVP_CIPHER_fetch\fR\|(3), as well as with other
  82. functions that take a property query string, such as
  83. \&\fBEVP_PKEY_CTX_new_from_name\fR\|(3).
  84. .PP
  85. It isn't mandatory to query for any of these properties, except to
  86. make sure to get implementations of this provider and none other.
  87. .SH "OPERATIONS AND ALGORITHMS"
  88. .IX Header "OPERATIONS AND ALGORITHMS"
  89. The OpenSSL legacy provider supports these operations and algorithms:
  90. .SS "Hashing Algorithms / Message Digests"
  91. .IX Subsection "Hashing Algorithms / Message Digests"
  92. .IP "MD2, see \fBEVP_MD\-MD2\fR\|(7)" 4
  93. .IX Item "MD2, see EVP_MD-MD2"
  94. Disabled by default. Use \fIenable\-md2\fR config option to enable.
  95. .IP "MD4, see \fBEVP_MD\-MD4\fR\|(7)" 4
  96. .IX Item "MD4, see EVP_MD-MD4"
  97. .PD 0
  98. .IP "MDC2, see \fBEVP_MD\-MDC2\fR\|(7)" 4
  99. .IX Item "MDC2, see EVP_MD-MDC2"
  100. .IP "WHIRLPOOL, see \fBEVP_MD\-WHIRLPOOL\fR\|(7)" 4
  101. .IX Item "WHIRLPOOL, see EVP_MD-WHIRLPOOL"
  102. .IP "RIPEMD160, see \fBEVP_MD\-RIPEMD160\fR\|(7)" 4
  103. .IX Item "RIPEMD160, see EVP_MD-RIPEMD160"
  104. .PD
  105. .SS "Symmetric Ciphers"
  106. .IX Subsection "Symmetric Ciphers"
  107. Not all of these symmetric cipher algorithms are enabled by default.
  108. .IP "Blowfish, see \fBEVP_CIPHER\-BLOWFISH\fR\|(7)" 4
  109. .IX Item "Blowfish, see EVP_CIPHER-BLOWFISH"
  110. .PD 0
  111. .IP "CAST, see \fBEVP_CIPHER\-CAST\fR\|(7)" 4
  112. .IX Item "CAST, see EVP_CIPHER-CAST"
  113. .IP "DES, see \fBEVP_CIPHER\-DES\fR\|(7)" 4
  114. .IX Item "DES, see EVP_CIPHER-DES"
  115. .PD
  116. The algorithm names are: DES_ECB, DES_CBC, DES_OFB, DES_CFB, DES_CFB1, DES_CFB8
  117. and DESX_CBC.
  118. .IP "IDEA, see \fBEVP_CIPHER\-IDEA\fR\|(7)" 4
  119. .IX Item "IDEA, see EVP_CIPHER-IDEA"
  120. .PD 0
  121. .IP "RC2, see \fBEVP_CIPHER\-RC2\fR\|(7)" 4
  122. .IX Item "RC2, see EVP_CIPHER-RC2"
  123. .IP "RC4, see \fBEVP_CIPHER\-RC4\fR\|(7)" 4
  124. .IX Item "RC4, see EVP_CIPHER-RC4"
  125. .IP "RC5, see \fBEVP_CIPHER\-RC5\fR\|(7)" 4
  126. .IX Item "RC5, see EVP_CIPHER-RC5"
  127. .PD
  128. Disabled by default. Use \fIenable\-rc5\fR config option to enable.
  129. .IP "SEED, see \fBEVP_CIPHER\-SEED\fR\|(7)" 4
  130. .IX Item "SEED, see EVP_CIPHER-SEED"
  131. .SS "Key Derivation Function (KDF)"
  132. .IX Subsection "Key Derivation Function (KDF)"
  133. .PD 0
  134. .IP PBKDF1 4
  135. .IX Item "PBKDF1"
  136. .IP PVKKDF 4
  137. .IX Item "PVKKDF"
  138. .PD
  139. .SH "SEE ALSO"
  140. .IX Header "SEE ALSO"
  141. \&\fBOSSL_PARAM\fR\|(3),
  142. \&\fBopenssl\-core.h\fR\|(7),
  143. \&\fBopenssl\-core_dispatch.h\fR\|(7),
  144. \&\fBprovider\fR\|(7)
  145. .SH HISTORY
  146. .IX Header "HISTORY"
  147. This functionality was added in OpenSSL 3.0.
  148. .SH COPYRIGHT
  149. .IX Header "COPYRIGHT"
  150. Copyright 2020\-2021 The OpenSSL Project Authors. All Rights Reserved.
  151. .PP
  152. Licensed under the Apache License 2.0 (the "License"). You may not use
  153. this file except in compliance with the License. You can obtain a copy
  154. in the file LICENSE in the source distribution or at
  155. <https://www.openssl.org/source/license.html>.