summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/MD5.3
diff options
context:
space:
mode:
authorschwarze <>2018-02-27 20:28:06 +0000
committerschwarze <>2018-02-27 20:28:06 +0000
commit8f9a6a740a805656d9ec4736e3213cfc7d276548 (patch)
treeb39a3d1b65fcbc0e1ad76ed63ea6213e50330475 /src/lib/libcrypto/man/MD5.3
parentc7b559b461335455516ab3d080f9eaa6a11c230c (diff)
downloadopenbsd-8f9a6a740a805656d9ec4736e3213cfc7d276548.tar.gz
openbsd-8f9a6a740a805656d9ec4736e3213cfc7d276548.tar.bz2
openbsd-8f9a6a740a805656d9ec4736e3213cfc7d276548.zip
Garbage collect MD2 documentation.
We have no code implementing those functions.
Diffstat (limited to 'src/lib/libcrypto/man/MD5.3')
-rw-r--r--src/lib/libcrypto/man/MD5.374
1 files changed, 16 insertions, 58 deletions
diff --git a/src/lib/libcrypto/man/MD5.3 b/src/lib/libcrypto/man/MD5.3
index 1f5fe37ef9..ebb5ba6566 100644
--- a/src/lib/libcrypto/man/MD5.3
+++ b/src/lib/libcrypto/man/MD5.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: MD5.3,v 1.4 2016/11/27 16:20:15 schwarze Exp $ 1.\" $OpenBSD: MD5.3,v 1.5 2018/02/27 20:28:06 schwarze Exp $
2.\" OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400 2.\" OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org> and 4.\" This file was written by Ulf Moeller <ulf@openssl.org> and
@@ -49,46 +49,20 @@
49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
50.\" OF THE POSSIBILITY OF SUCH DAMAGE. 50.\" OF THE POSSIBILITY OF SUCH DAMAGE.
51.\" 51.\"
52.Dd $Mdocdate: November 27 2016 $ 52.Dd $Mdocdate: February 27 2018 $
53.Dt MD5 3 53.Dt MD5 3
54.Os 54.Os
55.Sh NAME 55.Sh NAME
56.Nm MD2 ,
57.Nm MD4 , 56.Nm MD4 ,
58.Nm MD5 , 57.Nm MD5 ,
59.Nm MD2_Init ,
60.Nm MD2_Update ,
61.Nm MD2_Final ,
62.Nm MD4_Init , 58.Nm MD4_Init ,
63.Nm MD4_Update , 59.Nm MD4_Update ,
64.Nm MD4_Final , 60.Nm MD4_Final ,
65.Nm MD5_Init , 61.Nm MD5_Init ,
66.Nm MD5_Update , 62.Nm MD5_Update ,
67.Nm MD5_Final 63.Nm MD5_Final
68.Nd MD2, MD4, and MD5 hash functions 64.Nd MD4 and MD5 hash functions
69.Sh SYNOPSIS 65.Sh SYNOPSIS
70.In openssl/md2.h
71.Ft unsigned char *
72.Fo MD2
73.Fa "const unsigned char *d"
74.Fa "unsigned long n"
75.Fa "unsigned char *md"
76.Fc
77.Ft int
78.Fo MD2_Init
79.Fa "MD2_CTX *c"
80.Fc
81.Ft int
82.Fo MD2_Update
83.Fa "MD2_CTX *c"
84.Fa "const unsigned char *data"
85.Fa "unsigned long len"
86.Fc
87.Ft int
88.Fo MD2_Final
89.Fa "unsigned char *md"
90.Fa "MD2_CTX *c"
91.Fc
92.In openssl/md4.h 66.In openssl/md4.h
93.Ft unsigned char * 67.Ft unsigned char *
94.Fo MD4 68.Fo MD4
@@ -134,23 +108,20 @@
134.Fa "MD5_CTX *c" 108.Fa "MD5_CTX *c"
135.Fc 109.Fc
136.Sh DESCRIPTION 110.Sh DESCRIPTION
137MD2, MD4, and MD5 are cryptographic hash functions with a 128-bit 111MD4 and MD5 are cryptographic hash functions with a 128-bit
138output. 112output.
139.Pp 113.Pp
140.Fn MD2 , 114.Fn MD4
141.Fn MD4 ,
142and 115and
143.Fn MD5 116.Fn MD5
144compute the MD2, MD4, and MD5 message digest of the 117compute the MD4 and MD5 message digest of the
145.Fa n 118.Fa n
146bytes at 119bytes at
147.Fa d 120.Fa d
148and place it in 121and place it in
149.Fa md , 122.Fa md ,
150which must have space for 123which must have space for
151.Dv MD2_DIGEST_LENGTH No == 124.Dv MD4_DIGEST_LENGTH No == Dv MD5_DIGEST_LENGTH No == 16
152.Dv MD4_DIGEST_LENGTH No ==
153.Dv MD5_DIGEST_LENGTH No == 16
154bytes of output. 125bytes of output.
155If 126If
156.Fa md 127.Fa md
@@ -161,49 +132,40 @@ the digest is placed in a static array.
161The following functions may be used if the message is not completely 132The following functions may be used if the message is not completely
162stored in memory: 133stored in memory:
163.Pp 134.Pp
164.Fn MD2_Init 135.Fn MD5_Init
165initializes a 136initializes a
166.Vt MD2_CTX 137.Vt MD5_CTX
167structure. 138structure.
168.Pp 139.Pp
169.Fn MD2_Update 140.Fn MD5_Update
170can be called repeatedly with chunks of the message to be hashed 141can be called repeatedly with chunks of the message to be hashed
171.Pq Fa len No bytes at Fa data . 142.Pq Fa len No bytes at Fa data .
172.Pp 143.Pp
173.Fn MD2_Final 144.Fn MD5_Final
174places the message digest in 145places the message digest in
175.Fa md , 146.Fa md ,
176which must have space for 147which must have space for
177.Dv MD2_DIGEST_LENGTH No == 16 148.Dv MD5_DIGEST_LENGTH No == 16
178bytes of output, and erases the 149bytes of output, and erases the
179.Vt MD2_CTX . 150.Vt MD5_CTX .
180.Pp 151.Pp
181.Fn MD4_Init , 152.Fn MD4_Init ,
182.Fn MD4_Update , 153.Fn MD4_Update ,
183.Fn MD4_Final ,
184.Fn MD5_Init ,
185.Fn MD5_Update ,
186and 154and
187.Fn MD5_Final 155.Fn MD4_Final
188are analogous using an 156are analogous using an
189.Vt MD4_CTX 157.Vt MD4_CTX
190and
191.Vt MD5_CTX
192structure. 158structure.
193.Pp 159.Pp
194Applications should use the higher level functions 160Applications should use the higher level functions
195.Xr EVP_DigestInit 3 161.Xr EVP_DigestInit 3
196etc. instead of calling these hash functions directly. 162etc. instead of calling these hash functions directly.
197.Sh RETURN VALUES 163.Sh RETURN VALUES
198.Fn MD2 , 164.Fn MD4
199.Fn MD4 ,
200and 165and
201.Fn MD5 166.Fn MD5
202return pointers to the hash value. 167return pointers to the hash value.
203.Pp 168.Pp
204.Fn MD2_Init ,
205.Fn MD2_Update ,
206.Fn MD2_Final ,
207.Fn MD4_Init , 169.Fn MD4_Init ,
208.Fn MD4_Update , 170.Fn MD4_Update ,
209.Fn MD4_Final , 171.Fn MD4_Final ,
@@ -215,12 +177,8 @@ return 1 for success or 0 otherwise.
215.Sh SEE ALSO 177.Sh SEE ALSO
216.Xr EVP_DigestInit 3 178.Xr EVP_DigestInit 3
217.Sh STANDARDS 179.Sh STANDARDS
218RFC 1319, RFC 1320, RFC 1321 180RFC 1320, RFC 1321
219.Sh HISTORY 181.Sh HISTORY
220.Fn MD2 ,
221.Fn MD2_Init ,
222.Fn MD2_Update ,
223.Fn MD2_Final ,
224.Fn MD5 , 182.Fn MD5 ,
225.Fn MD5_Init , 183.Fn MD5_Init ,
226.Fn MD5_Update , 184.Fn MD5_Update ,