diff options
Diffstat (limited to 'src')
-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 | .\" |