Add new program dhparam and update docs.
[openssl.git] / doc / apps / dhparam.pod
similarity index 61%
rename from doc/apps/dh.pod
rename to doc/apps/dhparam.pod
index 99b3073..59d1f68 100644 (file)
@@ -2,7 +2,7 @@
 
 =head1 NAME
 
-dh - DH parameter manipulation and generation
+dhparam - DH parameter manipulation and generation
 
 =head1 SYNOPSIS
 
@@ -14,6 +14,10 @@ B<openssl dh>
 [B<-noout>]
 [B<-text>]
 [B<-C>]
+[B<-2>]
+[B<-5>]
+[B<-rand file(s)>]
+[numbits]
 
 =head1 DESCRIPTION
 
@@ -46,6 +50,25 @@ This specifies the output filename parameters to. Standard output is used
 if this option is not present. The output filename should B<not> be the same
 as the input filename.
 
+=item B<-2>, B<-5>
+
+The generator to use, either 2 or 5. 2 is the default. If present then the
+input file is ignored and parameters are generated instead.
+
+=item B<-rand file(s)>
+
+a file or files containing random data used to seed the random number
+generator. Multiple files can be specified separated by a OS-dependent
+character.  For MS-Windows, the separator is B<;>.  For OpenVMS, it's
+B<,>. For all others, it's B<:>.
+
+=item B<numbits>
+
+this option specifies that a parameter set should be generated of size
+B<numbits>. It must be the last option. If not present then a value of 512
+is used. If this option is present then the input file is ignored and 
+parameters are generated instead.
+
 =item B<-noout>
 
 this option inhibits the output of the encoded version of the parameters.
@@ -61,6 +84,13 @@ be loaded by calling the B<get_dhXXX()> function.
 
 =back
 
+=head1 WARNINGS
+
+The program B<dhparam> combines the functionality of the programs B<dh> and
+B<gendh> in previous versions of OpenSSL and SSLeay. The B<dh> and B<gendh>
+programs are retained for now but may have different purposes in future 
+versions of OpenSSL.
+
 =head1 NOTES
 
 PEM format DH parameters use the header and footer lines:
@@ -75,9 +105,6 @@ This program manipulates DH parameters not keys.
 
 =head1 BUGS
 
-This program is badly named: the B<rsa> and B<dsa> programs manipulate keys
-and not parameters.
-
 There should be a way to generate and manipulate DH keys.
 
 =head1 SEE ALSO