]>
Commit | Line | Data |
---|---|---|
aba3e65f | 1 | =pod |
625c781d | 2 | {- OpenSSL::safe::output_do_not_edit_headers(); -} |
9fcb9702 | 3 | |
aba3e65f DSH |
4 | =head1 NAME |
5 | ||
b6b66573 | 6 | openssl-dsaparam - DSA parameter manipulation and generation |
aba3e65f DSH |
7 | |
8 | =head1 SYNOPSIS | |
9 | ||
10 | B<openssl dsaparam> | |
169394d4 | 11 | [B<-help>] |
e8769719 RS |
12 | [B<-inform> B<DER>|B<PEM>] |
13 | [B<-outform> B<DER>|B<PEM>] | |
14 | [B<-in> I<filename>] | |
15 | [B<-out> I<filename>] | |
aba3e65f DSH |
16 | [B<-noout>] |
17 | [B<-text>] | |
aba3e65f | 18 | [B<-genkey>] |
b6a07f67 | 19 | [B<-verbose>] |
a414fd67 | 20 | [B<-quiet>] |
9fcb9702 | 21 | {- $OpenSSL::safe::opt_r_synopsis -} |
d55e4487 | 22 | {- $OpenSSL::safe::opt_engine_synopsis -}{- $OpenSSL::safe::opt_provider_synopsis -} |
e8769719 | 23 | [I<numbits>] |
535ddd37 | 24 | [I<numqbits>] |
aba3e65f DSH |
25 | |
26 | =head1 DESCRIPTION | |
27 | ||
28 | This command is used to manipulate or generate DSA parameter files. | |
29 | ||
777182a0 RS |
30 | DSA parameter generation can be a slow process and as a result the same set of |
31 | DSA parameters is often used to generate several distinct keys. | |
32 | ||
aba3e65f DSH |
33 | =head1 OPTIONS |
34 | ||
35 | =over 4 | |
36 | ||
169394d4 MR |
37 | =item B<-help> |
38 | ||
39 | Print out a usage message. | |
40 | ||
bee3f389 | 41 | =item B<-inform> B<DER>|B<PEM> |
aba3e65f | 42 | |
bee3f389 TM |
43 | The DSA parameters input format; unspecified by default. |
44 | See L<openssl-format-options(1)> for details. | |
45 | ||
46 | =item B<-outform> B<DER>|B<PEM> | |
47 | ||
48 | The DSA parameters output format; the default is B<PEM>. | |
46949153 | 49 | See L<openssl-format-options(1)> for details. |
aba3e65f | 50 | |
777182a0 RS |
51 | Parameters are a sequence of B<ASN.1 INTEGER>s: B<p>, B<q>, and B<g>. |
52 | This is compatible with RFC 2459 B<DSS-Parms> structure. | |
aba3e65f | 53 | |
e8769719 | 54 | =item B<-in> I<filename> |
aba3e65f DSH |
55 | |
56 | This specifies the input filename to read parameters from or standard input if | |
2f0ea936 | 57 | this option is not specified. If the I<numbits> parameter is included then |
aba3e65f DSH |
58 | this option will be ignored. |
59 | ||
e8769719 | 60 | =item B<-out> I<filename> |
aba3e65f DSH |
61 | |
62 | This specifies the output filename parameters to. Standard output is used | |
63 | if this option is not present. The output filename should B<not> be the same | |
64 | as the input filename. | |
65 | ||
66 | =item B<-noout> | |
67 | ||
c4de074e | 68 | This option inhibits the output of the encoded version of the parameters. |
aba3e65f DSH |
69 | |
70 | =item B<-text> | |
71 | ||
c4de074e | 72 | This option prints out the DSA parameters in human readable form. |
aba3e65f | 73 | |
aba3e65f DSH |
74 | =item B<-genkey> |
75 | ||
c4de074e | 76 | This option will generate a DSA either using the specified or generated |
aba3e65f DSH |
77 | parameters. |
78 | ||
bfa35550 | 79 | |
b6a07f67 PP |
80 | =item B<-verbose> |
81 | ||
82 | Print extra details about the operations being performed. | |
83 | ||
a414fd67 PP |
84 | =item B<-quiet> |
85 | ||
86 | Print fewer details about the operations being performed, which may | |
87 | be handy during batch scripts and pipelines. | |
88 | ||
9fcb9702 RS |
89 | {- $OpenSSL::safe::opt_r_item -} |
90 | ||
018aaeb4 RS |
91 | {- $OpenSSL::safe::opt_engine_item -} |
92 | ||
2f0ea936 | 93 | =item I<numbits> |
b6a07f67 | 94 | |
535ddd37 AS |
95 | This optional argument specifies that a parameter set should be generated of |
96 | size I<numbits>. If this argument is included then the input file (if any) is | |
97 | ignored. | |
98 | ||
99 | =item I<numqbits> | |
100 | ||
101 | This optional argument specifies that a parameter set should be generated with | |
102 | a subprime parameter q of size I<numqbits>. It must be the last argument. If | |
103 | this argument is included then the input file (if any) is ignored. | |
b6a07f67 | 104 | |
6bd4e3f2 P |
105 | {- $OpenSSL::safe::opt_provider_item -} |
106 | ||
aba3e65f DSH |
107 | =back |
108 | ||
aba3e65f DSH |
109 | =head1 SEE ALSO |
110 | ||
b6b66573 | 111 | L<openssl(1)>, |
1ddf2594 | 112 | L<openssl-pkeyparam(1)>, |
b6b66573 DMSP |
113 | L<openssl-gendsa(1)>, |
114 | L<openssl-dsa(1)>, | |
115 | L<openssl-genrsa(1)>, | |
116 | L<openssl-rsa(1)> | |
aba3e65f | 117 | |
0f221d9c P |
118 | =head1 HISTORY |
119 | ||
120 | The B<-engine> option was deprecated in OpenSSL 3.0. | |
121 | ||
1696b890 RS |
122 | The B<-C> option was removed in OpenSSL 3.0. |
123 | ||
e2f92610 RS |
124 | =head1 COPYRIGHT |
125 | ||
da1c088f | 126 | Copyright 2000-2023 The OpenSSL Project Authors. All Rights Reserved. |
e2f92610 | 127 | |
449040b4 | 128 | Licensed under the Apache License 2.0 (the "License"). You may not use |
e2f92610 RS |
129 | this file except in compliance with the License. You can obtain a copy |
130 | in the file LICENSE in the source distribution or at | |
131 | L<https://www.openssl.org/source/license.html>. | |
132 | ||
133 | =cut |