1999-11-10 10:52:17 +08:00
|
|
|
=pod
|
2019-10-31 11:35:08 +08:00
|
|
|
{- OpenSSL::safe::output_do_not_edit_headers(); -}
|
2019-10-13 05:45:56 +08:00
|
|
|
|
1999-11-10 10:52:17 +08:00
|
|
|
=head1 NAME
|
|
|
|
|
2019-08-22 07:04:41 +08:00
|
|
|
openssl-dsaparam - DSA parameter manipulation and generation
|
1999-11-10 10:52:17 +08:00
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
|
|
B<openssl dsaparam>
|
2016-02-06 00:58:45 +08:00
|
|
|
[B<-help>]
|
2019-09-26 03:20:11 +08:00
|
|
|
[B<-inform> B<DER>|B<PEM>]
|
|
|
|
[B<-outform> B<DER>|B<PEM>]
|
|
|
|
[B<-in> I<filename>]
|
|
|
|
[B<-out> I<filename>]
|
1999-11-10 10:52:17 +08:00
|
|
|
[B<-noout>]
|
|
|
|
[B<-text>]
|
|
|
|
[B<-genkey>]
|
2018-08-10 05:19:19 +08:00
|
|
|
[B<-verbose>]
|
2021-12-22 11:44:07 +08:00
|
|
|
[B<-quiet>]
|
2019-10-13 05:45:56 +08:00
|
|
|
{- $OpenSSL::safe::opt_r_synopsis -}
|
2020-09-21 17:56:01 +08:00
|
|
|
{- $OpenSSL::safe::opt_engine_synopsis -}{- $OpenSSL::safe::opt_provider_synopsis -}
|
2019-09-26 03:20:11 +08:00
|
|
|
[I<numbits>]
|
2022-12-13 22:27:05 +08:00
|
|
|
[I<numqbits>]
|
1999-11-10 10:52:17 +08:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
|
|
|
This command is used to manipulate or generate DSA parameter files.
|
|
|
|
|
2019-10-10 09:48:33 +08:00
|
|
|
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.
|
|
|
|
|
1999-11-10 10:52:17 +08:00
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2016-02-06 00:58:45 +08:00
|
|
|
=item B<-help>
|
|
|
|
|
|
|
|
Print out a usage message.
|
|
|
|
|
2021-05-03 20:15:26 +08:00
|
|
|
=item B<-inform> B<DER>|B<PEM>
|
1999-11-10 10:52:17 +08:00
|
|
|
|
2021-05-03 20:15:26 +08:00
|
|
|
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>.
|
2020-12-10 04:56:51 +08:00
|
|
|
See L<openssl-format-options(1)> for details.
|
1999-11-10 10:52:17 +08:00
|
|
|
|
2019-10-10 09:48:33 +08:00
|
|
|
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.
|
1999-11-10 10:52:17 +08:00
|
|
|
|
2019-09-26 03:20:11 +08:00
|
|
|
=item B<-in> I<filename>
|
1999-11-10 10:52:17 +08:00
|
|
|
|
2024-09-27 13:39:17 +08:00
|
|
|
This specifies the input file to read parameters from or standard input if
|
2019-10-02 00:16:29 +08:00
|
|
|
this option is not specified. If the I<numbits> parameter is included then
|
1999-11-10 10:52:17 +08:00
|
|
|
this option will be ignored.
|
|
|
|
|
2019-09-26 03:20:11 +08:00
|
|
|
=item B<-out> I<filename>
|
1999-11-10 10:52:17 +08:00
|
|
|
|
2024-09-27 13:39:17 +08:00
|
|
|
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.
|
1999-11-10 10:52:17 +08:00
|
|
|
|
|
|
|
=item B<-noout>
|
|
|
|
|
2017-03-30 05:38:30 +08:00
|
|
|
This option inhibits the output of the encoded version of the parameters.
|
1999-11-10 10:52:17 +08:00
|
|
|
|
|
|
|
=item B<-text>
|
|
|
|
|
2017-03-30 05:38:30 +08:00
|
|
|
This option prints out the DSA parameters in human readable form.
|
1999-11-10 10:52:17 +08:00
|
|
|
|
|
|
|
=item B<-genkey>
|
|
|
|
|
2017-03-30 05:38:30 +08:00
|
|
|
This option will generate a DSA either using the specified or generated
|
1999-11-10 10:52:17 +08:00
|
|
|
parameters.
|
|
|
|
|
2003-01-31 06:02:27 +08:00
|
|
|
|
2018-08-10 05:19:19 +08:00
|
|
|
=item B<-verbose>
|
|
|
|
|
|
|
|
Print extra details about the operations being performed.
|
|
|
|
|
2021-12-22 11:44:07 +08:00
|
|
|
=item B<-quiet>
|
|
|
|
|
|
|
|
Print fewer details about the operations being performed, which may
|
|
|
|
be handy during batch scripts and pipelines.
|
|
|
|
|
2019-10-13 05:45:56 +08:00
|
|
|
{- $OpenSSL::safe::opt_r_item -}
|
|
|
|
|
2019-10-13 05:45:56 +08:00
|
|
|
{- $OpenSSL::safe::opt_engine_item -}
|
|
|
|
|
2019-10-02 00:16:29 +08:00
|
|
|
=item I<numbits>
|
2018-08-10 05:19:19 +08:00
|
|
|
|
2022-12-13 22:27:05 +08:00
|
|
|
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.
|
2018-08-10 05:19:19 +08:00
|
|
|
|
2020-02-25 12:29:30 +08:00
|
|
|
{- $OpenSSL::safe::opt_provider_item -}
|
|
|
|
|
1999-11-10 10:52:17 +08:00
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
2019-08-22 07:04:41 +08:00
|
|
|
L<openssl(1)>,
|
2020-02-07 06:09:53 +08:00
|
|
|
L<openssl-pkeyparam(1)>,
|
2019-08-22 07:04:41 +08:00
|
|
|
L<openssl-gendsa(1)>,
|
|
|
|
L<openssl-dsa(1)>,
|
|
|
|
L<openssl-genrsa(1)>,
|
|
|
|
L<openssl-rsa(1)>
|
1999-11-10 10:52:17 +08:00
|
|
|
|
2020-06-25 09:27:51 +08:00
|
|
|
=head1 HISTORY
|
|
|
|
|
|
|
|
The B<-engine> option was deprecated in OpenSSL 3.0.
|
|
|
|
|
2020-11-12 07:03:38 +08:00
|
|
|
The B<-C> option was removed in OpenSSL 3.0.
|
|
|
|
|
2016-05-18 23:44:05 +08:00
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
2023-09-07 16:59:15 +08:00
|
|
|
Copyright 2000-2023 The OpenSSL Project Authors. All Rights Reserved.
|
2016-05-18 23:44: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-05-18 23:44: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
|