diff options
-rw-r--r-- | src/usr.sbin/openssl/openssl.1 | 114 |
1 files changed, 57 insertions, 57 deletions
diff --git a/src/usr.sbin/openssl/openssl.1 b/src/usr.sbin/openssl/openssl.1 index 86c02fa54a..481bf32726 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.23 2003/11/21 15:12:31 jmc Exp $ | 1 | .\" $OpenBSD: openssl.1,v 1.24 2003/11/26 21:17:17 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 | .\" |
@@ -2138,22 +2138,22 @@ option was added in | |||
2138 | .Sh DSA | 2138 | .Sh DSA |
2139 | .Nm openssl dsa | 2139 | .Nm openssl dsa |
2140 | .Bk -words | 2140 | .Bk -words |
2141 | .Op Fl inform Ar DER | PEM | ||
2142 | .Op Fl outform Ar DER | PEM | ||
2143 | .Op Fl in Ar filename | ||
2144 | .Op Fl passin Ar arg | ||
2145 | .Op Fl out Ar filename | ||
2146 | .Op Fl passout Ar arg | ||
2147 | .Op Fl pubin | ||
2148 | .Op Fl pubout | ||
2149 | .Oo | 2141 | .Oo |
2150 | .Fl des | des3 | aes128 | aes192 | | 2142 | .Fl des | des3 | aes128 | aes192 | |
2151 | .Fl aes256 | 2143 | .Fl aes256 |
2152 | .Oc | 2144 | .Oc |
2153 | .Op Fl text | ||
2154 | .Op Fl noout | ||
2155 | .Op Fl modulus | 2145 | .Op Fl modulus |
2146 | .Op Fl noout | ||
2147 | .Op Fl text | ||
2156 | .Op Fl engine Ar id | 2148 | .Op Fl engine Ar id |
2149 | .Op Fl in Ar filename | ||
2150 | .Op Fl inform Ar DER | PEM | ||
2151 | .Op Fl out Ar filename | ||
2152 | .Op Fl outform Ar DER | PEM | ||
2153 | .Op Fl passin Ar arg | ||
2154 | .Op Fl passout Ar arg | ||
2155 | .Op Fl pubin | ||
2156 | .Op Fl pubout | ||
2157 | .Ek | 2157 | .Ek |
2158 | .Pp | 2158 | .Pp |
2159 | The | 2159 | The |
@@ -2171,6 +2171,36 @@ command. | |||
2171 | .Pp | 2171 | .Pp |
2172 | The options are as follows: | 2172 | The options are as follows: |
2173 | .Bl -tag -width "XXXX" | 2173 | .Bl -tag -width "XXXX" |
2174 | .It Xo | ||
2175 | .Fl des | des3 | aes128 | | ||
2176 | .Fl aes192 | aes256 | ||
2177 | .Xc | ||
2178 | These options encrypt the private key with the DES, triple DES, or the | ||
2179 | AES ciphers, respectively, before outputting it. | ||
2180 | A pass phrase is prompted for. | ||
2181 | If none of these options is specified, the key is written in plain text. | ||
2182 | This means that using the | ||
2183 | .Nm dsa | ||
2184 | utility to read in an encrypted key with no encryption option can be used to | ||
2185 | remove the pass phrase from a key, | ||
2186 | or by setting the encryption options it can be use to add or change | ||
2187 | the pass phrase. | ||
2188 | These options can only be used with | ||
2189 | .Ar PEM | ||
2190 | format output files. | ||
2191 | .It Fl engine Ar id | ||
2192 | Specifying an engine (by it's unique | ||
2193 | .Ar id | ||
2194 | string) will cause | ||
2195 | .Nm dsa | ||
2196 | to attempt to obtain a functional reference to the specified engine, | ||
2197 | thus initialising it if needed. | ||
2198 | The engine will then be set as the default for all available algorithms. | ||
2199 | .It Fl in Ar filename | ||
2200 | This specifies the input | ||
2201 | .Ar filename | ||
2202 | to read a key from or standard input if this option is not specified. | ||
2203 | If the key is encrypted, a pass phrase will be prompted for. | ||
2174 | .It Fl inform Ar DER | PEM | 2204 | .It Fl inform Ar DER | PEM |
2175 | This specifies the input format. | 2205 | This specifies the input format. |
2176 | The | 2206 | The |
@@ -2178,7 +2208,7 @@ The | |||
2178 | argument with a private key uses an ASN1 DER encoded form of an ASN.1 | 2208 | argument with a private key uses an ASN1 DER encoded form of an ASN.1 |
2179 | SEQUENCE consisting of the values of version | 2209 | SEQUENCE consisting of the values of version |
2180 | .Pq currently zero , | 2210 | .Pq currently zero , |
2181 | p, q, g, | 2211 | P, Q, G, |
2182 | the public and private key components, respectively, as ASN.1 INTEGERs. | 2212 | the public and private key components, respectively, as ASN.1 INTEGERs. |
2183 | When used with a public key it uses a | 2213 | When used with a public key it uses a |
2184 | .Em SubjectPublicKeyInfo | 2214 | .Em SubjectPublicKeyInfo |
@@ -2190,15 +2220,23 @@ form is the default format: | |||
2190 | It consists of the DER format base64 | 2220 | It consists of the DER format base64 |
2191 | encoded with additional header and footer lines. | 2221 | encoded with additional header and footer lines. |
2192 | In the case of a private key, PKCS#8 format is also accepted. | 2222 | In the case of a private key, PKCS#8 format is also accepted. |
2223 | .It Fl modulus | ||
2224 | This option prints out the value of the public key component of the key. | ||
2225 | .It Fl noout | ||
2226 | This option prevents output of the encoded version of the key. | ||
2227 | .It Fl out Ar filename | ||
2228 | This specifies the output | ||
2229 | .Ar filename | ||
2230 | to write a key to, or standard output if not specified. | ||
2231 | If any encryption options are set then a pass phrase will be | ||
2232 | prompted for. | ||
2233 | The output filename should | ||
2234 | .Em not | ||
2235 | be the same as the input filename. | ||
2193 | .It Fl outform Ar DER | PEM | 2236 | .It Fl outform Ar DER | PEM |
2194 | This specifies the output format; the options have the same meaning as the | 2237 | This specifies the output format; the options have the same meaning as the |
2195 | .Fl inform | 2238 | .Fl inform |
2196 | option. | 2239 | option. |
2197 | .It Fl in Ar filename | ||
2198 | This specifies the input | ||
2199 | .Ar filename | ||
2200 | to read a key from or standard input if this option is not specified. | ||
2201 | If the key is encrypted, a pass phrase will be prompted for. | ||
2202 | .It Fl passin Ar arg | 2240 | .It Fl passin Ar arg |
2203 | The input file password source. | 2241 | The input file password source. |
2204 | For more information about the format of | 2242 | For more information about the format of |
@@ -2206,15 +2244,6 @@ For more information about the format of | |||
2206 | see the | 2244 | see the |
2207 | .Sx PASS PHRASE ARGUMENTS | 2245 | .Sx PASS PHRASE ARGUMENTS |
2208 | section above. | 2246 | section above. |
2209 | .It Fl out Ar filename | ||
2210 | This specifies the output | ||
2211 | .Ar filename | ||
2212 | to write a key to, or standard output if not specified. | ||
2213 | If any encryption options are set then a pass phrase will be | ||
2214 | prompted for. | ||
2215 | The output filename should | ||
2216 | .Em not | ||
2217 | be the same as the input filename. | ||
2218 | .It Fl passout Ar arg | 2247 | .It Fl passout Ar arg |
2219 | The output file password source. | 2248 | The output file password source. |
2220 | For more information about the format of | 2249 | For more information about the format of |
@@ -2222,29 +2251,6 @@ For more information about the format of | |||
2222 | see the | 2251 | see the |
2223 | .Sx PASS PHRASE ARGUMENTS | 2252 | .Sx PASS PHRASE ARGUMENTS |
2224 | section above. | 2253 | section above. |
2225 | .It Xo | ||
2226 | .Fl des | des3 | aes128 | | ||
2227 | .Fl aes192 | aes256 | ||
2228 | .Xc | ||
2229 | These options encrypt the private key with the DES, triple DES, or the | ||
2230 | AES ciphers, respectively, before outputting it. | ||
2231 | A pass phrase is prompted for. | ||
2232 | If none of these options is specified, the key is written in plain text. | ||
2233 | This means that using the | ||
2234 | .Nm dsa | ||
2235 | utility to read in an encrypted key with no encryption option can be used to | ||
2236 | remove the pass phrase from a key, | ||
2237 | or by setting the encryption options it can be use to add or change | ||
2238 | the pass phrase. | ||
2239 | These options can only be used with | ||
2240 | .Ar PEM | ||
2241 | format output files. | ||
2242 | .It Fl text | ||
2243 | Prints out the public/private key components and parameters. | ||
2244 | .It Fl noout | ||
2245 | This option prevents output of the encoded version of the key. | ||
2246 | .It Fl modulus | ||
2247 | This option prints out the value of the public key component of the key. | ||
2248 | .It Fl pubin | 2254 | .It Fl pubin |
2249 | By default, a private key is read from the input file. | 2255 | By default, a private key is read from the input file. |
2250 | With this option a public key is read instead. | 2256 | With this option a public key is read instead. |
@@ -2252,14 +2258,8 @@ With this option a public key is read instead. | |||
2252 | By default, a private key is output. | 2258 | By default, a private key is output. |
2253 | With this option a public key will be output instead. | 2259 | With this option a public key will be output instead. |
2254 | This option is automatically set if the input is a public key. | 2260 | This option is automatically set if the input is a public key. |
2255 | .It Fl engine Ar id | 2261 | .It Fl text |
2256 | Specifying an engine (by it's unique | 2262 | Prints out the public/private key components and parameters. |
2257 | .Ar id | ||
2258 | string) will cause | ||
2259 | .Nm dsa | ||
2260 | to attempt to obtain a functional reference to the specified engine, | ||
2261 | thus initialising it if needed. | ||
2262 | The engine will then be set as the default for all available algorithms. | ||
2263 | .El | 2263 | .El |
2264 | .Sh DSA NOTES | 2264 | .Sh DSA NOTES |
2265 | The | 2265 | The |