openssl-list.pod.in 5.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232
  1. =pod
  2. {- OpenSSL::safe::output_do_not_edit_headers(); -}
  3. =head1 NAME
  4. openssl-list - list algorithms and features
  5. =head1 SYNOPSIS
  6. B<openssl list>
  7. [B<-help>]
  8. [B<-verbose>]
  9. [B<-select> I<name>]
  10. [B<-1>]
  11. [B<-commands>]
  12. [B<-digest-algorithms>]
  13. {- output_off() if $disabled{"deprecated-3.0"}; ""
  14. -}[B<-digest-commands>]
  15. {- output_on() if $disabled{"deprecated-3.0"}; ""
  16. -}[B<-kdf-algorithms>]
  17. [B<-mac-algorithms>]
  18. [B<-random-generators>]
  19. [B<-cipher-algorithms>]
  20. {- output_off() if $disabled{"deprecated-3.0"}; ""
  21. -}[B<-cipher-commands>]
  22. {- output_on() if $disabled{"deprecated-3.0"}; ""
  23. -}[B<-encoders>]
  24. [B<-decoders>]
  25. [B<-key-managers>]
  26. [B<-key-exchange-algorithms>]
  27. [B<-kem-algorithms>]
  28. [B<-signature-algorithms>]
  29. [B<-asymcipher-algorithms>]
  30. [B<-public-key-algorithms>]
  31. [B<-public-key-methods>]
  32. [B<-providers>]
  33. {- output_off() if $disabled{"deprecated-3.0"}; ""
  34. -}[B<-engines>]
  35. {- output_on() if $disabled{"deprecated-3.0"}; ""
  36. -}[B<-disabled>]
  37. [B<-objects>]
  38. [B<-options> I<command>]
  39. {- $OpenSSL::safe::opt_provider_synopsis -}
  40. =head1 DESCRIPTION
  41. This command is used to generate list of algorithms or disabled
  42. features.
  43. =head1 OPTIONS
  44. =over 4
  45. =item B<-help>
  46. Display a usage message.
  47. =item B<-verbose>
  48. Displays extra information.
  49. The options below where verbosity applies say a bit more about what that means.
  50. =item B<-select> I<name>
  51. Only list algorithms that match this name.
  52. =item B<-1>
  53. List the commands, digest-commands, or cipher-commands in a single column.
  54. If used, this option must be given first.
  55. =item B<-commands>
  56. Display a list of standard commands.
  57. =item B<-digest-commands>
  58. This option is deprecated. Use B<digest-algorithms> instead.
  59. Display a list of message digest commands, which are typically used
  60. as input to the L<openssl-dgst(1)> or L<openssl-speed(1)> commands.
  61. =item B<-cipher-commands>
  62. This option is deprecated. Use B<cipher-algorithms> instead.
  63. Display a list of cipher commands, which are typically used as input
  64. to the L<openssl-enc(1)> or L<openssl-speed(1)> commands.
  65. =item B<-digest-algorithms>, B<-kdf-algorithms>, B<-mac-algorithms>,
  66. B<-cipher-algorithms>
  67. Display a list of cipher, digest, kdf and mac algorithms.
  68. See L</Display of algorithm names> for a description of how names are
  69. displayed.
  70. In verbose mode, the algorithms provided by a provider will get additional
  71. information on what parameters each implementation supports.
  72. =item B<-random-generators>
  73. Display a list of random number generators.
  74. See L</Display of algorithm names> for a description of how names are
  75. displayed.
  76. =item B<-encoders>
  77. Display a list of encoders.
  78. See L</Display of algorithm names> for a description of how names are
  79. displayed.
  80. In verbose mode, the algorithms provided by a provider will get additional
  81. information on what parameters each implementation supports.
  82. =item B<-decoders>
  83. Display a list of decoders.
  84. See L</Display of algorithm names> for a description of how names are
  85. displayed.
  86. In verbose mode, the algorithms provided by a provider will get additional
  87. information on what parameters each implementation supports.
  88. =item B<-public-key-algorithms>
  89. Display a list of public key algorithms, with each algorithm as
  90. a block of multiple lines, all but the first are indented.
  91. The options B<key-exchange-algorithms>, B<kem-algorithms>,
  92. B<signature-algorithms>, and B<asymcipher-algorithms> will display similar info.
  93. =item B<-public-key-methods>
  94. Display a list of public key methods.
  95. =item B<-key-managers>
  96. Display a list of key managers.
  97. =item B<-key-exchange-algorithms>
  98. Display a list of key exchange algorithms.
  99. =item B<-kem-algorithms>
  100. Display a list of key encapsulation algorithms.
  101. =item B<-signature-algorithms>
  102. Display a list of signature algorithms.
  103. =item B<-asymcipher-algorithms>
  104. Display a list of asymmetric cipher algorithms.
  105. =item B<-providers>
  106. Display a list of all loaded providers with their names, version and status.
  107. In verbose mode, the full version and all provider parameters will additionally
  108. be displayed.
  109. =item B<-engines>
  110. This option is deprecated.
  111. Display a list of loaded engines.
  112. =item B<-disabled>
  113. Display a list of disabled features, those that were compiled out
  114. of the installation.
  115. =item B<-objects>
  116. Display a list of built in objects, i.e. OIDs with names. They're listed in the
  117. format described in L<config(5)/ASN1 Object Configuration Module>.
  118. =item B<-options> I<command>
  119. Output a two-column list of the options accepted by the specified I<command>.
  120. The first is the option name, and the second is a one-character indication
  121. of what type of parameter it takes, if any.
  122. This is an internal option, used for checking that the documentation
  123. is complete.
  124. {- $OpenSSL::safe::opt_provider_item -}
  125. =back
  126. =head2 Display of algorithm names
  127. Algorithm names may be displayed in one of two manners:
  128. =over 4
  129. =item Legacy implementations
  130. Legacy implementations will simply display the main name of the
  131. algorithm on a line of its own, or in the form C<<foo > bar>> to show
  132. that C<foo> is an alias for the main name, C<bar>
  133. =item Provided implementations
  134. Implementations from a provider are displayed like this if the
  135. implementation is labeled with a single name:
  136. foo @ bar
  137. or like this if it's labeled with multiple names:
  138. { foo1, foo2 } @bar
  139. In both cases, C<bar> is the name of the provider.
  140. =back
  141. =head1 HISTORY
  142. The B<-engines>, B<-digest-commands>, and B<-cipher-commands> options
  143. were deprecated in OpenSSL 3.0.
  144. =head1 COPYRIGHT
  145. Copyright 2016-2020 The OpenSSL Project Authors. All Rights Reserved.
  146. Licensed under the Apache License 2.0 (the "License"). You may not use
  147. this file except in compliance with the License. You can obtain a copy
  148. in the file LICENSE in the source distribution or at
  149. L<https://www.openssl.org/source/license.html>.
  150. =cut