Better synopsis for 'openssl dgst' and 'openssl enc', correct names
for 'openssl rehash' ('c_rehash' is mentioned there too), correct
option end marker for 'openssl verify', and finally, refer to
sub-commands as sub-commands.
Reviewed-by: Tomas Mraz <tmraz@fedoraproject.org>
(Merged from https://github.com/openssl/openssl/pull/10065)
=item B<-extra-req> | B<-extra-ca> | B<-extra-pkcs12> | B<-extra-x509> | B<-extra-verify> I<extra-params>
=item B<-extra-req> | B<-extra-ca> | B<-extra-pkcs12> | B<-extra-x509> | B<-extra-verify> I<extra-params>
-The purpose of these parameters is to allow optional parameters to be supplied
-to L<openssl(1)> that this command executes. The B<-extra-cmd> are specific to
-the option being used and the L<openssl(1)> command getting invoked. For example
-when this command invokes L<openssl-req(1)> extra parameters can be passed on
-with the B<-extra-req> parameter. The
-L<openssl(1)> commands being invoked per option are documented below.
+For each option B<extra-I<cmd>>, pass I<extra-params> to the L<openssl(1)>
+sub-command with the same name as I<cmd>, if that sub-command is invoked.
+For example, if L<openssl-req(1)> is invoked, the I<extra-params> given with
+B<-extra-req> will be passed to it.
Users should consult L<openssl(1)> command documentation for more information.
=back
Users should consult L<openssl(1)> command documentation for more information.
=back
-enter a filename (for example F<cacert.pem>) when prompted for the CA filename.
+enter a filename (for example, F<cacert.pem>) when prompted for the CA file
+name.
Create a DSA certificate request and private key (a different set of parameters
can optionally be created first):
Create a DSA certificate request and private key (a different set of parameters
can optionally be created first):
-Attempt to decode and print the data as B<ASN1_ITEM> I<name>. This can be used
-to print out the fields of any supported ASN.1 structure if the type is known.
+Attempt to decode and print the data as an B<ASN1_ITEM> I<name>. This can be
+used to print out the fields of any supported ASN.1 structure if the type is
+known.
C<1.2.3.4 shortName A long name>
C<1.2.3.4 shortName A long name>
+For any OID with an associated short and long name, this command will display
+the long name.
+
=head1 EXAMPLES
Parse a file:
=head1 EXAMPLES
Parse a file:
+B<openssl> B<dgst>|I<digest>
[B<-I<digest>>]
[B<-help>]
[B<-c>]
[B<-I<digest>>]
[B<-help>]
[B<-c>]
[B<-engine_impl>]
[I<file> ...]
[B<-engine_impl>]
[I<file> ...]
-B<openssl> I<digest> [B<...>]
-
=head1 DESCRIPTION
This command output the message digest of a supplied file or files
=head1 DESCRIPTION
This command output the message digest of a supplied file or files
+B<openssl> B<enc>|I<cipher>
[B<-I<cipher>>]
[B<-help>]
[B<-ciphers>]
[B<-I<cipher>>]
[B<-help>]
[B<-ciphers>]
[B<-v>]
[B<-vv>]
[B<-vvv>]
[B<-v>]
[B<-vv>]
[B<-vvv>]
-openssl-c_rehash - Create symbolic links to files named by the hash values
+openssl-rehash, c_rehash - Create symbolic links to files named by the hash
+values
[I<directory>] ...
B<c_rehash>
[I<directory>] ...
B<c_rehash>
+[B<-h>]
+[B<-help>]
+[B<-old>]
+[B<-n>]
+[B<-v>]
+[I<directory>] ...
Using configuration from /some/path/openssl.cnf
Unable to load config info
Using configuration from /some/path/openssl.cnf
Unable to load config info
-This is followed some time later by...
+This is followed some time later by:
unable to find 'distinguished_name' in config
problems making Certificate Request
unable to find 'distinguished_name' in config
problems making Certificate Request
Indicates the last option. All arguments following this are assumed to be
certificate files. This is useful if the first certificate filename begins
Indicates the last option. All arguments following this are assumed to be
certificate files. This is useful if the first certificate filename begins
[ I<command_opts> ... ]
[ I<command_args> ... ]
[ I<command_opts> ... ]
[ I<command_args> ... ]
-B<openssl> B<list> [ B<-standard-commands> | B<-digest-commands> | B<-cipher-commands> | B<-cipher-algorithms> | B<-digest-algorithms> | B<-mac-algorithms> | B<-public-key-algorithms>]
+B<openssl>
+B<list>
+B<-standard-commands> |
+B<-digest-commands> |
+B<-cipher-commands> |
+B<-cipher-algorithms> |
+B<-digest-algorithms> |
+B<-mac-algorithms> |
+B<-public-key-algorithms>
B<openssl> B<no->I<XXX> [ I<arbitrary options> ]
B<openssl> B<no->I<XXX> [ I<arbitrary options> ]
-The B<openssl> program provides a rich variety of commands (I<command> in the
-SYNOPSIS above), each of which often has a wealth of options and arguments
+The B<openssl> program provides a rich variety of sub-commands (I<command> in
+the SYNOPSIS above), each of which often has a wealth of options and arguments
(I<command_opts> and I<command_args> in the SYNOPSIS).
Detailed documentation and use cases for most standard subcommands are available
(I<command_opts> and I<command_args> in the SYNOPSIS).
Detailed documentation and use cases for most standard subcommands are available
not able to detect pseudo-commands such as B<quit>,
B<list>, or B<no->I<XXX> itself.)
not able to detect pseudo-commands such as B<quit>,
B<list>, or B<no->I<XXX> itself.)
-=head2 Standard Commands
+=head2 Standard Sub-commands