README
1Crypt::RIPEMD160 Extension Version 0.04
2
3Crypt::RIPEMD160 adcO "RIPEMD-160 message digest algorithm" CHGEUER
4
5#########################################################################
6
7CHANGES:
8
9Crypt-RIPEMD160-0.04 now supports BigEndian architectures (thanks to Ken Neighbors)
10
11#########################################################################
12
13INSTALLATION:
14
15This is a Perl5 extension interface to the RIPEMD-160
16Message Digest algorithm. Documentation is in RIPEMD160.pm
17
18To build the extension, unpack this distribution under the ext/
19directory of your Perl source distribution, create the Makefile using
20'perl Makefile.PL' and do a 'make'.
21
22Then try a 'make test' and wait for performing all tests.
23
24#########################################################################
25
26SOURCES:
27
28All files in doc/ and the rmd160.*-files are taken from a sample
29implementation of RIPEMD-160.
30
31see also the RIPEMD160-Homepage:
32http://www.esat.kuleuven.ac.be/~bosselae/ripemd160.html
33
34The wrap_160.*-files are wrapper-code to allow the user to add
35small pieces of data to the message digest and to have the same
36convenient API like MD5 and SHA give. The Wrapper-Code was written
37by Christian Geuer.
38
39The rest (RIPEMD160.pm, RIPEMD160.xs, typemap, test.pl and Makefile.PL) are
40stolen and modified from MD5-1.7 and SHA-1.1. Thanks to Neil Wilton and
41Uwe Hollerbach for writing this code.
42
43Thanks to Ken Neighbors who updated this module to support big-endian
44systems in April 2001. Enclosed his comments:
45
46<COMMENT FROM="Ken Neighbors">
47I changed three files: RIPEMD160.xs, wrap_160.h, wrap_160.c
48
49In RIPEMD160.xs, the section commented /* Little Endian (1234) */
50actually works for big-endian systems as well, so I deleted the
51section commented /* Big Endian (4321) */.
52
53In wrap_160.h I added a buffer called "data" to hold the unprocessed
54bytes. The buffer "X" is now only used to hold bytes for processing.
55
56In wrap_160.c I used a trick from hashtest.c (available at
57http://www.esat.kuleuven.ac.be/~bosselae/ripemd160.html) to do the
58correct byte-ordering.
59</COMMENT>
60
61#########################################################################
62
63ADRESSES:
64
65Christian Geuer-Pollmann: geuer-pollmann@nue.et-inf.uni-siegen.de
66Uwe Hollerbach: uh@alumni.caltech.edu
67Ken Neighbors: ken@nsds.com
68Neil Wilton: N.Wilton@axion.bt.co.uk
69
70#########################################################################
71
72TEST-VECTORS:
73
74RIPEMD-160 test suite results (ASCII):
75
76* message: "" (empty string)
77 hashcode: 9c1185a5c5e9fc54612808977ee8f548b2258d31
78* message: "a"
79 hashcode: 0bdc9d2d256b3ee9daae347be6f4dc835a467ffe
80* message: "abc"
81 hashcode: 8eb208f7e05d987a9b044a8e98c6b087f15a0bfc
82* message: "message digest"
83 hashcode: 5d0689ef49d2fae572b881b123a85ffa21595f36
84* message: "abcdefghijklmnopqrstuvwxyz"
85 hashcode: f71c27109c692c1b56bbdceb5b9d2865b3708dbc
86* message: "abcdbcdecdefdefgefghfghighijhijkijkljklmklmnlmnomnopnopq"
87 hashcode: 12a053384a9c0c88e405a06c27dcf49ada62eb2b
88* message: "A...Za...z0...9"
89 hashcode: b0e20b6e3116640286ed3a87a5713079b21f5189
90* message: 8 times "1234567890"
91 hashcode: 9b752e45573d4b39f4dbd3323cab82bf63326bfb
92* message: 1 million times "a"
93 hashcode: 52783243c1697bdbe16d37f97f68f08325dc1528
94
95#########################################################################
96