home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / md5.lzh / MD5 / README < prev    next >
Text File  |  1996-01-12  |  3KB  |  59 lines
  1. This directory contains source code for the MD5 message-digest algorithm.
  2.  
  3. MD5.tar.Z is a compressed tar file of all the other files in this directory.
  4.  
  5. "md5-announcement.txt" is the announcement from RSA Data Security that
  6. MD5 is being placed in the public domain for free general use.
  7.  
  8. "rfc1321.txt" is the RFC that describes in detail the MD2, MD4, and MD5
  9. message-digest algorithms.
  10.  
  11. The *.[ch] files were taken exactly from RFC 1321.
  12. I wrote a simple Makefile to build an md5 executable by default,
  13. with targets for "test" (which implements the test in Appendix A.5 in the RFC)
  14. and "clean".  Running Makefile with no targets will build the "md5" binary.
  15.  
  16. There is a typo in the RFC Appendix A.4 (mddriver.c).
  17. Line 20 sets MD to "MD5" by default, but the code wants
  18. MD to be set to one of "2", "4", or "5".
  19. I put a -DMD=5 in the Makefile to mask this problem so that the
  20. code itself remains unchanged from what is in RFC 1321.
  21.  
  22. Ric Anderson, ric@Artisoft.COM, provided a bug fix to the timing test
  23. code that caused a divide by zero aborts on a Sun sparc station-10
  24. running soalris 2.3.  This fix to mddriver.c is the only change to the
  25. code in RFC 1321 and corrects only a problem with the timing tests.
  26. No change to the code that implements the actual checksum has been made.
  27.  
  28. Ric has also provided a man page - "md5.1".  A postscript version
  29. of this man page is in "md5.1.ps" and a text version in "md5.1.txt".
  30.  
  31.                 -- Jim Ellis (jte@cert.org)
  32.  
  33. For OSK Users
  34.  
  35. The original Unix archive MD5.TAR.GZ is included in ths archive. I have made
  36. some alterations to the source files for OSK, but nothing that changes the
  37. checksum implementation. I changed #ifs to #ifdefs, and changed the way
  38. functions are declared to make it compatible with the uWare C Compiler. Any
  39. additions to the code use #ifdef OSK, etc. The OSK version has a help message
  40. (-h) that is not reflected in the man pages.
  41.  
  42. Okay, to compile this thing, you will need the the defs files from the
  43. Blarslib archive (I have included the two you'll need for your convience).
  44. To compile, just use the makefile. The executable included was compiled on
  45. a Blackhawk MM/1 w/68070 & 3 Megs.
  46.  
  47. To check the executeable do the following:
  48.  
  49.                 md5 -x >test2; cmp test test2
  50.  
  51. If there are any differences between the two files, something is wrong.
  52. If you do the timing test option, don't be surprised if it takes a while
  53. on some machines. On my machine it takes around a minute! But since OS9 is
  54. a multitasking system, your mileage may vary.
  55.  
  56. Hopefully this will be useful to someone!
  57.  
  58.                                                       --Dean
  59.