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