1*b077aed3SPierre Pronchery=pod 2*b077aed3SPierre Pronchery{- OpenSSL::safe::output_do_not_edit_headers(); -} 3*b077aed3SPierre Pronchery 4*b077aed3SPierre Pronchery=head1 NAME 5*b077aed3SPierre Pronchery 6*b077aed3SPierre Proncheryopenssl-gendsa - generate a DSA private key from a set of parameters 7*b077aed3SPierre Pronchery 8*b077aed3SPierre Pronchery=head1 SYNOPSIS 9*b077aed3SPierre Pronchery 10*b077aed3SPierre ProncheryB<openssl> B<gendsa> 11*b077aed3SPierre Pronchery[B<-help>] 12*b077aed3SPierre Pronchery[B<-out> I<filename>] 13*b077aed3SPierre Pronchery[B<-passout> I<arg>] 14*b077aed3SPierre Pronchery[B<-aes128>] 15*b077aed3SPierre Pronchery[B<-aes192>] 16*b077aed3SPierre Pronchery[B<-aes256>] 17*b077aed3SPierre Pronchery[B<-aria128>] 18*b077aed3SPierre Pronchery[B<-aria192>] 19*b077aed3SPierre Pronchery[B<-aria256>] 20*b077aed3SPierre Pronchery[B<-camellia128>] 21*b077aed3SPierre Pronchery[B<-camellia192>] 22*b077aed3SPierre Pronchery[B<-camellia256>] 23*b077aed3SPierre Pronchery[B<-des>] 24*b077aed3SPierre Pronchery[B<-des3>] 25*b077aed3SPierre Pronchery[B<-idea>] 26*b077aed3SPierre Pronchery[B<-verbose>] 27*b077aed3SPierre Pronchery{- $OpenSSL::safe::opt_r_synopsis -} 28*b077aed3SPierre Pronchery{- $OpenSSL::safe::opt_engine_synopsis -}{- $OpenSSL::safe::opt_provider_synopsis -} 29*b077aed3SPierre Pronchery[I<paramfile>] 30*b077aed3SPierre Pronchery 31*b077aed3SPierre Pronchery=head1 DESCRIPTION 32*b077aed3SPierre Pronchery 33*b077aed3SPierre ProncheryThis command generates a DSA private key from a DSA parameter file 34*b077aed3SPierre Pronchery(which will be typically generated by the L<openssl-dsaparam(1)> command). 35*b077aed3SPierre Pronchery 36*b077aed3SPierre Pronchery=head1 OPTIONS 37*b077aed3SPierre Pronchery 38*b077aed3SPierre Pronchery=over 4 39*b077aed3SPierre Pronchery 40*b077aed3SPierre Pronchery=item B<-help> 41*b077aed3SPierre Pronchery 42*b077aed3SPierre ProncheryPrint out a usage message. 43*b077aed3SPierre Pronchery 44*b077aed3SPierre Pronchery=item B<-out> I<filename> 45*b077aed3SPierre Pronchery 46*b077aed3SPierre ProncheryOutput the key to the specified file. If this argument is not specified then 47*b077aed3SPierre Proncherystandard output is used. 48*b077aed3SPierre Pronchery 49*b077aed3SPierre Pronchery=item B<-passout> I<arg> 50*b077aed3SPierre Pronchery 51*b077aed3SPierre ProncheryThe passphrase used for the output file. 52*b077aed3SPierre ProncherySee L<openssl-passphrase-options(1)>. 53*b077aed3SPierre Pronchery 54*b077aed3SPierre Pronchery=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> 55*b077aed3SPierre Pronchery 56*b077aed3SPierre ProncheryThese options encrypt the private key with specified 57*b077aed3SPierre Proncherycipher before outputting it. A pass phrase is prompted for. 58*b077aed3SPierre ProncheryIf none of these options is specified no encryption is used. 59*b077aed3SPierre Pronchery 60*b077aed3SPierre ProncheryNote that all options must be given before the I<paramfile> argument. 61*b077aed3SPierre ProncheryOtherwise they are ignored. 62*b077aed3SPierre Pronchery 63*b077aed3SPierre Pronchery=item B<-verbose> 64*b077aed3SPierre Pronchery 65*b077aed3SPierre ProncheryPrint extra details about the operations being performed. 66*b077aed3SPierre Pronchery 67*b077aed3SPierre Pronchery{- $OpenSSL::safe::opt_r_item -} 68*b077aed3SPierre Pronchery 69*b077aed3SPierre Pronchery{- $OpenSSL::safe::opt_engine_item -} 70*b077aed3SPierre Pronchery 71*b077aed3SPierre Pronchery=item I<paramfile> 72*b077aed3SPierre Pronchery 73*b077aed3SPierre ProncheryThe DSA parameter file to use. The parameters in this file determine 74*b077aed3SPierre Proncherythe size of the private key. DSA parameters can be generated and 75*b077aed3SPierre Proncheryexamined using the L<openssl-dsaparam(1)> command. 76*b077aed3SPierre Pronchery 77*b077aed3SPierre Pronchery{- $OpenSSL::safe::opt_provider_item -} 78*b077aed3SPierre Pronchery 79*b077aed3SPierre Pronchery=back 80*b077aed3SPierre Pronchery 81*b077aed3SPierre Pronchery=head1 NOTES 82*b077aed3SPierre Pronchery 83*b077aed3SPierre ProncheryDSA key generation is little more than random number generation so it is 84*b077aed3SPierre Proncherymuch quicker that RSA key generation for example. 85*b077aed3SPierre Pronchery 86*b077aed3SPierre Pronchery=head1 SEE ALSO 87*b077aed3SPierre Pronchery 88*b077aed3SPierre ProncheryL<openssl(1)>, 89*b077aed3SPierre ProncheryL<openssl-genpkey(1)>, 90*b077aed3SPierre ProncheryL<openssl-dsaparam(1)>, 91*b077aed3SPierre ProncheryL<openssl-dsa(1)>, 92*b077aed3SPierre ProncheryL<openssl-genrsa(1)>, 93*b077aed3SPierre ProncheryL<openssl-rsa(1)> 94*b077aed3SPierre Pronchery 95*b077aed3SPierre Pronchery=head1 HISTORY 96*b077aed3SPierre Pronchery 97*b077aed3SPierre ProncheryThe B<-engine> option was deprecated in OpenSSL 3.0. 98*b077aed3SPierre Pronchery 99*b077aed3SPierre Pronchery=head1 COPYRIGHT 100*b077aed3SPierre Pronchery 101*b077aed3SPierre ProncheryCopyright 2000-2023 The OpenSSL Project Authors. All Rights Reserved. 102*b077aed3SPierre Pronchery 103*b077aed3SPierre ProncheryLicensed under the Apache License 2.0 (the "License"). You may not use 104*b077aed3SPierre Proncherythis file except in compliance with the License. You can obtain a copy 105*b077aed3SPierre Proncheryin the file LICENSE in the source distribution or at 106*b077aed3SPierre ProncheryL<https://www.openssl.org/source/license.html>. 107*b077aed3SPierre Pronchery 108*b077aed3SPierre Pronchery=cut 109