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>]
|
2017-08-14 21:32:07 +08:00
|
|
|
[B<-1>]
|
2016-07-29 05:00:05 +08:00
|
|
|
[B<-commands>]
|
|
|
|
[B<-digest-commands>]
|
|
|
|
[B<-digest-algorithms>]
|
2019-09-02 11:58:42 +08:00
|
|
|
[B<-kdf-algorithms>]
|
2018-11-01 12:25:20 +08:00
|
|
|
[B<-mac-algorithms>]
|
2020-05-25 12:45:49 +08:00
|
|
|
[B<-random-generators>]
|
2016-07-29 05:00:05 +08:00
|
|
|
[B<-cipher-commands>]
|
|
|
|
[B<-cipher-algorithms>]
|
2020-06-11 07:08:01 +08:00
|
|
|
[B<-serializers>]
|
2020-07-27 12:47:59 +08:00
|
|
|
[B<-deserializers>]
|
2016-07-29 05:00:05 +08:00
|
|
|
[B<-public-key-algorithms>]
|
2020-07-21 15:40:19 +08:00
|
|
|
{- output_off() if $disabled{"deprecated-3.0"}; ""
|
|
|
|
-}[B<-public-key-methods>]
|
2020-06-25 09:27:51 +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.
|
|
|
|
|
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.
|
|
|
|
|
2016-07-29 05:00:05 +08:00
|
|
|
=item B<-commands>
|
|
|
|
|
|
|
|
Display a list of standard commands.
|
|
|
|
|
|
|
|
=item B<-digest-commands>
|
|
|
|
|
|
|
|
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>
|
|
|
|
|
|
|
|
Display a list of cipher commands, which are typically used as input
|
2019-10-02 03:57:00 +08:00
|
|
|
to the L<openssl-dgst(1)> or L<openssl-speed(1)> commands.
|
2016-07-29 05:00:05 +08:00
|
|
|
|
2019-09-23 17:30:05 +08:00
|
|
|
=item B<-digest-algorithms>, B<-kdf-algorithms>, B<-mac-algorithms>,
|
|
|
|
B<-cipher-algorithms>
|
2016-07-29 05:00:05 +08:00
|
|
|
|
2019-09-23 17:30:05 +08:00
|
|
|
Display a list of cipher, digest, kdf and mac algorithms.
|
|
|
|
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.
|
|
|
|
|
|
|
|
=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.
|
|
|
|
|
|
|
|
=item B<-serializers>
|
2020-05-25 12:45:49 +08:00
|
|
|
|
2020-06-11 07:08:01 +08:00
|
|
|
Display a list of serializers.
|
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-07-27 12:47:59 +08:00
|
|
|
=item B<-deserializers>
|
|
|
|
|
|
|
|
Display a list of deserializers.
|
|
|
|
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-07-21 15:40:19 +08:00
|
|
|
{- output_off() if $disabled{"deprecated-3.0"}; "" -}
|
2016-07-29 05:00:05 +08:00
|
|
|
|
2017-07-26 01:36:04 +08:00
|
|
|
=item B<-public-key-methods>
|
|
|
|
|
2020-07-21 15:40:19 +08:00
|
|
|
This option is deprecated.
|
|
|
|
|
2019-09-02 11:58:42 +08:00
|
|
|
Display a list of public key method OIDs.
|
2020-06-25 09:27:51 +08:00
|
|
|
|
|
|
|
=item B<-engines>
|
|
|
|
|
|
|
|
This option is deprecated.
|
|
|
|
|
|
|
|
Display a list of loaded engines.
|
|
|
|
|
|
|
|
{- output_on() if $disabled{"deprecated-3.0"}; "" -}
|
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-07-21 15:40:19 +08:00
|
|
|
The B<-engines> and B<-public-key-methods> 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
|
|
|
|
|
2020-04-23 20:55:52 +08:00
|
|
|
Copyright 2016-2020 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
|