2016-07-29 05:00:05 +08:00
|
|
|
=pod
|
2020-02-27 05:45:31 +08:00
|
|
|
{- OpenSSL::safe::output_do_not_edit_headers(); -}
|
2016-07-29 05:00:05 +08:00
|
|
|
|
|
|
|
=head1 NAME
|
|
|
|
|
2019-08-22 07:04:41 +08:00
|
|
|
openssl-list - list algorithms and features
|
2016-07-29 05:00:05 +08:00
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
|
|
B<openssl list>
|
|
|
|
[B<-help>]
|
2019-08-12 21:01:00 +08:00
|
|
|
[B<-verbose>]
|
2020-09-22 09:02:53 +08:00
|
|
|
[B<-select> I<name>]
|
2017-08-14 21:32:07 +08:00
|
|
|
[B<-1>]
|
2022-09-08 10:54:23 +08:00
|
|
|
[B<-all-algorithms>]
|
2016-07-29 05:00:05 +08:00
|
|
|
[B<-commands>]
|
2021-05-17 17:38:01 +08:00
|
|
|
[B<-standard-commands>]
|
2020-12-22 16:40:46 +08:00
|
|
|
[B<-digest-algorithms>]
|
2020-12-11 13:13:41 +08:00
|
|
|
{- output_off() if $disabled{"deprecated-3.0"}; ""
|
2020-12-22 16:40:46 +08:00
|
|
|
-}[B<-digest-commands>]
|
2020-12-11 13:13:41 +08:00
|
|
|
{- output_on() if $disabled{"deprecated-3.0"}; ""
|
|
|
|
-}[B<-kdf-algorithms>]
|
2018-11-01 12:25:20 +08:00
|
|
|
[B<-mac-algorithms>]
|
2021-05-17 17:38:01 +08:00
|
|
|
[B<-random-instances>]
|
2020-05-25 12:45:49 +08:00
|
|
|
[B<-random-generators>]
|
2020-12-22 16:40:46 +08:00
|
|
|
[B<-cipher-algorithms>]
|
2020-12-11 13:13:41 +08:00
|
|
|
{- output_off() if $disabled{"deprecated-3.0"}; ""
|
2020-12-22 16:40:46 +08:00
|
|
|
-}[B<-cipher-commands>]
|
2020-12-11 13:13:41 +08:00
|
|
|
{- output_on() if $disabled{"deprecated-3.0"}; ""
|
|
|
|
-}[B<-encoders>]
|
2020-08-17 03:25:08 +08:00
|
|
|
[B<-decoders>]
|
2020-09-22 09:02:53 +08:00
|
|
|
[B<-key-managers>]
|
|
|
|
[B<-key-exchange-algorithms>]
|
|
|
|
[B<-kem-algorithms>]
|
|
|
|
[B<-signature-algorithms>]
|
2024-07-09 17:07:01 +08:00
|
|
|
[B<-tls-signature-algorithms>]
|
2020-09-22 09:02:53 +08:00
|
|
|
[B<-asymcipher-algorithms>]
|
2016-07-29 05:00:05 +08:00
|
|
|
[B<-public-key-algorithms>]
|
2020-09-22 09:02:53 +08:00
|
|
|
[B<-public-key-methods>]
|
2021-05-18 16:45:31 +08:00
|
|
|
[B<-store-loaders>]
|
2020-10-07 10:19:04 +08:00
|
|
|
[B<-providers>]
|
2020-07-21 15:40:19 +08:00
|
|
|
{- output_off() if $disabled{"deprecated-3.0"}; ""
|
2020-09-22 09:02:53 +08:00
|
|
|
-}[B<-engines>]
|
2020-07-21 15:40:19 +08:00
|
|
|
{- output_on() if $disabled{"deprecated-3.0"}; ""
|
|
|
|
-}[B<-disabled>]
|
Document most missing options
Add cmd-nits make target.
Listing options should stop when it hits the "parameters" separator.
Add missing .pod.in files to doc/man1/build.info
Tweak find-doc-nits to try openssl-XXX before XXX for POD files and
change an error messavge to be more useful.
Fix the following pages: ca, cms, crl, dgst, enc,
engine, errstr, gendsa, genrsa, list, ocsp, passwd, pkcs7, pkcs12, rand,
rehash, req, rsautil, s_server, speed, s_time,
sess_id, smime, srp, ts, x509.
Reviewed-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Dmitry Belyavskiy <beldmit@gmail.com>
Reviewed-by: Matthias St. Pierre <Matthias.St.Pierre@ncp-e.com>
(Merged from https://github.com/openssl/openssl/pull/10873)
2020-01-17 02:40:52 +08:00
|
|
|
[B<-objects>]
|
|
|
|
[B<-options> I<command>]
|
2020-02-25 12:29:30 +08:00
|
|
|
{- $OpenSSL::safe::opt_provider_synopsis -}
|
2016-07-29 05:00:05 +08:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
|
|
|
This command is used to generate list of algorithms or disabled
|
|
|
|
features.
|
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
|
|
|
=item B<-help>
|
|
|
|
|
2017-03-29 12:18:34 +08:00
|
|
|
Display a usage message.
|
2016-07-29 05:00:05 +08:00
|
|
|
|
2019-08-12 21:01:00 +08:00
|
|
|
=item B<-verbose>
|
|
|
|
|
|
|
|
Displays extra information.
|
|
|
|
The options below where verbosity applies say a bit more about what that means.
|
|
|
|
|
2020-09-22 09:02:53 +08:00
|
|
|
=item B<-select> I<name>
|
|
|
|
|
|
|
|
Only list algorithms that match this name.
|
|
|
|
|
2017-08-14 21:32:07 +08:00
|
|
|
=item B<-1>
|
|
|
|
|
|
|
|
List the commands, digest-commands, or cipher-commands in a single column.
|
|
|
|
If used, this option must be given first.
|
|
|
|
|
2022-09-08 10:54:23 +08:00
|
|
|
=item B<-all-algorithms>
|
|
|
|
|
|
|
|
Display lists of all algorithms. These include:
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
|
|
|
=item Asymmetric ciphers
|
|
|
|
|
|
|
|
=item Decoders
|
|
|
|
|
|
|
|
=item Digests
|
|
|
|
|
|
|
|
=item Encoders
|
|
|
|
|
|
|
|
=item Key derivation algorithms (KDF)
|
|
|
|
|
|
|
|
=item Key encapsulation methods (KEM)
|
|
|
|
|
|
|
|
=item Key exchange algorithms (KEX)
|
|
|
|
|
|
|
|
=item Key managers
|
|
|
|
|
|
|
|
=item Message authentication code algorithms (MAC)
|
|
|
|
|
|
|
|
=item Random number generators (RNG, DRBG)
|
|
|
|
|
|
|
|
=item Signature algorithms
|
|
|
|
|
|
|
|
=item Store loaders
|
|
|
|
|
|
|
|
=item Symmetric ciphers
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
2016-07-29 05:00:05 +08:00
|
|
|
=item B<-commands>
|
|
|
|
|
|
|
|
Display a list of standard commands.
|
|
|
|
|
2021-05-17 17:38:01 +08:00
|
|
|
=item B<-standard-commands>
|
|
|
|
|
|
|
|
List of standard commands.
|
|
|
|
|
2016-07-29 05:00:05 +08:00
|
|
|
=item B<-digest-commands>
|
|
|
|
|
2020-12-11 13:13:41 +08:00
|
|
|
This option is deprecated. Use B<digest-algorithms> instead.
|
|
|
|
|
2016-07-29 05:00:05 +08:00
|
|
|
Display a list of message digest commands, which are typically used
|
2019-10-02 03:57:00 +08:00
|
|
|
as input to the L<openssl-dgst(1)> or L<openssl-speed(1)> commands.
|
2016-07-29 05:00:05 +08:00
|
|
|
|
|
|
|
=item B<-cipher-commands>
|
|
|
|
|
2020-12-11 13:13:41 +08:00
|
|
|
This option is deprecated. Use B<cipher-algorithms> instead.
|
|
|
|
|
2016-07-29 05:00:05 +08:00
|
|
|
Display a list of cipher commands, which are typically used as input
|
2020-12-11 13:13:41 +08:00
|
|
|
to the L<openssl-enc(1)> or L<openssl-speed(1)> commands.
|
2016-07-29 05:00:05 +08:00
|
|
|
|
2022-10-10 16:53:14 +08:00
|
|
|
=item B<-cipher-algorithms>, B<-digest-algorithms>, B<-kdf-algorithms>,
|
|
|
|
B<-mac-algorithms>,
|
2016-07-29 05:00:05 +08:00
|
|
|
|
2022-10-10 16:53:14 +08:00
|
|
|
Display a list of symmetric cipher, digest, kdf and mac algorithms.
|
2019-09-23 17:30:05 +08:00
|
|
|
See L</Display of algorithm names> for a description of how names are
|
2020-05-25 12:45:49 +08:00
|
|
|
displayed.
|
|
|
|
|
|
|
|
In verbose mode, the algorithms provided by a provider will get additional
|
|
|
|
information on what parameters each implementation supports.
|
|
|
|
|
2021-05-17 17:38:01 +08:00
|
|
|
=item B<-random-instances>
|
|
|
|
|
|
|
|
List the primary, public and private random number generator details.
|
|
|
|
|
2020-05-25 12:45:49 +08:00
|
|
|
=item B<-random-generators>
|
|
|
|
|
|
|
|
Display a list of random number generators.
|
2020-06-11 07:08:01 +08:00
|
|
|
See L</Display of algorithm names> for a description of how names are
|
|
|
|
displayed.
|
|
|
|
|
2020-08-17 03:25:08 +08:00
|
|
|
=item B<-encoders>
|
2020-05-25 12:45:49 +08:00
|
|
|
|
2020-08-17 03:25:08 +08:00
|
|
|
Display a list of encoders.
|
2020-05-25 12:45:49 +08:00
|
|
|
See L</Display of algorithm names> for a description of how names are
|
2019-09-23 17:30:05 +08:00
|
|
|
displayed.
|
2016-07-29 05:00:05 +08:00
|
|
|
|
2019-08-12 21:01:00 +08:00
|
|
|
In verbose mode, the algorithms provided by a provider will get additional
|
|
|
|
information on what parameters each implementation supports.
|
|
|
|
|
2020-08-17 03:25:08 +08:00
|
|
|
=item B<-decoders>
|
2020-07-27 12:47:59 +08:00
|
|
|
|
2020-08-17 03:25:08 +08:00
|
|
|
Display a list of decoders.
|
2020-07-27 12:47:59 +08:00
|
|
|
See L</Display of algorithm names> for a description of how names are
|
|
|
|
displayed.
|
|
|
|
|
|
|
|
In verbose mode, the algorithms provided by a provider will get additional
|
|
|
|
information on what parameters each implementation supports.
|
|
|
|
|
2016-07-29 05:00:05 +08:00
|
|
|
=item B<-public-key-algorithms>
|
|
|
|
|
|
|
|
Display a list of public key algorithms, with each algorithm as
|
|
|
|
a block of multiple lines, all but the first are indented.
|
2020-09-22 09:02:53 +08:00
|
|
|
The options B<key-exchange-algorithms>, B<kem-algorithms>,
|
|
|
|
B<signature-algorithms>, and B<asymcipher-algorithms> will display similar info.
|
2016-07-29 05:00:05 +08:00
|
|
|
|
2017-07-26 01:36:04 +08:00
|
|
|
=item B<-public-key-methods>
|
|
|
|
|
2020-09-22 09:02:53 +08:00
|
|
|
Display a list of public key methods.
|
|
|
|
|
|
|
|
=item B<-key-managers>
|
|
|
|
|
|
|
|
Display a list of key managers.
|
|
|
|
|
|
|
|
=item B<-key-exchange-algorithms>
|
|
|
|
|
|
|
|
Display a list of key exchange algorithms.
|
|
|
|
|
|
|
|
=item B<-kem-algorithms>
|
|
|
|
|
|
|
|
Display a list of key encapsulation algorithms.
|
|
|
|
|
|
|
|
=item B<-signature-algorithms>
|
|
|
|
|
|
|
|
Display a list of signature algorithms.
|
|
|
|
|
2024-07-09 17:07:01 +08:00
|
|
|
=item B<-tls-signature-algorithms>
|
|
|
|
|
|
|
|
Display the list of signature algorithms available for TLS handshakes
|
|
|
|
made available by all currently active providers.
|
|
|
|
The output format is colon delimited in a form directly usable in
|
|
|
|
L<SSL_CONF_cmd(3)> specifying SignatureAlgorithms.
|
|
|
|
|
2020-09-22 09:02:53 +08:00
|
|
|
=item B<-asymcipher-algorithms>
|
2020-07-21 15:40:19 +08:00
|
|
|
|
2020-09-22 09:02:53 +08:00
|
|
|
Display a list of asymmetric cipher algorithms.
|
2020-06-25 09:27:51 +08:00
|
|
|
|
2021-05-18 16:45:31 +08:00
|
|
|
=item B<-store-loaders>
|
|
|
|
|
|
|
|
Display a list of store loaders.
|
|
|
|
|
2020-10-07 10:19:04 +08:00
|
|
|
=item B<-providers>
|
|
|
|
|
|
|
|
Display a list of all loaded providers with their names, version and status.
|
|
|
|
|
|
|
|
In verbose mode, the full version and all provider parameters will additionally
|
|
|
|
be displayed.
|
|
|
|
|
|
|
|
|
2020-06-25 09:27:51 +08:00
|
|
|
=item B<-engines>
|
|
|
|
|
|
|
|
This option is deprecated.
|
|
|
|
|
|
|
|
Display a list of loaded engines.
|
|
|
|
|
2016-07-29 05:00:05 +08:00
|
|
|
=item B<-disabled>
|
|
|
|
|
|
|
|
Display a list of disabled features, those that were compiled out
|
|
|
|
of the installation.
|
|
|
|
|
2018-07-12 20:22:43 +08:00
|
|
|
=item B<-objects>
|
|
|
|
|
|
|
|
Display a list of built in objects, i.e. OIDs with names. They're listed in the
|
|
|
|
format described in L<config(5)/ASN1 Object Configuration Module>.
|
|
|
|
|
Document most missing options
Add cmd-nits make target.
Listing options should stop when it hits the "parameters" separator.
Add missing .pod.in files to doc/man1/build.info
Tweak find-doc-nits to try openssl-XXX before XXX for POD files and
change an error messavge to be more useful.
Fix the following pages: ca, cms, crl, dgst, enc,
engine, errstr, gendsa, genrsa, list, ocsp, passwd, pkcs7, pkcs12, rand,
rehash, req, rsautil, s_server, speed, s_time,
sess_id, smime, srp, ts, x509.
Reviewed-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Dmitry Belyavskiy <beldmit@gmail.com>
Reviewed-by: Matthias St. Pierre <Matthias.St.Pierre@ncp-e.com>
(Merged from https://github.com/openssl/openssl/pull/10873)
2020-01-17 02:40:52 +08:00
|
|
|
=item B<-options> I<command>
|
|
|
|
|
|
|
|
Output a two-column list of the options accepted by the specified I<command>.
|
|
|
|
The first is the option name, and the second is a one-character indication
|
|
|
|
of what type of parameter it takes, if any.
|
|
|
|
This is an internal option, used for checking that the documentation
|
|
|
|
is complete.
|
|
|
|
|
2020-02-25 12:29:30 +08:00
|
|
|
{- $OpenSSL::safe::opt_provider_item -}
|
|
|
|
|
2016-07-29 05:00:05 +08:00
|
|
|
=back
|
|
|
|
|
2019-09-23 17:30:05 +08:00
|
|
|
=head2 Display of algorithm names
|
|
|
|
|
|
|
|
Algorithm names may be displayed in one of two manners:
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
|
|
|
=item Legacy implementations
|
|
|
|
|
|
|
|
Legacy implementations will simply display the main name of the
|
|
|
|
algorithm on a line of its own, or in the form C<<foo > bar>> to show
|
|
|
|
that C<foo> is an alias for the main name, C<bar>
|
|
|
|
|
|
|
|
=item Provided implementations
|
|
|
|
|
|
|
|
Implementations from a provider are displayed like this if the
|
|
|
|
implementation is labeled with a single name:
|
|
|
|
|
|
|
|
foo @ bar
|
|
|
|
|
|
|
|
or like this if it's labeled with multiple names:
|
|
|
|
|
|
|
|
{ foo1, foo2 } @bar
|
|
|
|
|
|
|
|
In both cases, C<bar> is the name of the provider.
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
2020-06-25 08:40:20 +08:00
|
|
|
=head1 HISTORY
|
|
|
|
|
2020-12-11 13:13:41 +08:00
|
|
|
The B<-engines>, B<-digest-commands>, and B<-cipher-commands> options
|
|
|
|
were deprecated in OpenSSL 3.0.
|
2020-06-25 08:40:20 +08:00
|
|
|
|
2016-07-29 05:00:05 +08:00
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
2024-09-05 15:35:49 +08:00
|
|
|
Copyright 2016-2024 The OpenSSL Project Authors. All Rights Reserved.
|
2016-07-29 05:00:05 +08:00
|
|
|
|
2018-12-06 21:04:11 +08:00
|
|
|
Licensed under the Apache License 2.0 (the "License"). You may not use
|
2016-07-29 05:00:05 +08:00
|
|
|
this file except in compliance with the License. You can obtain a copy
|
|
|
|
in the file LICENSE in the source distribution or at
|
|
|
|
L<https://www.openssl.org/source/license.html>.
|
|
|
|
|
|
|
|
=cut
|