annotate src/md5.h @ 2366:82e0f87c7698

[gaim-migrate @ 2379] this should have been moved here originally committer: Tailor Script <tailor@pidgin.im>
author Eric Warmenhoven <eric@warmenhoven.org>
date Thu, 27 Sep 2001 02:56:38 +0000
parents
children 6c4ec021c998
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2366
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
1 /*
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
2 Copyright (C) 1999 Aladdin Enterprises. All rights reserved.
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
3
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
4 This software is provided 'as-is', without any express or implied
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
5 warranty. In no event will the authors be held liable for any damages
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
6 arising from the use of this software.
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
7
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
8 Permission is granted to anyone to use this software for any purpose,
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
9 including commercial applications, and to alter it and redistribute it
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
10 freely, subject to the following restrictions:
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
11
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
12 1. The origin of this software must not be misrepresented; you must not
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
13 claim that you wrote the original software. If you use this software
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
14 in a product, an acknowledgment in the product documentation would be
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
15 appreciated but is not required.
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
16 2. Altered source versions must be plainly marked as such, and must not be
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
17 misrepresented as being the original software.
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
18 3. This notice may not be removed or altered from any source distribution.
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
19
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
20 L. Peter Deutsch
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
21 ghost@aladdin.com
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
22
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
23 */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
24 /*$Id: md5.h 2379 2001-09-27 02:56:38Z warmenhoven $ */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
25 /*
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
26 Independent implementation of MD5 (RFC 1321).
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
27
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
28 This code implements the MD5 Algorithm defined in RFC 1321.
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
29 It is derived directly from the text of the RFC and not from the
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
30 reference implementation.
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
31
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
32 The original and principal author of md5.h is L. Peter Deutsch
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
33 <ghost@aladdin.com>. Other authors are noted in the change history
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
34 that follows (in reverse chronological order):
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
35
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
36 1999-11-04 lpd Edited comments slightly for automatic TOC extraction.
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
37 1999-10-18 lpd Fixed typo in header comment (ansi2knr rather than md5);
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
38 added conditionalization for C++ compilation from Martin
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
39 Purschke <purschke@bnl.gov>.
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
40 1999-05-03 lpd Original version.
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
41 */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
42
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
43 #ifndef md5_INCLUDED
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
44 # define md5_INCLUDED
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
45
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
46 /*
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
47 * This code has some adaptations for the Ghostscript environment, but it
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
48 * will compile and run correctly in any environment with 8-bit chars and
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
49 * 32-bit ints. Specifically, it assumes that if the following are
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
50 * defined, they have the same meaning as in Ghostscript: P1, P2, P3,
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
51 * ARCH_IS_BIG_ENDIAN.
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
52 */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
53
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
54 typedef unsigned char md5_byte_t; /* 8-bit byte */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
55 typedef unsigned int md5_word_t; /* 32-bit word */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
56
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
57 /* Define the state of the MD5 Algorithm. */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
58 typedef struct md5_state_s {
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
59 md5_word_t count[2]; /* message length in bits, lsw first */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
60 md5_word_t abcd[4]; /* digest buffer */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
61 md5_byte_t buf[64]; /* accumulate block */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
62 } md5_state_t;
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
63
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
64 #ifdef __cplusplus
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
65 extern "C"
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
66 {
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
67 #endif
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
68
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
69 /* Initialize the algorithm. */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
70 #ifdef P1
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
71 void md5_init(P1(md5_state_t *pms));
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
72 #else
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
73 void md5_init(md5_state_t *pms);
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
74 #endif
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
75
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
76 /* Append a string to the message. */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
77 #ifdef P3
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
78 void md5_append(P3(md5_state_t *pms, const md5_byte_t *data, int nbytes));
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
79 #else
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
80 void md5_append(md5_state_t *pms, const md5_byte_t *data, int nbytes);
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
81 #endif
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
82
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
83 /* Finish the message and return the digest. */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
84 #ifdef P2
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
85 void md5_finish(P2(md5_state_t *pms, md5_byte_t digest[16]));
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
86 #else
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
87 void md5_finish(md5_state_t *pms, md5_byte_t digest[16]);
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
88 #endif
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
89
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
90 #ifdef __cplusplus
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
91 } /* end extern "C" */
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
92 #endif
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
93
82e0f87c7698 [gaim-migrate @ 2379]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
94 #endif /* md5_INCLUDED */