diff options
Diffstat (limited to '')
| -rw-r--r-- | src/usr.sbin/openssl/openssl.1 | 121 |
1 files changed, 62 insertions, 59 deletions
diff --git a/src/usr.sbin/openssl/openssl.1 b/src/usr.sbin/openssl/openssl.1 index 2910cf8b70..86c02fa54a 100644 --- a/src/usr.sbin/openssl/openssl.1 +++ b/src/usr.sbin/openssl/openssl.1 | |||
| @@ -1,4 +1,4 @@ | |||
| 1 | .\" $OpenBSD: openssl.1,v 1.22 2003/10/30 19:12:38 jmc Exp $ | 1 | .\" $OpenBSD: openssl.1,v 1.23 2003/11/21 15:12:31 jmc Exp $ |
| 2 | .\" ==================================================================== | 2 | .\" ==================================================================== |
| 3 | .\" Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved. | 3 | .\" Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved. |
| 4 | .\" | 4 | .\" |
| @@ -1986,17 +1986,18 @@ below. | |||
| 1986 | .Sh DHPARAM | 1986 | .Sh DHPARAM |
| 1987 | .Nm openssl dhparam | 1987 | .Nm openssl dhparam |
| 1988 | .Bk -words | 1988 | .Bk -words |
| 1989 | .Op Fl inform Ar DER | PEM | 1989 | .Op Fl 2 | 5 |
| 1990 | .Op Fl outform Ar DER | PEM | 1990 | .Op Fl C |
| 1991 | .Op Fl in Ar filename | 1991 | .Op Fl check |
| 1992 | .Op Fl out Ar filename | ||
| 1993 | .Op Fl dsaparam | 1992 | .Op Fl dsaparam |
| 1994 | .Op Fl noout | 1993 | .Op Fl noout |
| 1995 | .Op Fl text | 1994 | .Op Fl text |
| 1996 | .Op Fl C | ||
| 1997 | .Op Fl 2 | 5 | ||
| 1998 | .Op Fl rand Ar file ... | ||
| 1999 | .Op Fl engine Ar id | 1995 | .Op Fl engine Ar id |
| 1996 | .Op Fl in Ar filename | ||
| 1997 | .Op Fl inform Ar DER | PEM | ||
| 1998 | .Op Fl out Ar filename | ||
| 1999 | .Op Fl outform Ar DER | PEM | ||
| 2000 | .Op Fl rand Ar file ... | ||
| 2000 | .Op Ar numbits | 2001 | .Op Ar numbits |
| 2001 | .Ek | 2002 | .Ek |
| 2002 | .Pp | 2003 | .Pp |
| @@ -2006,6 +2007,46 @@ command is used to manipulate DH parameter files. | |||
| 2006 | .Pp | 2007 | .Pp |
| 2007 | The options are as follows: | 2008 | The options are as follows: |
| 2008 | .Bl -tag -width "XXXX" | 2009 | .Bl -tag -width "XXXX" |
| 2010 | .It Fl 2 , 5 | ||
| 2011 | The generator to use, either 2 or 5. | ||
| 2012 | 2 is the default. | ||
| 2013 | If present, then the input file is ignored and parameters are generated instead. | ||
| 2014 | .It Fl C | ||
| 2015 | This option converts the parameters into C code. | ||
| 2016 | The parameters can then be loaded by calling the | ||
| 2017 | .Cm get_dh Ns Ar numbits Ns Li () | ||
| 2018 | function. | ||
| 2019 | .It Fl check | ||
| 2020 | Check the DH parameters. | ||
| 2021 | .It Fl dsaparam | ||
| 2022 | If this option is used, DSA rather than DH parameters are read or created; | ||
| 2023 | they are converted to DH format. | ||
| 2024 | Otherwise, | ||
| 2025 | .Qq strong | ||
| 2026 | primes | ||
| 2027 | .Pq such that (p-1)/2 is also prime | ||
| 2028 | will be used for DH parameter generation. | ||
| 2029 | .Pp | ||
| 2030 | DH parameter generation with the | ||
| 2031 | .Fl dsaparam | ||
| 2032 | option is much faster, | ||
| 2033 | and the recommended exponent length is shorter, | ||
| 2034 | which makes DH key exchange more efficient. | ||
| 2035 | Beware that with such DSA-style DH parameters, | ||
| 2036 | a fresh DH key should be created for each use to | ||
| 2037 | avoid small-subgroup attacks that may be possible otherwise. | ||
| 2038 | .It Fl engine Ar id | ||
| 2039 | Specifying an engine (by it's unique | ||
| 2040 | .Ar id | ||
| 2041 | string) will cause | ||
| 2042 | .Nm dhparam | ||
| 2043 | to attempt to obtain a functional reference to the specified engine, | ||
| 2044 | thus initialising it if needed. | ||
| 2045 | The engine will then be set as the default for all available algorithms. | ||
| 2046 | .It Fl in Ar filename | ||
| 2047 | This specifies the input | ||
| 2048 | .Ar filename | ||
| 2049 | to read parameters from or standard input if this option is not specified. | ||
| 2009 | .It Fl inform Ar DER | PEM | 2050 | .It Fl inform Ar DER | PEM |
| 2010 | This specifies the input format. | 2051 | This specifies the input format. |
| 2011 | The argument | 2052 | The argument |
| @@ -2017,14 +2058,15 @@ The | |||
| 2017 | form is the default format: | 2058 | form is the default format: |
| 2018 | it consists of the DER format base64 encoded with | 2059 | it consists of the DER format base64 encoded with |
| 2019 | additional header and footer lines. | 2060 | additional header and footer lines. |
| 2020 | .It Fl outform Ar DER | PEM | 2061 | .It Fl noout |
| 2021 | This specifies the output format; the options have the same meaning as the | 2062 | This option inhibits the output of the encoded version of the parameters. |
| 2022 | .Fl inform | 2063 | .It Ar numbits |
| 2023 | option. | 2064 | This argument specifies that a parameter set should be generated of size |
| 2024 | .It Fl in Ar filename | 2065 | .Ar numbits . |
| 2025 | This specifies the input | 2066 | It must be the last option. |
| 2026 | .Ar filename | 2067 | If not present, then a value of 512 is used. |
| 2027 | to read parameters from or standard input if this option is not specified. | 2068 | If this value is present, then the input file is ignored and |
| 2069 | parameters are generated instead. | ||
| 2028 | .It Fl out Ar filename | 2070 | .It Fl out Ar filename |
| 2029 | This specifies the output | 2071 | This specifies the output |
| 2030 | .Ar filename | 2072 | .Ar filename |
| @@ -2033,57 +2075,18 @@ Standard output is used if this option is not present. | |||
| 2033 | The output filename should | 2075 | The output filename should |
| 2034 | .Em not | 2076 | .Em not |
| 2035 | be the same as the input filename. | 2077 | be the same as the input filename. |
| 2036 | .It Fl dsaparam | 2078 | .It Fl outform Ar DER | PEM |
| 2037 | If this option is used, DSA rather than DH parameters are read or created; | 2079 | This specifies the output format; the options have the same meaning as the |
| 2038 | they are converted to DH format. | 2080 | .Fl inform |
| 2039 | Otherwise, | 2081 | option. |
| 2040 | .Qq strong | ||
| 2041 | primes | ||
| 2042 | .Pq such that (p-1)/2 is also prime | ||
| 2043 | will be used for DH parameter generation. | ||
| 2044 | .Pp | ||
| 2045 | DH parameter generation with the | ||
| 2046 | .Fl dsaparam | ||
| 2047 | option is much faster, | ||
| 2048 | and the recommended exponent length is shorter, | ||
| 2049 | which makes DH key exchange more efficient. | ||
| 2050 | Beware that with such DSA-style DH parameters, | ||
| 2051 | a fresh DH key should be created for each use to | ||
| 2052 | avoid small-subgroup attacks that may be possible otherwise. | ||
| 2053 | .It Fl 2 , 5 | ||
| 2054 | The generator to use, either 2 or 5. | ||
| 2055 | 2 is the default. | ||
| 2056 | If present, then the input file is ignored and parameters are generated instead. | ||
| 2057 | .It Fl rand Ar file ... | 2082 | .It Fl rand Ar file ... |
| 2058 | A file or files containing random data used to seed the random number generator, | 2083 | A file or files containing random data used to seed the random number generator, |
| 2059 | or an EGD socket (see | 2084 | or an EGD socket (see |
| 2060 | .Xr RAND_egd 3 ) . | 2085 | .Xr RAND_egd 3 ) . |
| 2061 | Multiple files can be specified, separated by a | 2086 | Multiple files can be specified, separated by a |
| 2062 | .Sq \&: . | 2087 | .Sq \&: . |
| 2063 | .It Ar numbits | ||
| 2064 | This argument specifies that a parameter set should be generated of size | ||
| 2065 | .Ar numbits . | ||
| 2066 | It must be the last option. | ||
| 2067 | If not present, then a value of 512 is used. | ||
| 2068 | If this value is present, then the input file is ignored and | ||
| 2069 | parameters are generated instead. | ||
| 2070 | .It Fl noout | ||
| 2071 | This option inhibits the output of the encoded version of the parameters. | ||
| 2072 | .It Fl text | 2088 | .It Fl text |
| 2073 | This option prints out the DH parameters in human readable form. | 2089 | This option prints out the DH parameters in human readable form. |
| 2074 | .It Fl C | ||
| 2075 | This option converts the parameters into C code. | ||
| 2076 | The parameters can then be loaded by calling the | ||
| 2077 | .Cm get_dh Ns Ar numbits Ns Li () | ||
| 2078 | function. | ||
| 2079 | .It Fl engine Ar id | ||
| 2080 | Specifying an engine (by it's unique | ||
| 2081 | .Ar id | ||
| 2082 | string) will cause | ||
| 2083 | .Nm dhparam | ||
| 2084 | to attempt to obtain a functional reference to the specified engine, | ||
| 2085 | thus initialising it if needed. | ||
| 2086 | The engine will then be set as the default for all available algorithms. | ||
| 2087 | .El | 2090 | .El |
| 2088 | .Sh DHPARAM WARNINGS | 2091 | .Sh DHPARAM WARNINGS |
| 2089 | The program | 2092 | The program |
