]>
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>] | |
18 | [B<-C>] | |
aba3e65f | 19 | [B<-genkey>] |
b6a07f67 | 20 | [B<-verbose>] |
9fcb9702 | 21 | {- $OpenSSL::safe::opt_r_synopsis -} |
018aaeb4 | 22 | {- $OpenSSL::safe::opt_engine_synopsis -} |
e8769719 | 23 | [I<numbits>] |
aba3e65f DSH |
24 | |
25 | =head1 DESCRIPTION | |
26 | ||
1ddf2594 P |
27 | This command has been deprecated. |
28 | The L<openssl-pkeyparam(1)> command should be used instead. | |
29 | ||
aba3e65f DSH |
30 | This command is used to manipulate or generate DSA parameter files. |
31 | ||
777182a0 RS |
32 | DSA parameter generation can be a slow process and as a result the same set of |
33 | DSA parameters is often used to generate several distinct keys. | |
34 | ||
aba3e65f DSH |
35 | =head1 OPTIONS |
36 | ||
37 | =over 4 | |
38 | ||
169394d4 MR |
39 | =item B<-help> |
40 | ||
41 | Print out a usage message. | |
42 | ||
777182a0 | 43 | =item B<-inform> B<DER>|B<PEM>, B<-outform> B<DER>|B<PEM> |
aba3e65f | 44 | |
777182a0 RS |
45 | The input and formats; the default is B<PEM>. |
46 | See L<openssl(1)/Format Options> for details. | |
aba3e65f | 47 | |
777182a0 RS |
48 | Parameters are a sequence of B<ASN.1 INTEGER>s: B<p>, B<q>, and B<g>. |
49 | This is compatible with RFC 2459 B<DSS-Parms> structure. | |
aba3e65f | 50 | |
e8769719 | 51 | =item B<-in> I<filename> |
aba3e65f DSH |
52 | |
53 | This specifies the input filename to read parameters from or standard input if | |
2f0ea936 | 54 | this option is not specified. If the I<numbits> parameter is included then |
aba3e65f DSH |
55 | this option will be ignored. |
56 | ||
e8769719 | 57 | =item B<-out> I<filename> |
aba3e65f DSH |
58 | |
59 | This specifies the output filename parameters to. Standard output is used | |
60 | if this option is not present. The output filename should B<not> be the same | |
61 | as the input filename. | |
62 | ||
63 | =item B<-noout> | |
64 | ||
c4de074e | 65 | This option inhibits the output of the encoded version of the parameters. |
aba3e65f DSH |
66 | |
67 | =item B<-text> | |
68 | ||
c4de074e | 69 | This option prints out the DSA parameters in human readable form. |
aba3e65f DSH |
70 | |
71 | =item B<-C> | |
72 | ||
c4de074e | 73 | This option converts the parameters into C code. The parameters can then |
35cb565a | 74 | be loaded by calling the get_dsaXXX() function. |
aba3e65f DSH |
75 | |
76 | =item B<-genkey> | |
77 | ||
c4de074e | 78 | This option will generate a DSA either using the specified or generated |
aba3e65f DSH |
79 | parameters. |
80 | ||
bfa35550 | 81 | |
b6a07f67 PP |
82 | =item B<-verbose> |
83 | ||
84 | Print extra details about the operations being performed. | |
85 | ||
9fcb9702 RS |
86 | {- $OpenSSL::safe::opt_r_item -} |
87 | ||
018aaeb4 RS |
88 | {- $OpenSSL::safe::opt_engine_item -} |
89 | ||
2f0ea936 | 90 | =item I<numbits> |
b6a07f67 PP |
91 | |
92 | This option specifies that a parameter set should be generated of size | |
2f0ea936 | 93 | I<numbits>. It must be the last option. If this option is included then |
b6a07f67 PP |
94 | the input file (if any) is ignored. |
95 | ||
aba3e65f DSH |
96 | =back |
97 | ||
aba3e65f DSH |
98 | =head1 SEE ALSO |
99 | ||
b6b66573 | 100 | L<openssl(1)>, |
1ddf2594 | 101 | L<openssl-pkeyparam(1)>, |
b6b66573 DMSP |
102 | L<openssl-gendsa(1)>, |
103 | L<openssl-dsa(1)>, | |
104 | L<openssl-genrsa(1)>, | |
105 | L<openssl-rsa(1)> | |
aba3e65f | 106 | |
1ddf2594 P |
107 | =head1 HISTORY |
108 | ||
109 | This command was deprecated in OpenSSL 3.0. | |
110 | ||
e2f92610 RS |
111 | =head1 COPYRIGHT |
112 | ||
b6b66573 | 113 | Copyright 2000-2019 The OpenSSL Project Authors. All Rights Reserved. |
e2f92610 | 114 | |
449040b4 | 115 | Licensed under the Apache License 2.0 (the "License"). You may not use |
e2f92610 RS |
116 | this file except in compliance with the License. You can obtain a copy |
117 | in the file LICENSE in the source distribution or at | |
118 | L<https://www.openssl.org/source/license.html>. | |
119 | ||
120 | =cut |