1*2175Sjp161948=pod 2*2175Sjp161948 3*2175Sjp161948=head1 NAME 4*2175Sjp161948 5*2175Sjp161948gendsa - generate a DSA private key from a set of parameters 6*2175Sjp161948 7*2175Sjp161948=head1 SYNOPSIS 8*2175Sjp161948 9*2175Sjp161948B<openssl> B<gendsa> 10*2175Sjp161948[B<-out filename>] 11*2175Sjp161948[B<-des>] 12*2175Sjp161948[B<-des3>] 13*2175Sjp161948[B<-idea>] 14*2175Sjp161948[B<-rand file(s)>] 15*2175Sjp161948[B<-engine id>] 16*2175Sjp161948[B<paramfile>] 17*2175Sjp161948 18*2175Sjp161948=head1 DESCRIPTION 19*2175Sjp161948 20*2175Sjp161948The B<gendsa> command generates a DSA private key from a DSA parameter file 21*2175Sjp161948(which will be typically generated by the B<openssl dsaparam> command). 22*2175Sjp161948 23*2175Sjp161948=head1 OPTIONS 24*2175Sjp161948 25*2175Sjp161948=over 4 26*2175Sjp161948 27*2175Sjp161948=item B<-des|-des3|-idea> 28*2175Sjp161948 29*2175Sjp161948These options encrypt the private key with the DES, triple DES, or the 30*2175Sjp161948IDEA ciphers respectively before outputting it. A pass phrase is prompted for. 31*2175Sjp161948If none of these options is specified no encryption is used. 32*2175Sjp161948 33*2175Sjp161948=item B<-rand file(s)> 34*2175Sjp161948 35*2175Sjp161948a file or files containing random data used to seed the random number 36*2175Sjp161948generator, or an EGD socket (see L<RAND_egd(3)|RAND_egd(3)>). 37*2175Sjp161948Multiple files can be specified separated by a OS-dependent character. 38*2175Sjp161948The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for 39*2175Sjp161948all others. 40*2175Sjp161948 41*2175Sjp161948=item B<-engine id> 42*2175Sjp161948 43*2175Sjp161948specifying an engine (by it's unique B<id> string) will cause B<req> 44*2175Sjp161948to attempt to obtain a functional reference to the specified engine, 45*2175Sjp161948thus initialising it if needed. The engine will then be set as the default 46*2175Sjp161948for all available algorithms. 47*2175Sjp161948 48*2175Sjp161948=item B<paramfile> 49*2175Sjp161948 50*2175Sjp161948This option specifies the DSA parameter file to use. The parameters in this 51*2175Sjp161948file determine the size of the private key. DSA parameters can be generated 52*2175Sjp161948and examined using the B<openssl dsaparam> command. 53*2175Sjp161948 54*2175Sjp161948=back 55*2175Sjp161948 56*2175Sjp161948=head1 NOTES 57*2175Sjp161948 58*2175Sjp161948DSA key generation is little more than random number generation so it is 59*2175Sjp161948much quicker that RSA key generation for example. 60*2175Sjp161948 61*2175Sjp161948=head1 SEE ALSO 62*2175Sjp161948 63*2175Sjp161948L<dsaparam(1)|dsaparam(1)>, L<dsa(1)|dsa(1)>, L<genrsa(1)|genrsa(1)>, 64*2175Sjp161948L<rsa(1)|rsa(1)> 65*2175Sjp161948 66*2175Sjp161948=cut 67