annotate lib/md4.h @ 9084:2932e92d6e31

* lib/version-etc.c (version_etc_va): Default to GPLv3+. * NEWS: Document this change.
author Eric Blake <ebb9@byu.net>
date Tue, 10 Jul 2007 12:22:36 +0000
parents 7f3d97f1f72d
children b704008db267
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6393
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
1 /* Declarations of functions and data types used for MD4 sum
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
2 library functions.
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
3 Copyright (C) 2000, 2001, 2003, 2005 Free Software Foundation, Inc.
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
4
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
5 This program is free software; you can redistribute it and/or modify it
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
6 under the terms of the GNU General Public License as published by the
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
7 Free Software Foundation; either version 2, or (at your option) any
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
8 later version.
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
9
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
10 This program is distributed in the hope that it will be useful,
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
13 GNU General Public License for more details.
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
14
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
15 You should have received a copy of the GNU General Public License
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
16 along with this program; if not, write to the Free Software Foundation,
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
17 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
18
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
19 #ifndef MD4_H
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
20 # define MD4_H 1
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
21
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
22 # include <stdio.h>
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
23 # include <stdint.h>
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
24
6422
833177ba48f0 * md4.c, md4.c: Simplify buffer handling visavi alignment,
Simon Josefsson <simon@josefsson.org>
parents: 6393
diff changeset
25 # define MD4_DIGEST_SIZE 16
6393
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
26
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
27 /* Structure to save state of computation between the single steps. */
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
28 struct md4_ctx
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
29 {
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
30 uint32_t A;
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
31 uint32_t B;
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
32 uint32_t C;
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
33 uint32_t D;
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
34
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
35 uint32_t total[2];
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
36 uint32_t buflen;
6428
7f3d97f1f72d * md4.h: Shrink buffer size, now that we changed the type.
Simon Josefsson <simon@josefsson.org>
parents: 6422
diff changeset
37 uint32_t buffer[32];
6393
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
38 };
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
39
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
40
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
41 /* Initialize structure containing state of computation. */
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
42 extern void md4_init_ctx (struct md4_ctx *ctx);
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
43
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
44 /* Starting with the result of former calls of this function (or the
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
45 initialization function update the context for the next LEN bytes
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
46 starting at BUFFER.
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
47 It is necessary that LEN is a multiple of 64!!! */
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
48 extern void md4_process_block (const void *buffer, size_t len,
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
49 struct md4_ctx *ctx);
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
50
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
51 /* Starting with the result of former calls of this function (or the
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
52 initialization function update the context for the next LEN bytes
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
53 starting at BUFFER.
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
54 It is NOT required that LEN is a multiple of 64. */
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
55 extern void md4_process_bytes (const void *buffer, size_t len,
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
56 struct md4_ctx *ctx);
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
57
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
58 /* Process the remaining bytes in the buffer and put result from CTX
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
59 in first 16 bytes following RESBUF. The result is always in little
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
60 endian byte order, so that a byte-wise output yields to the wanted
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
61 ASCII representation of the message digest.
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
62
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
63 IMPORTANT: On some systems it is required that RESBUF be correctly
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
64 aligned for a 32 bits value. */
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
65 extern void *md4_finish_ctx (struct md4_ctx *ctx, void *resbuf);
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
66
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
67
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
68 /* Put result from CTX in first 16 bytes following RESBUF. The result is
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
69 always in little endian byte order, so that a byte-wise output yields
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
70 to the wanted ASCII representation of the message digest.
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
71
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
72 IMPORTANT: On some systems it is required that RESBUF is correctly
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
73 aligned for a 32 bits value. */
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
74 extern void *md4_read_ctx (const struct md4_ctx *ctx, void *resbuf);
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
75
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
76
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
77 /* Compute MD4 message digest for bytes read from STREAM. The
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
78 resulting message digest number will be written into the 16 bytes
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
79 beginning at RESBLOCK. */
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
80 extern int md4_stream (FILE * stream, void *resblock);
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
81
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
82 /* Compute MD4 message digest for LEN bytes beginning at BUFFER. The
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
83 result is always in little endian byte order, so that a byte-wise
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
84 output yields to the wanted ASCII representation of the message
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
85 digest. */
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
86 extern void *md4_buffer (const char *buffer, size_t len, void *resblock);
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
87
3131bab6f53d Add md4 module.
Simon Josefsson <simon@josefsson.org>
parents:
diff changeset
88 #endif