diff options
Diffstat (limited to '')
| -rw-r--r-- | src/usr.bin/openssl/openssl.1 | 77 |
1 files changed, 24 insertions, 53 deletions
diff --git a/src/usr.bin/openssl/openssl.1 b/src/usr.bin/openssl/openssl.1 index 0f47f6e65c..acee5d3bb3 100644 --- a/src/usr.bin/openssl/openssl.1 +++ b/src/usr.bin/openssl/openssl.1 | |||
| @@ -1,4 +1,4 @@ | |||
| 1 | .\" $OpenBSD: openssl.1,v 1.42 2016/07/28 16:22:06 jmc Exp $ | 1 | .\" $OpenBSD: openssl.1,v 1.43 2016/08/01 07:23:29 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 | .\" |
| @@ -112,7 +112,7 @@ | |||
| 112 | .\" | 112 | .\" |
| 113 | .\" OPENSSL | 113 | .\" OPENSSL |
| 114 | .\" | 114 | .\" |
| 115 | .Dd $Mdocdate: July 28 2016 $ | 115 | .Dd $Mdocdate: August 1 2016 $ |
| 116 | .Dt OPENSSL 1 | 116 | .Dt OPENSSL 1 |
| 117 | .Os | 117 | .Os |
| 118 | .Sh NAME | 118 | .Sh NAME |
| @@ -1060,23 +1060,15 @@ or standard output if not specified. | |||
| 1060 | .It Fl outform Cm der | pem | 1060 | .It Fl outform Cm der | pem |
| 1061 | Specify the PKCS#7 structure output format. | 1061 | Specify the PKCS#7 structure output format. |
| 1062 | .El | 1062 | .El |
| 1063 | .\" | ||
| 1064 | .\" DGST | ||
| 1065 | .\" | ||
| 1066 | .Sh DGST | 1063 | .Sh DGST |
| 1067 | .nr nS 1 | 1064 | .nr nS 1 |
| 1068 | .Nm "openssl dgst" | 1065 | .Nm "openssl dgst" |
| 1069 | .Bk -words | ||
| 1070 | .Oo | ||
| 1071 | .Fl gost-mac | streebog256 | streebog512 | md_gost94 | | ||
| 1072 | .Fl md4 | md5 | ripemd160 | sha1 | | ||
| 1073 | .Fl sha224 | sha256 | sha384 | sha512 | whirlpool | ||
| 1074 | .Oc | ||
| 1075 | .Op Fl binary | ||
| 1076 | .Op Fl cd | 1066 | .Op Fl cd |
| 1067 | .Op Fl binary | ||
| 1068 | .Op Fl Ar digest | ||
| 1077 | .Op Fl hex | 1069 | .Op Fl hex |
| 1078 | .Op Fl hmac Ar key | 1070 | .Op Fl hmac Ar key |
| 1079 | .Op Fl keyform Ar PEM | 1071 | .Op Fl keyform Cm pem |
| 1080 | .Op Fl mac Ar algorithm | 1072 | .Op Fl mac Ar algorithm |
| 1081 | .Op Fl macopt Ar nm : Ns Ar v | 1073 | .Op Fl macopt Ar nm : Ns Ar v |
| 1082 | .Op Fl out Ar file | 1074 | .Op Fl out Ar file |
| @@ -1087,17 +1079,8 @@ Specify the PKCS#7 structure output format. | |||
| 1087 | .Op Fl sigopt Ar nm : Ns Ar v | 1079 | .Op Fl sigopt Ar nm : Ns Ar v |
| 1088 | .Op Fl verify Ar file | 1080 | .Op Fl verify Ar file |
| 1089 | .Op Ar | 1081 | .Op Ar |
| 1090 | .Ek | ||
| 1091 | .nr nS 0 | 1082 | .nr nS 0 |
| 1092 | .Pp | 1083 | .Pp |
| 1093 | .Nm openssl | ||
| 1094 | .Cm gost-mac | streebog256 | streebog512 | md_gost94 | | ||
| 1095 | .Cm md4 | md5 | ripemd160 | sha1 | | ||
| 1096 | .Cm sha224 | sha256 | sha384 | sha512 | whirlpool | ||
| 1097 | .Op Fl c | ||
| 1098 | .Op Fl d | ||
| 1099 | .Op Ar | ||
| 1100 | .Pp | ||
| 1101 | The digest functions output the message digest of a supplied | 1084 | The digest functions output the message digest of a supplied |
| 1102 | .Ar file | 1085 | .Ar file |
| 1103 | or | 1086 | or |
| @@ -1110,11 +1093,22 @@ The options are as follows: | |||
| 1110 | .It Fl binary | 1093 | .It Fl binary |
| 1111 | Output the digest or signature in binary form. | 1094 | Output the digest or signature in binary form. |
| 1112 | .It Fl c | 1095 | .It Fl c |
| 1113 | Print out the digest in two-digit groups separated by colons; only relevant if | 1096 | Print out the digest in two-digit groups separated by colons. |
| 1114 | .Em hex | ||
| 1115 | format output is used. | ||
| 1116 | .It Fl d | 1097 | .It Fl d |
| 1117 | Print out BIO debugging information. | 1098 | Print out BIO debugging information. |
| 1099 | .It Fl Ar digest | ||
| 1100 | Use the specified message | ||
| 1101 | .Ar digest . | ||
| 1102 | The default is MD5. | ||
| 1103 | The available digests can be displayed using | ||
| 1104 | .Nm openssl | ||
| 1105 | .Cm list-message-digest-commands . | ||
| 1106 | The following are equivalent: | ||
| 1107 | .Nm openssl dgst | ||
| 1108 | .Fl md5 | ||
| 1109 | and | ||
| 1110 | .Nm openssl | ||
| 1111 | .Cm md5 . | ||
| 1118 | .It Fl hex | 1112 | .It Fl hex |
| 1119 | Digest is to be output as a hex dump. | 1113 | Digest is to be output as a hex dump. |
| 1120 | This is the default case for a | 1114 | This is the default case for a |
| @@ -1123,7 +1117,7 @@ digest as opposed to a digital signature. | |||
| 1123 | .It Fl hmac Ar key | 1117 | .It Fl hmac Ar key |
| 1124 | Create a hashed MAC using | 1118 | Create a hashed MAC using |
| 1125 | .Ar key . | 1119 | .Ar key . |
| 1126 | .It Fl keyform Ar PEM | 1120 | .It Fl keyform Cm pem |
| 1127 | Specifies the key format to sign the digest with. | 1121 | Specifies the key format to sign the digest with. |
| 1128 | .It Fl mac Ar algorithm | 1122 | .It Fl mac Ar algorithm |
| 1129 | Create a keyed Message Authentication Code (MAC). | 1123 | Create a keyed Message Authentication Code (MAC). |
| @@ -1137,16 +1131,17 @@ Passes options to the MAC algorithm, specified by | |||
| 1137 | .Fl mac . | 1131 | .Fl mac . |
| 1138 | The following options are supported by HMAC: | 1132 | The following options are supported by HMAC: |
| 1139 | .Bl -tag -width Ds | 1133 | .Bl -tag -width Ds |
| 1140 | .It Ar key : Ns Ar string | 1134 | .It Cm key : Ns Ar string |
| 1141 | Specifies the MAC key as an alphanumeric string | 1135 | Specifies the MAC key as an alphanumeric string |
| 1142 | (use if the key contain printable characters only). | 1136 | (use if the key contain printable characters only). |
| 1143 | String length must conform to any restrictions of the MAC algorithm. | 1137 | String length must conform to any restrictions of the MAC algorithm. |
| 1144 | .It Ar hexkey : Ns Ar string | 1138 | .It Cm hexkey : Ns Ar string |
| 1145 | Specifies the MAC key in hexadecimal form (two hex digits per byte). | 1139 | Specifies the MAC key in hexadecimal form (two hex digits per byte). |
| 1146 | Key length must conform to any restrictions of the MAC algorithm. | 1140 | Key length must conform to any restrictions of the MAC algorithm. |
| 1147 | .El | 1141 | .El |
| 1148 | .It Fl out Ar file | 1142 | .It Fl out Ar file |
| 1149 | The file to output to, or standard output by default. | 1143 | The output file to write to, |
| 1144 | or standard output if not specified. | ||
| 1150 | .It Fl passin Ar arg | 1145 | .It Fl passin Ar arg |
| 1151 | The key password source. | 1146 | The key password source. |
| 1152 | .It Fl prverify Ar file | 1147 | .It Fl prverify Ar file |
| @@ -1175,30 +1170,6 @@ or | |||
| 1175 | File or files to digest. | 1170 | File or files to digest. |
| 1176 | If no files are specified then standard input is used. | 1171 | If no files are specified then standard input is used. |
| 1177 | .El | 1172 | .El |
| 1178 | .Sh DGST NOTES | ||
| 1179 | The digest of choice for all new applications is SHA1. | ||
| 1180 | Other digests are, however, still widely used. | ||
| 1181 | .Pp | ||
| 1182 | If you wish to sign or verify data using the DSA algorithm, the dss1 | ||
| 1183 | digest must be used. | ||
| 1184 | .Pp | ||
| 1185 | A source of random numbers is required for certain signing algorithms, in | ||
| 1186 | particular DSA. | ||
| 1187 | .Pp | ||
| 1188 | The signing and verify options should only be used if a single file is | ||
| 1189 | being signed or verified. | ||
| 1190 | .\" | ||
| 1191 | .\" DH | ||
| 1192 | .\" | ||
| 1193 | .Sh DH | ||
| 1194 | Diffie-Hellman Parameter Management. | ||
| 1195 | The | ||
| 1196 | .Nm dh | ||
| 1197 | command has been replaced by | ||
| 1198 | .Nm dhparam . | ||
| 1199 | See | ||
| 1200 | .Sx DHPARAM | ||
| 1201 | below. | ||
| 1202 | .\" | 1173 | .\" |
| 1203 | .\" DHPARAM | 1174 | .\" DHPARAM |
| 1204 | .\" | 1175 | .\" |
