home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / rexx_md5.zip / read.me < prev    next >
Text File  |  1998-11-10  |  3KB  |  79 lines
  1. 10 Nov 1998. Daniel Hellerstein, danielh@econ.ag.gov
  2.  
  3.                 Two REXX tools for computing MD5 digests 
  4.  
  5. Description:
  6.  
  7.  REXX_MD5 contains two OS/2 REXX tools that allow you to compute
  8.  the MD5 digest of any string.
  9.  
  10.      1) REXX_MD5) An "all rexx code" procedure
  11.                   For example: MyMD5=rexx_md5('a string to digest')
  12.  
  13.               Since REXX is weak at repetitive math, this
  14.               method (REXX_MD5) is not very fast (actually, it's 
  15.               excuriatingly slow on large strings). For smaller 
  16.               strings (say, less then a few hundred characters) it's 
  17.               tolerable. 
  18.  
  19.      2) SRXFUNC) A DLL containing SRX_MD5  
  20.                  For example: MyMD5=srx_md5('a string to digest')       
  21.  
  22.                            
  23.            For longer strings, the SRX_MD5 function (contained in
  24.            the SRXFUNC.DLL) is recommended -- it's much faster
  25.            and just as easily called. 
  26.  
  27.       The only drawback to using SRX_MD5 is that you have to distribute the
  28.       DLL as a seperate file; whereas REXX_MD5 can be included in your
  29.       REXX source code.
  30.  
  31.       CAUTION: for unknown reasons, rapid and repetitive calls to SRX_MD5 can
  32.                cause SYS3175 errors.  
  33.  
  34.  
  35. MD5 digests of files:
  36.        
  37.      If you need to compute MD5 digests of files, you      
  38.      will have to read the file into a string, and
  39.      feed this string to SRX_MD5 (or REXX_MD5).
  40.  
  41.      As an alternative, you might find the MD5.EXE at 
  42.           http://hobbes.nmsu.edu/pub/os2/unix/apps/misc/md5_os2.zip 
  43.         to be convenient (it's a standalone program).
  44.                           
  45.  
  46. Example:
  47.  
  48.   The TESTMD5.CMD demonstrates the use of both tools (and shows how to
  49.   load the SRX_MD5 procedure from SRXMD5.DLL).
  50.  
  51.  
  52. Source Code:
  53.      
  54.    MD5SRC.ZIP contains the source code used to create SRXMD5.DLL.  It's
  55.    written in Fortran (WATCOM 11.0), and probably requires WATCOM 11.0
  56.    to recreate (use the MAKEFILE). 
  57.  
  58.  
  59. Conditions of Use:
  60.  
  61.    The programs contained herein may be freely used by anyone for any purpose.
  62.    You may include this product in your own work and distribute it freely,
  63.    with the understanding that recipients of this product have the same
  64.    rights. Proper attribution is expected, but need not be prominent.
  65.  
  66. Disclaimer:
  67.   
  68.    We, the authors of REXX_MD5 and any potentially affiliated institutions,
  69.    disclaim any and all liability for damages due to the use, misuse, or
  70.    failure of the product or subsets of the product. Use it at your
  71.    own risk!  That said: the product has been tested, and is used in other
  72.    work of ours (but please do not the above caution). If you should find a 
  73.    problem, PLEASE LET US KNOW (see the address at the top of this document).
  74.  
  75.  
  76.    
  77. Bonus: Also contains srx_sha: SHA-1 digest.
  78.  
  79.