mirror of
https://github.com/openssl/openssl.git
synced 2024-12-27 06:21:43 +08:00
32189981a3
Reviewed-by: Viktor Dukhovni <viktor@openssl.org> Reviewed-by: Tomas Mraz <tomas@openssl.org> (Merged from https://github.com/openssl/openssl/pull/25552)
136 lines
3.3 KiB
Plaintext
136 lines
3.3 KiB
Plaintext
=pod
|
|
{- OpenSSL::safe::output_do_not_edit_headers(); -}
|
|
|
|
=head1 NAME
|
|
|
|
openssl-dsaparam - DSA parameter manipulation and generation
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<openssl dsaparam>
|
|
[B<-help>]
|
|
[B<-inform> B<DER>|B<PEM>]
|
|
[B<-outform> B<DER>|B<PEM>]
|
|
[B<-in> I<filename>]
|
|
[B<-out> I<filename>]
|
|
[B<-noout>]
|
|
[B<-text>]
|
|
[B<-genkey>]
|
|
[B<-verbose>]
|
|
[B<-quiet>]
|
|
{- $OpenSSL::safe::opt_r_synopsis -}
|
|
{- $OpenSSL::safe::opt_engine_synopsis -}{- $OpenSSL::safe::opt_provider_synopsis -}
|
|
[I<numbits>]
|
|
[I<numqbits>]
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
This command is used to manipulate or generate DSA parameter files.
|
|
|
|
DSA parameter generation can be a slow process and as a result the same set of
|
|
DSA parameters is often used to generate several distinct keys.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 4
|
|
|
|
=item B<-help>
|
|
|
|
Print out a usage message.
|
|
|
|
=item B<-inform> B<DER>|B<PEM>
|
|
|
|
The DSA parameters input format; unspecified by default.
|
|
See L<openssl-format-options(1)> for details.
|
|
|
|
=item B<-outform> B<DER>|B<PEM>
|
|
|
|
The DSA parameters output format; the default is B<PEM>.
|
|
See L<openssl-format-options(1)> for details.
|
|
|
|
Parameters are a sequence of B<ASN.1 INTEGER>s: B<p>, B<q>, and B<g>.
|
|
This is compatible with RFC 2459 B<DSS-Parms> structure.
|
|
|
|
=item B<-in> I<filename>
|
|
|
|
This specifies the input file to read parameters from or standard input if
|
|
this option is not specified. If the I<numbits> parameter is included then
|
|
this option will be ignored.
|
|
|
|
=item B<-out> I<filename>
|
|
|
|
This specifies the output file to write parameters to. Standard output is used
|
|
if this option is not present.
|
|
The output filename can be the same as the input filename,
|
|
which leads to replacing the file contents.
|
|
Note that file I/O is not atomic. The output file is truncated and then written.
|
|
|
|
=item B<-noout>
|
|
|
|
This option inhibits the output of the encoded version of the parameters.
|
|
|
|
=item B<-text>
|
|
|
|
This option prints out the DSA parameters in human readable form.
|
|
|
|
=item B<-genkey>
|
|
|
|
This option will generate a DSA either using the specified or generated
|
|
parameters.
|
|
|
|
|
|
=item B<-verbose>
|
|
|
|
Print extra details about the operations being performed.
|
|
|
|
=item B<-quiet>
|
|
|
|
Print fewer details about the operations being performed, which may
|
|
be handy during batch scripts and pipelines.
|
|
|
|
{- $OpenSSL::safe::opt_r_item -}
|
|
|
|
{- $OpenSSL::safe::opt_engine_item -}
|
|
|
|
=item I<numbits>
|
|
|
|
This optional argument specifies that a parameter set should be generated of
|
|
size I<numbits>. If this argument is included then the input file (if any) is
|
|
ignored.
|
|
|
|
=item I<numqbits>
|
|
|
|
This optional argument specifies that a parameter set should be generated with
|
|
a subprime parameter q of size I<numqbits>. It must be the last argument. If
|
|
this argument is included then the input file (if any) is ignored.
|
|
|
|
{- $OpenSSL::safe::opt_provider_item -}
|
|
|
|
=back
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<openssl(1)>,
|
|
L<openssl-pkeyparam(1)>,
|
|
L<openssl-gendsa(1)>,
|
|
L<openssl-dsa(1)>,
|
|
L<openssl-genrsa(1)>,
|
|
L<openssl-rsa(1)>
|
|
|
|
=head1 HISTORY
|
|
|
|
The B<-engine> option was deprecated in OpenSSL 3.0.
|
|
|
|
The B<-C> option was removed in OpenSSL 3.0.
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright 2000-2023 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
|