include/md5.h

   1 /*
   2   Copyright (C) 1999, 2002 Aladdin Enterprises.  All rights reserved.
   3
   4   This software is provided 'as-is', without any express or implied
   5   warranty.  In no event will the authors be held liable for any damages
   6   arising from the use of this software.
   7
   8   Permission is granted to anyone to use this software for any purpose,
   9   including commercial applications, and to alter it and redistribute it
  10   freely, subject to the following restrictions:
  11
  12   1. The origin of this software must not be misrepresented; you must not
  13      claim that you wrote the original software. If you use this software
  14      in a product, an acknowledgment in the product documentation would be
  15      appreciated but is not required.
  16   2. Altered source versions must be plainly marked as such, and must not be
  17      misrepresented as being the original software.
  18   3. This notice may not be removed or altered from any source distribution.
  19
  20   L. Peter Deutsch
  21   ghost@aladdin.com
  22
  23  */
  24 /*
  25   Independent implementation of MD5 (RFC 1321).
  26
  27   This code implements the MD5 Algorithm defined in RFC 1321, whose
  28   text is available at
  29         http://www.ietf.org/rfc/rfc1321.txt
  30   The code is derived from the text of the RFC, including the test suite
  31   (section A.5) but excluding the rest of Appendix A.  It does not include
  32   any code or documentation that is identified in the RFC as being
  33   copyrighted.
  34
  35   The original and principal author of md5.h is L. Peter Deutsch
  36   <ghost@aladdin.com>.  Other authors are noted in the change history
  37   that follows (in reverse chronological order):
  38
  39   2002-04-13 lpd Removed support for non-ANSI compilers; removed
  40         references to Ghostscript; clarified derivation from RFC 1321;
  41         now handles byte order either statically or dynamically.
  42   1999-11-04 lpd Edited comments slightly for automatic TOC extraction.
  43   1999-10-18 lpd Fixed typo in header comment (ansi2knr rather than md5);
  44         added conditionalization for C++ compilation from Martin
  45         Purschke <purschke@bnl.gov>.
  46   1999-05-03 lpd Original version.
  47  */
  48
  49 #ifndef md5_INCLUDED
  50 #  define md5_INCLUDED
  51
  52 /*
  53  * This package supports both compile-time and run-time determination of CPU
  54  * byte order.  If ARCH_IS_BIG_ENDIAN is defined as 0, the code will be
  55  * compiled to run only on little-endian CPUs; if ARCH_IS_BIG_ENDIAN is
  56  * defined as non-zero, the code will be compiled to run only on big-endian
  57  * CPUs; if ARCH_IS_BIG_ENDIAN is not defined, the code will be compiled to
  58  * run on either big- or little-endian CPUs, but will run slightly less
  59  * efficiently on either one than if ARCH_IS_BIG_ENDIAN is defined.
  60  */
  61
  62 typedef unsigned char md5_byte_t; /* 8-bit byte */
  63 typedef unsigned int md5_word_t; /* 32-bit word */
  64
  65 /* Define the state of the MD5 Algorithm. */
  66 typedef struct md5_state_s {
  67     md5_word_t count[2];        /* message length in bits, lsw first */
  68     md5_word_t abcd[4];         /* digest buffer */
  69     md5_byte_t buf[64];         /* accumulate block */
  70 } md5_state_t;
  71
  72 #ifdef __cplusplus
  73 extern "C"
  74 {
  75 #endif
  76
  77 /* Initialize the algorithm. */
  78 void md5_init(md5_state_t *pms);
  79
  80 /* Append a string to the message. */
  81 void md5_append(md5_state_t *pms, const md5_byte_t *data, int nbytes);
  82
  83 /* Finish the message and return the digest. */
  84 void md5_finish(md5_state_t *pms, md5_byte_t digest[16]);
  85
  86 #ifdef __cplusplus
  87 }  /* end extern "C" */
  88 #endif
  89
  90 #endif /* md5_INCLUDED */