]>
Commit | Line | Data |
---|---|---|
aba3e65f DSH |
1 | =pod |
2 | ||
3 | =head1 NAME | |
4 | ||
b6b66573 | 5 | openssl-gendsa - generate a DSA private key from a set of parameters |
aba3e65f DSH |
6 | |
7 | =head1 SYNOPSIS | |
8 | ||
9 | B<openssl> B<gendsa> | |
169394d4 | 10 | [B<-help>] |
aba3e65f | 11 | [B<-out filename>] |
fc1d88f0 RS |
12 | [B<-aes128>] |
13 | [B<-aes192>] | |
14 | [B<-aes256>] | |
d42d0a4d P |
15 | [B<-aria128>] |
16 | [B<-aria192>] | |
17 | [B<-aria256>] | |
fc1d88f0 RS |
18 | [B<-camellia128>] |
19 | [B<-camellia192>] | |
20 | [B<-camellia256>] | |
aba3e65f DSH |
21 | [B<-des>] |
22 | [B<-des3>] | |
23 | [B<-idea>] | |
3ee1eac2 RS |
24 | [B<-rand file...>] |
25 | [B<-writerand file>] | |
bfa35550 | 26 | [B<-engine id>] |
b6a07f67 | 27 | [B<-verbose>] |
aba3e65f DSH |
28 | [B<paramfile>] |
29 | ||
30 | =head1 DESCRIPTION | |
31 | ||
32 | The B<gendsa> command generates a DSA private key from a DSA parameter file | |
33 | (which will be typically generated by the B<openssl dsaparam> command). | |
34 | ||
35 | =head1 OPTIONS | |
36 | ||
37 | =over 4 | |
38 | ||
169394d4 MR |
39 | =item B<-help> |
40 | ||
41 | Print out a usage message. | |
42 | ||
43 | =item B<-out filename> | |
44 | ||
45 | Output the key to the specified file. If this argument is not specified then | |
46 | standard output is used. | |
47 | ||
dfee8626 | 48 | =item B<-aes128>, B<-aes192>, B<-aes256>, B<-aria128>, B<-aria192>, B<-aria256>, B<-camellia128>, B<-camellia192>, B<-camellia256>, B<-des>, B<-des3>, B<-idea> |
aba3e65f | 49 | |
fc1d88f0 RS |
50 | These options encrypt the private key with specified |
51 | cipher before outputting it. A pass phrase is prompted for. | |
aba3e65f DSH |
52 | If none of these options is specified no encryption is used. |
53 | ||
3ee1eac2 | 54 | =item B<-rand file...> |
aba3e65f | 55 | |
c4de074e | 56 | A file or files containing random data used to seed the random number |
3ee1eac2 | 57 | generator. |
35ed393e | 58 | Multiple files can be specified separated by an OS-dependent character. |
b87ef946 | 59 | The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for |
a4cfd178 | 60 | all others. |
aba3e65f | 61 | |
3ee1eac2 RS |
62 | =item [B<-writerand file>] |
63 | ||
64 | Writes random data to the specified I<file> upon exit. | |
65 | This can be used with a subsequent B<-rand> flag. | |
66 | ||
bfa35550 RL |
67 | =item B<-engine id> |
68 | ||
c4de074e | 69 | Specifying an engine (by its unique B<id> string) will cause B<gendsa> |
bfa35550 RL |
70 | to attempt to obtain a functional reference to the specified engine, |
71 | thus initialising it if needed. The engine will then be set as the default | |
72 | for all available algorithms. | |
73 | ||
b6a07f67 PP |
74 | =item B<-verbose> |
75 | ||
76 | Print extra details about the operations being performed. | |
77 | ||
aba3e65f DSH |
78 | =item B<paramfile> |
79 | ||
80 | This option specifies the DSA parameter file to use. The parameters in this | |
81 | file determine the size of the private key. DSA parameters can be generated | |
82 | and examined using the B<openssl dsaparam> command. | |
83 | ||
84 | =back | |
85 | ||
86 | =head1 NOTES | |
87 | ||
88 | DSA key generation is little more than random number generation so it is | |
89 | much quicker that RSA key generation for example. | |
90 | ||
91 | =head1 SEE ALSO | |
92 | ||
b6b66573 DMSP |
93 | L<openssl(1)>, |
94 | L<openssl-dsaparam(1)>, | |
95 | L<openssl-dsa(1)>, | |
96 | L<openssl-genrsa(1)>, | |
97 | L<openssl-rsa(1)> | |
aba3e65f | 98 | |
e2f92610 RS |
99 | =head1 COPYRIGHT |
100 | ||
b6b66573 | 101 | Copyright 2000-2019 The OpenSSL Project Authors. All Rights Reserved. |
e2f92610 | 102 | |
449040b4 | 103 | Licensed under the Apache License 2.0 (the "License"). You may not use |
e2f92610 RS |
104 | this file except in compliance with the License. You can obtain a copy |
105 | in the file LICENSE in the source distribution or at | |
106 | L<https://www.openssl.org/source/license.html>. | |
107 | ||
108 | =cut |