src/gromacs/fileio/md5.h

   1 /*
   2  * This file is part of the GROMACS molecular simulation package.
   3  *
   4  * Copyright (c) 2009,2010,2011,2014,2018,2019, by the GROMACS development team, led by
   5  * Mark Abraham, David van der Spoel, Berk Hess, and Erik Lindahl,
   6  * and including many others, as listed in the AUTHORS file in the
   7  * top-level source 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 /* This software has been altered by GROMACS for its use, including
  36  * the renaming of the functions md5_init, md5_append and md5_finish
  37  * to have a gmx_ prefix, and the #include guard md5_INCLUDED to have
  38  * a GMX_ prefix (both to avoid name clashes). */
  39 /*
  40    Copyright (C) 1999, 2000, 2002 Aladdin Enterprises.  All rights reserved.
  41
  42    This software is provided 'as-is', without any express or implied
  43    warranty.  In no event will the authors be held liable for any damages
  44    arising from the use of this software.
  45
  46    Permission is granted to anyone to use this software for any purpose,
  47    including commercial applications, and to alter it and redistribute it
  48    freely, subject to the following restrictions:
  49
  50    1. The origin of this software must not be misrepresented; you must not
  51      claim that you wrote the original software. If you use this software
  52      in a product, an acknowledgment in the product documentation would be
  53      appreciated but is not required.
  54    2. Altered source versions must be plainly marked as such, and must not be
  55      misrepresented as being the original software.
  56    3. This notice may not be removed or altered from any source distribution.
  57
  58    L. Peter Deutsch
  59    ghost@aladdin.com
  60
  61  */
  62 /*
  63    Independent implementation of MD5 (RFC 1321).
  64
  65    This code implements the MD5 Algorithm defined in RFC 1321, whose
  66    text is available at
  67     http://www.ietf.org/rfc/rfc1321.txt
  68    The code is derived from the text of the RFC, including the test suite
  69    (section A.5) but excluding the rest of Appendix A.  It does not include
  70    any code or documentation that is identified in the RFC as being
  71    copyrighted.
  72
  73    The original and principal author of md5.h is L. Peter Deutsch
  74    <ghost@aladdin.com>.  Other authors are noted in the change history
  75    that follows (in reverse chronological order):
  76
  77    2002-04-13 lpd Removed support for non-ANSI compilers; removed
  78     references to Ghostscript; clarified derivation from RFC 1321;
  79     now handles byte order either statically or dynamically.
  80    1999-11-04 lpd Edited comments slightly for automatic TOC extraction.
  81    1999-10-18 lpd Fixed typo in header comment (ansi2knr rather than md5);
  82     added conditionalization for C++ compilation from Martin
  83     Purschke <purschke@bnl.gov>.
  84    1999-05-03 lpd Original version.
  85  */
  86
  87 #ifndef GMX_md5_INCLUDED
  88 #define GMX_md5_INCLUDED
  89
  90 #include <array>
  91
  92 /*
  93  * This package supports both compile-time and run-time determination of CPU
  94  * byte order.  If ARCH_IS_BIG_ENDIAN is defined as 0, the code will be
  95  * compiled to run only on little-endian CPUs; if ARCH_IS_BIG_ENDIAN is
  96  * defined as non-zero, the code will be compiled to run only on big-endian
  97  * CPUs; if ARCH_IS_BIG_ENDIAN is not defined, the code will be compiled to
  98  * run on either big- or little-endian CPUs, but will run slightly less
  99  * efficiently on either one than if ARCH_IS_BIG_ENDIAN is defined.
 100  */
 101
 102 typedef unsigned char md5_byte_t; /* 8-bit byte */
 103 typedef unsigned int  md5_word_t; /* 32-bit word */
 104
 105 /* Define the state of the MD5 Algorithm. */
 106 typedef struct md5_state_s
 107 {
 108     md5_word_t count[2]; /* message length in bits, lsw first */
 109     md5_word_t abcd[4];  /* digest buffer */
 110     md5_byte_t buf[64];  /* accumulate block */
 111 } md5_state_t;
 112
 113 /* Initialize the algorithm. */
 114 void gmx_md5_init(md5_state_t* pms);
 115
 116 /* Append a string to the message. */
 117 void gmx_md5_append(md5_state_t* pms, const md5_byte_t* data, int nbytes);
 118
 119 /* Finish the message and return the digest. */
 120 std::array<unsigned char, 16> gmx_md5_finish(md5_state_t* pms);
 121
 122 #endif