summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
Diffstat (limited to 'src')
-rw-r--r--src/usr.bin/openssl/openssl.177
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
1061Specify the PKCS#7 structure output format. 1061Specify 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
1101The digest functions output the message digest of a supplied 1084The digest functions output the message digest of a supplied
1102.Ar file 1085.Ar file
1103or 1086or
@@ -1110,11 +1093,22 @@ The options are as follows:
1110.It Fl binary 1093.It Fl binary
1111Output the digest or signature in binary form. 1094Output the digest or signature in binary form.
1112.It Fl c 1095.It Fl c
1113Print out the digest in two-digit groups separated by colons; only relevant if 1096Print out the digest in two-digit groups separated by colons.
1114.Em hex
1115format output is used.
1116.It Fl d 1097.It Fl d
1117Print out BIO debugging information. 1098Print out BIO debugging information.
1099.It Fl Ar digest
1100Use the specified message
1101.Ar digest .
1102The default is MD5.
1103The available digests can be displayed using
1104.Nm openssl
1105.Cm list-message-digest-commands .
1106The following are equivalent:
1107.Nm openssl dgst
1108.Fl md5
1109and
1110.Nm openssl
1111.Cm md5 .
1118.It Fl hex 1112.It Fl hex
1119Digest is to be output as a hex dump. 1113Digest is to be output as a hex dump.
1120This is the default case for a 1114This 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
1124Create a hashed MAC using 1118Create a hashed MAC using
1125.Ar key . 1119.Ar key .
1126.It Fl keyform Ar PEM 1120.It Fl keyform Cm pem
1127Specifies the key format to sign the digest with. 1121Specifies the key format to sign the digest with.
1128.It Fl mac Ar algorithm 1122.It Fl mac Ar algorithm
1129Create a keyed Message Authentication Code (MAC). 1123Create a keyed Message Authentication Code (MAC).
@@ -1137,16 +1131,17 @@ Passes options to the MAC algorithm, specified by
1137.Fl mac . 1131.Fl mac .
1138The following options are supported by HMAC: 1132The 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
1141Specifies the MAC key as an alphanumeric string 1135Specifies 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).
1143String length must conform to any restrictions of the MAC algorithm. 1137String length must conform to any restrictions of the MAC algorithm.
1144.It Ar hexkey : Ns Ar string 1138.It Cm hexkey : Ns Ar string
1145Specifies the MAC key in hexadecimal form (two hex digits per byte). 1139Specifies the MAC key in hexadecimal form (two hex digits per byte).
1146Key length must conform to any restrictions of the MAC algorithm. 1140Key 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
1149The file to output to, or standard output by default. 1143The output file to write to,
1144or standard output if not specified.
1150.It Fl passin Ar arg 1145.It Fl passin Ar arg
1151The key password source. 1146The key password source.
1152.It Fl prverify Ar file 1147.It Fl prverify Ar file
@@ -1175,30 +1170,6 @@ or
1175File or files to digest. 1170File or files to digest.
1176If no files are specified then standard input is used. 1171If no files are specified then standard input is used.
1177.El 1172.El
1178.Sh DGST NOTES
1179The digest of choice for all new applications is SHA1.
1180Other digests are, however, still widely used.
1181.Pp
1182If you wish to sign or verify data using the DSA algorithm, the dss1
1183digest must be used.
1184.Pp
1185A source of random numbers is required for certain signing algorithms, in
1186particular DSA.
1187.Pp
1188The signing and verify options should only be used if a single file is
1189being signed or verified.
1190.\"
1191.\" DH
1192.\"
1193.Sh DH
1194Diffie-Hellman Parameter Management.
1195The
1196.Nm dh
1197command has been replaced by
1198.Nm dhparam .
1199See
1200.Sx DHPARAM
1201below.
1202.\" 1173.\"
1203.\" DHPARAM 1174.\" DHPARAM
1204.\" 1175.\"