xref: /freebsd/crypto/openssl/doc/man1/openssl-list.pod.in (revision a03411e84728e9b267056fd31c7d1d9d1dc1b01e)
1=pod
2{- OpenSSL::safe::output_do_not_edit_headers(); -}
3
4=head1 NAME
5
6openssl-list - list algorithms and features
7
8=head1 SYNOPSIS
9
10B<openssl list>
11[B<-help>]
12[B<-verbose>]
13[B<-select> I<name>]
14[B<-1>]
15[B<-commands>]
16[B<-standard-commands>]
17[B<-digest-algorithms>]
18{- output_off() if $disabled{"deprecated-3.0"}; ""
19-}[B<-digest-commands>]
20{- output_on() if $disabled{"deprecated-3.0"}; ""
21-}[B<-kdf-algorithms>]
22[B<-mac-algorithms>]
23[B<-random-instances>]
24[B<-random-generators>]
25[B<-cipher-algorithms>]
26{- output_off() if $disabled{"deprecated-3.0"}; ""
27-}[B<-cipher-commands>]
28{- output_on() if $disabled{"deprecated-3.0"}; ""
29-}[B<-encoders>]
30[B<-decoders>]
31[B<-key-managers>]
32[B<-key-exchange-algorithms>]
33[B<-kem-algorithms>]
34[B<-signature-algorithms>]
35[B<-asymcipher-algorithms>]
36[B<-public-key-algorithms>]
37[B<-public-key-methods>]
38[B<-store-loaders>]
39[B<-providers>]
40{- output_off() if $disabled{"deprecated-3.0"}; ""
41-}[B<-engines>]
42{- output_on() if $disabled{"deprecated-3.0"}; ""
43-}[B<-disabled>]
44[B<-objects>]
45[B<-options> I<command>]
46{- $OpenSSL::safe::opt_provider_synopsis -}
47
48=head1 DESCRIPTION
49
50This command is used to generate list of algorithms or disabled
51features.
52
53=head1 OPTIONS
54
55=over 4
56
57=item B<-help>
58
59Display a usage message.
60
61=item B<-verbose>
62
63Displays extra information.
64The options below where verbosity applies say a bit more about what that means.
65
66=item B<-select> I<name>
67
68Only list algorithms that match this name.
69
70=item B<-1>
71
72List the commands, digest-commands, or cipher-commands in a single column.
73If used, this option must be given first.
74
75=item B<-commands>
76
77Display a list of standard commands.
78
79=item B<-standard-commands>
80
81List of standard commands.
82
83=item B<-digest-commands>
84
85This option is deprecated. Use B<digest-algorithms> instead.
86
87Display a list of message digest commands, which are typically used
88as input to the L<openssl-dgst(1)> or L<openssl-speed(1)> commands.
89
90=item B<-cipher-commands>
91
92This option is deprecated. Use B<cipher-algorithms> instead.
93
94Display a list of cipher commands, which are typically used as input
95to the L<openssl-enc(1)> or L<openssl-speed(1)> commands.
96
97=item B<-cipher-algorithms>, B<-digest-algorithms>, B<-kdf-algorithms>,
98B<-mac-algorithms>,
99
100Display a list of symmetric cipher, digest, kdf and mac algorithms.
101See L</Display of algorithm names> for a description of how names are
102displayed.
103
104In verbose mode, the algorithms provided by a provider will get additional
105information on what parameters each implementation supports.
106
107=item B<-random-instances>
108
109List the primary, public and private random number generator details.
110
111=item B<-random-generators>
112
113Display a list of random number generators.
114See L</Display of algorithm names> for a description of how names are
115displayed.
116
117=item B<-encoders>
118
119Display a list of encoders.
120See L</Display of algorithm names> for a description of how names are
121displayed.
122
123In verbose mode, the algorithms provided by a provider will get additional
124information on what parameters each implementation supports.
125
126=item B<-decoders>
127
128Display a list of decoders.
129See L</Display of algorithm names> for a description of how names are
130displayed.
131
132In verbose mode, the algorithms provided by a provider will get additional
133information on what parameters each implementation supports.
134
135=item B<-public-key-algorithms>
136
137Display a list of public key algorithms, with each algorithm as
138a block of multiple lines, all but the first are indented.
139The options B<key-exchange-algorithms>, B<kem-algorithms>,
140B<signature-algorithms>, and B<asymcipher-algorithms> will display similar info.
141
142=item B<-public-key-methods>
143
144Display a list of public key methods.
145
146=item B<-key-managers>
147
148Display a list of key managers.
149
150=item B<-key-exchange-algorithms>
151
152Display a list of key exchange algorithms.
153
154=item B<-kem-algorithms>
155
156Display a list of key encapsulation algorithms.
157
158=item B<-signature-algorithms>
159
160Display a list of signature algorithms.
161
162=item B<-asymcipher-algorithms>
163
164Display a list of asymmetric cipher algorithms.
165
166=item B<-store-loaders>
167
168Display a list of store loaders.
169
170=item B<-providers>
171
172Display a list of all loaded providers with their names, version and status.
173
174In verbose mode, the full version and all provider parameters will additionally
175be displayed.
176
177
178=item B<-engines>
179
180This option is deprecated.
181
182Display a list of loaded engines.
183
184=item B<-disabled>
185
186Display a list of disabled features, those that were compiled out
187of the installation.
188
189=item B<-objects>
190
191Display a list of built in objects, i.e. OIDs with names.  They're listed in the
192format described in L<config(5)/ASN1 Object Configuration Module>.
193
194=item B<-options> I<command>
195
196Output a two-column list of the options accepted by the specified I<command>.
197The first is the option name, and the second is a one-character indication
198of what type of parameter it takes, if any.
199This is an internal option, used for checking that the documentation
200is complete.
201
202{- $OpenSSL::safe::opt_provider_item -}
203
204=back
205
206=head2 Display of algorithm names
207
208Algorithm names may be displayed in one of two manners:
209
210=over 4
211
212=item Legacy implementations
213
214Legacy implementations will simply display the main name of the
215algorithm on a line of its own, or in the form C<<foo > bar>> to show
216that C<foo> is an alias for the main name, C<bar>
217
218=item Provided implementations
219
220Implementations from a provider are displayed like this if the
221implementation is labeled with a single name:
222
223 foo @ bar
224
225or like this if it's labeled with multiple names:
226
227 { foo1, foo2 } @bar
228
229In both cases, C<bar> is the name of the provider.
230
231=back
232
233=head1 HISTORY
234
235The B<-engines>, B<-digest-commands>, and B<-cipher-commands> options
236were deprecated in OpenSSL 3.0.
237
238=head1 COPYRIGHT
239
240Copyright 2016-2022 The OpenSSL Project Authors. All Rights Reserved.
241
242Licensed under the Apache License 2.0 (the "License").  You may not use
243this file except in compliance with the License.  You can obtain a copy
244in the file LICENSE in the source distribution or at
245L<https://www.openssl.org/source/license.html>.
246
247=cut
248