xref: /minix3/crypto/external/bsd/openssl/dist/doc/apps/gendsa.pod (revision 0a6a1f1d05b60e214de2f05a7310ddd1f0e590e7)
1ebfedea0SLionel Sambuc=pod
2ebfedea0SLionel Sambuc
3ebfedea0SLionel Sambuc=head1 NAME
4ebfedea0SLionel Sambuc
5ebfedea0SLionel Sambucgendsa - generate a DSA private key from a set of parameters
6ebfedea0SLionel Sambuc
7ebfedea0SLionel Sambuc=head1 SYNOPSIS
8ebfedea0SLionel Sambuc
9ebfedea0SLionel SambucB<openssl> B<gendsa>
10ebfedea0SLionel Sambuc[B<-out filename>]
11*0a6a1f1dSLionel Sambuc[B<-aes128>]
12*0a6a1f1dSLionel Sambuc[B<-aes192>]
13*0a6a1f1dSLionel Sambuc[B<-aes256>]
14*0a6a1f1dSLionel Sambuc[B<-camellia128>]
15*0a6a1f1dSLionel Sambuc[B<-camellia192>]
16*0a6a1f1dSLionel Sambuc[B<-camellia256>]
17ebfedea0SLionel Sambuc[B<-des>]
18ebfedea0SLionel Sambuc[B<-des3>]
19ebfedea0SLionel Sambuc[B<-idea>]
20ebfedea0SLionel Sambuc[B<-rand file(s)>]
21ebfedea0SLionel Sambuc[B<-engine id>]
22ebfedea0SLionel Sambuc[B<paramfile>]
23ebfedea0SLionel Sambuc
24ebfedea0SLionel Sambuc=head1 DESCRIPTION
25ebfedea0SLionel Sambuc
26ebfedea0SLionel SambucThe B<gendsa> command generates a DSA private key from a DSA parameter file
27ebfedea0SLionel Sambuc(which will be typically generated by the B<openssl dsaparam> command).
28ebfedea0SLionel Sambuc
29ebfedea0SLionel Sambuc=head1 OPTIONS
30ebfedea0SLionel Sambuc
31ebfedea0SLionel Sambuc=over 4
32ebfedea0SLionel Sambuc
33*0a6a1f1dSLionel Sambuc=item B<-aes128|-aes192|-aes256|-camellia128|-camellia192|-camellia256|-des|-des3|-idea>
34ebfedea0SLionel Sambuc
35*0a6a1f1dSLionel SambucThese options encrypt the private key with specified
36*0a6a1f1dSLionel Sambuccipher before outputting it. A pass phrase is prompted for.
37ebfedea0SLionel SambucIf none of these options is specified no encryption is used.
38ebfedea0SLionel Sambuc
39ebfedea0SLionel Sambuc=item B<-rand file(s)>
40ebfedea0SLionel Sambuc
41ebfedea0SLionel Sambuca file or files containing random data used to seed the random number
42ebfedea0SLionel Sambucgenerator, or an EGD socket (see L<RAND_egd(3)|RAND_egd(3)>).
43ebfedea0SLionel SambucMultiple files can be specified separated by a OS-dependent character.
44ebfedea0SLionel SambucThe separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for
45ebfedea0SLionel Sambucall others.
46ebfedea0SLionel Sambuc
47ebfedea0SLionel Sambuc=item B<-engine id>
48ebfedea0SLionel Sambuc
49ebfedea0SLionel Sambucspecifying an engine (by its unique B<id> string) will cause B<gendsa>
50ebfedea0SLionel Sambucto attempt to obtain a functional reference to the specified engine,
51ebfedea0SLionel Sambucthus initialising it if needed. The engine will then be set as the default
52ebfedea0SLionel Sambucfor all available algorithms.
53ebfedea0SLionel Sambuc
54ebfedea0SLionel Sambuc=item B<paramfile>
55ebfedea0SLionel Sambuc
56ebfedea0SLionel SambucThis option specifies the DSA parameter file to use. The parameters in this
57ebfedea0SLionel Sambucfile determine the size of the private key. DSA parameters can be generated
58ebfedea0SLionel Sambucand examined using the B<openssl dsaparam> command.
59ebfedea0SLionel Sambuc
60ebfedea0SLionel Sambuc=back
61ebfedea0SLionel Sambuc
62ebfedea0SLionel Sambuc=head1 NOTES
63ebfedea0SLionel Sambuc
64ebfedea0SLionel SambucDSA key generation is little more than random number generation so it is
65ebfedea0SLionel Sambucmuch quicker that RSA key generation for example.
66ebfedea0SLionel Sambuc
67ebfedea0SLionel Sambuc=head1 SEE ALSO
68ebfedea0SLionel Sambuc
69ebfedea0SLionel SambucL<dsaparam(1)|dsaparam(1)>, L<dsa(1)|dsa(1)>, L<genrsa(1)|genrsa(1)>,
70ebfedea0SLionel SambucL<rsa(1)|rsa(1)>
71ebfedea0SLionel Sambuc
72ebfedea0SLionel Sambuc=cut
73