xref: /openbsd-src/share/man/man9/md5.9 (revision 50e8163868bfc3460b84ac8d9bc9bc752521e2f6)
1.\"	$OpenBSD: md5.9,v 1.14 2015/11/24 14:58:56 jmc Exp $
2.\"
3.\" Copyright (c) 1996	Michael Shalayeff
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25.\"
26.Dd $Mdocdate: November 24 2015 $
27.Dt MD5INIT 9
28.Os
29.Sh NAME
30.Nm MD5Init ,
31.Nm MD5Transform
32.Nd message digest routines
33.Sh SYNOPSIS
34.In sys/kernel.h
35.Ft void
36.Fn MD5Init "u_int32_t buf[4]"
37.Ft void
38.Fn MD5Transform "u_int32_t buf[4]" "u_int32_t const in[16]"
39.Sh DESCRIPTION
40The
41.Nm
42module implements the RSA Data Security, Inc.
43MD5 Message-Digest Algorithm (MD5).
44It produces 128-bit MD5 Digest of data.
45.Bl -hang -width MD5Transform
46.It Fn MD5Init
47must be called just before
48.Fn MD5Transform
49will be used to produce a digest.
50The
51.Fa buf
52argument is the storage for the digest being produced on subsequent
53calls to the
54.Fn MD5Transform
55routine.
56.It Fn MD5Transform
57is the core of the MD5 algorithm, this alters an existing MD5 hash
58kept in
59.Fa buf
60to reflect the addition of 16 longwords
61of new data passed in
62.Fa in
63argument.
64.El
65.Sh COPYRIGHTS
66The code for MD5 transform was taken from Colin Plumb's
67implementation, which has been placed in the public domain.
68The MD5 cryptographic checksum was devised by Ronald Rivest, and is
69documented in RFC 1321, "The MD5 Message Digest Algorithm".
70.Sh SEE ALSO
71.Xr random 4 ,
72.Xr arc4random 9
73