123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282 |
- =pod
- {- OpenSSL::safe::output_do_not_edit_headers(); -}
- =head1 NAME
- openssl-list - list algorithms and features
- =head1 SYNOPSIS
- B<openssl list>
- [B<-help>]
- [B<-verbose>]
- [B<-select> I<name>]
- [B<-1>]
- [B<-all-algorithms>]
- [B<-commands>]
- [B<-standard-commands>]
- [B<-digest-algorithms>]
- {- output_off() if $disabled{"deprecated-3.0"}; ""
- -}[B<-digest-commands>]
- {- output_on() if $disabled{"deprecated-3.0"}; ""
- -}[B<-kdf-algorithms>]
- [B<-mac-algorithms>]
- [B<-random-instances>]
- [B<-random-generators>]
- [B<-cipher-algorithms>]
- {- output_off() if $disabled{"deprecated-3.0"}; ""
- -}[B<-cipher-commands>]
- {- output_on() if $disabled{"deprecated-3.0"}; ""
- -}[B<-encoders>]
- [B<-decoders>]
- [B<-key-managers>]
- [B<-key-exchange-algorithms>]
- [B<-kem-algorithms>]
- [B<-signature-algorithms>]
- [B<-asymcipher-algorithms>]
- [B<-public-key-algorithms>]
- [B<-public-key-methods>]
- [B<-store-loaders>]
- [B<-providers>]
- {- output_off() if $disabled{"deprecated-3.0"}; ""
- -}[B<-engines>]
- {- output_on() if $disabled{"deprecated-3.0"}; ""
- -}[B<-disabled>]
- [B<-objects>]
- [B<-options> I<command>]
- {- $OpenSSL::safe::opt_provider_synopsis -}
- =head1 DESCRIPTION
- This command is used to generate list of algorithms or disabled
- features.
- =head1 OPTIONS
- =over 4
- =item B<-help>
- Display a usage message.
- =item B<-verbose>
- Displays extra information.
- The options below where verbosity applies say a bit more about what that means.
- =item B<-select> I<name>
- Only list algorithms that match this name.
- =item B<-1>
- List the commands, digest-commands, or cipher-commands in a single column.
- If used, this option must be given first.
- =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
- =item B<-commands>
- Display a list of standard commands.
- =item B<-standard-commands>
- List of standard commands.
- =item B<-digest-commands>
- This option is deprecated. Use B<digest-algorithms> instead.
- Display a list of message digest commands, which are typically used
- as input to the L<openssl-dgst(1)> or L<openssl-speed(1)> commands.
- =item B<-cipher-commands>
- This option is deprecated. Use B<cipher-algorithms> instead.
- Display a list of cipher commands, which are typically used as input
- to the L<openssl-enc(1)> or L<openssl-speed(1)> commands.
- =item B<-cipher-algorithms>, B<-digest-algorithms>, B<-kdf-algorithms>,
- B<-mac-algorithms>,
- Display a list of symmetric cipher, digest, kdf and mac algorithms.
- 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.
- =item B<-random-instances>
- List the primary, public and private random number generator details.
- =item B<-random-generators>
- Display a list of random number generators.
- See L</Display of algorithm names> for a description of how names are
- displayed.
- =item B<-encoders>
- Display a list of encoders.
- 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.
- =item B<-decoders>
- Display a list of decoders.
- 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.
- =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.
- The options B<key-exchange-algorithms>, B<kem-algorithms>,
- B<signature-algorithms>, and B<asymcipher-algorithms> will display similar info.
- =item B<-public-key-methods>
- 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.
- =item B<-asymcipher-algorithms>
- Display a list of asymmetric cipher algorithms.
- =item B<-store-loaders>
- Display a list of store loaders.
- =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.
- =item B<-engines>
- This option is deprecated.
- Display a list of loaded engines.
- =item B<-disabled>
- Display a list of disabled features, those that were compiled out
- of the installation.
- =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>.
- =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.
- {- $OpenSSL::safe::opt_provider_item -}
- =back
- =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
- =head1 HISTORY
- The B<-engines>, B<-digest-commands>, and B<-cipher-commands> options
- were deprecated in OpenSSL 3.0.
- =head1 COPYRIGHT
- Copyright 2016-2021 The OpenSSL Project Authors. All Rights Reserved.
- Licensed under the Apache License 2.0 (the "License"). You may not use
- 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
|