| =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>] |
| |
| =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 filename 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 filename parameters to. Standard output is used |
| if this option is not present. The output filename should B<not> be the same |
| as the input filename. |
| |
| =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 option specifies that a parameter set should be generated of size |
| I<numbits>. It must be the last option. If this option 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-2022 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 |
