include/md5.h

   1 /*
   2  * This file is part of the GROMACS molecular simulation package.
   3  *
   4  * Copyright (c) 2012,2013, by the GROMACS development team, led by
   5  * David van der Spoel, Berk Hess, Erik Lindahl, and including many
   6  * others, as listed in the AUTHORS file in the top-level source
   7  * directory and at http://www.gromacs.org.
   8  *
   9  * GROMACS is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU Lesser General Public License
  11  * as published by the Free Software Foundation; either version 2.1
  12  * of the License, or (at your option) any later version.
  13  *
  14  * GROMACS is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17  * Lesser General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Lesser General Public
  20  * License along with GROMACS; if not, see
  21  * http://www.gnu.org/licenses, or write to the Free Software Foundation,
  22  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA.
  23  *
  24  * If you want to redistribute modifications to GROMACS, please
  25  * consider that scientific software is very special. Version
  26  * control is crucial - bugs must be traceable. We will be happy to
  27  * consider code for inclusion in the official distribution, but
  28  * derived work must not be called official GROMACS. Details are found
  29  * in the README & COPYING files - if they are missing, get the
  30  * official version at http://www.gromacs.org.
  31  *
  32  * To help us fund GROMACS development, we humbly ask that you cite
  33  * the research papers on the package. Check out http://www.gromacs.org.
  34  */
  35 /*
  36    Copyright (C) 1999, 2002 Aladdin Enterprises.  All rights reserved.
  37
  38    This software is provided 'as-is', without any express or implied
  39    warranty.  In no event will the authors be held liable for any damages
  40    arising from the use of this software.
  41
  42    Permission is granted to anyone to use this software for any purpose,
  43    including commercial applications, and to alter it and redistribute it
  44    freely, subject to the following restrictions:
  45
  46    1. The origin of this software must not be misrepresented; you must not
  47      claim that you wrote the original software. If you use this software
  48      in a product, an acknowledgment in the product documentation would be
  49      appreciated but is not required.
  50    2. Altered source versions must be plainly marked as such, and must not be
  51      misrepresented as being the original software.
  52    3. This notice may not be removed or altered from any source distribution.
  53
  54    L. Peter Deutsch
  55    ghost@aladdin.com
  56
  57  */
  58 /*
  59    Independent implementation of MD5 (RFC 1321).
  60
  61    This code implements the MD5 Algorithm defined in RFC 1321, whose
  62    text is available at
  63     http://www.ietf.org/rfc/rfc1321.txt
  64    The code is derived from the text of the RFC, including the test suite
  65    (section A.5) but excluding the rest of Appendix A.  It does not include
  66    any code or documentation that is identified in the RFC as being
  67    copyrighted.
  68
  69    The original and principal author of md5.h is L. Peter Deutsch
  70    <ghost@aladdin.com>.  Other authors are noted in the change history
  71    that follows (in reverse chronological order):
  72
  73    2002-04-13 lpd Removed support for non-ANSI compilers; removed
  74     references to Ghostscript; clarified derivation from RFC 1321;
  75     now handles byte order either statically or dynamically.
  76    1999-11-04 lpd Edited comments slightly for automatic TOC extraction.
  77    1999-10-18 lpd Fixed typo in header comment (ansi2knr rather than md5);
  78     added conditionalization for C++ compilation from Martin
  79     Purschke <purschke@bnl.gov>.
  80    1999-05-03 lpd Original version.
  81  */
  82
  83 #ifndef md5_INCLUDED
  84 #  define md5_INCLUDED
  85
  86 /*
  87  * This package supports both compile-time and run-time determination of CPU
  88  * byte order.  If ARCH_IS_BIG_ENDIAN is defined as 0, the code will be
  89  * compiled to run only on little-endian CPUs; if ARCH_IS_BIG_ENDIAN is
  90  * defined as non-zero, the code will be compiled to run only on big-endian
  91  * CPUs; if ARCH_IS_BIG_ENDIAN is not defined, the code will be compiled to
  92  * run on either big- or little-endian CPUs, but will run slightly less
  93  * efficiently on either one than if ARCH_IS_BIG_ENDIAN is defined.
  94  */
  95
  96 typedef unsigned char md5_byte_t; /* 8-bit byte */
  97 typedef unsigned int md5_word_t;  /* 32-bit word */
  98
  99 /* Define the state of the MD5 Algorithm. */
 100 typedef struct md5_state_s {
 101     md5_word_t count[2];    /* message length in bits, lsw first */
 102     md5_word_t abcd[4];     /* digest buffer */
 103     md5_byte_t buf[64];     /* accumulate block */
 104 } md5_state_t;
 105
 106 #ifdef __cplusplus
 107 extern "C"
 108 {
 109 #endif
 110
 111 /* Initialize the algorithm. */
 112 void md5_init(md5_state_t *pms);
 113
 114 /* Append a string to the message. */
 115 void md5_append(md5_state_t *pms, const md5_byte_t *data, int nbytes);
 116
 117 /* Finish the message and return the digest. */
 118 void md5_finish(md5_state_t *pms, md5_byte_t digest[16]);
 119
 120 #ifdef __cplusplus
 121 }  /* end extern "C" */
 122 #endif
 123
 124 #endif /* md5_INCLUDED */