md5.h

00001 /* Declaration of functions and data types used for MD5 sum computing
00002    library functions.
00003    Copyright (C) 1995, 1996, 1997 Free Software Foundation, Inc.
00004    This file is part of the GNU C Library.
00005 
00006    The GNU C Library is free software; you can redistribute it and/or
00007    modify it under the terms of the GNU Library General Public License as
00008    published by the Free Software Foundation; either version 2 of the
00009    License, or (at your option) any later version.
00010 
00011    The GNU C Library is distributed in the hope that it will be useful,
00012    but WITHOUT ANY WARRANTY; without even the implied warranty of
00013    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00014    Library General Public License for more details.
00015 
00016    You should have received a copy of the GNU Library General Public
00017    License along with the GNU C Library; see the file COPYING.LIB.  If not,
00018    write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
00019    Boston, MA 02111-1307, USA.  */
00020 
00021 #ifndef _MD5_H
00022 #define _MD5_H 1
00023 
00024 #include <stdio.h>
00025 
00026 #if defined HAVE_LIMITS_H || _LIBC
00027 # include <limits.h>
00028 #endif
00029 
00030 /* The following contortions are an attempt to use the C preprocessor
00031    to determine an unsigned integral type that is 32 bits wide.  An
00032    alternative approach is to use autoconf's AC_CHECK_SIZEOF macro, but
00033    doing that would require that the configure script compile and *run*
00034    the resulting executable.  Locally running cross-compiled executables
00035    is usually not possible.  */
00036 
00037 #ifdef _LIBC
00038 # include <sys/types.h>
00039 typedef u_int32_t md5_uint32;
00040 #else
00041 # if defined __STDC__ && __STDC__
00042 #  define UINT_MAX_32_BITS 4294967295U
00043 # else
00044 #  define UINT_MAX_32_BITS 0xFFFFFFFF
00045 # endif
00046 
00047 /* If UINT_MAX isn't defined, assume it's a 32-bit type.
00048    This should be valid for all systems GNU cares about because
00049    that doesn't include 16-bit systems, and only modern systems
00050    (that certainly have <limits.h>) have 64+-bit integral types.  */
00051 
00052 # ifndef UINT_MAX
00053 #  define UINT_MAX UINT_MAX_32_BITS
00054 # endif
00055 
00056 # if UINT_MAX == UINT_MAX_32_BITS
00057    typedef unsigned int md5_uint32;
00058 # else
00059 #  if USHRT_MAX == UINT_MAX_32_BITS
00060     typedef unsigned short md5_uint32;
00061 #  else
00062 #   if ULONG_MAX == UINT_MAX_32_BITS
00063      typedef unsigned long md5_uint32;
00064 #   else
00065      /* The following line is intended to evoke an error.
00066         Using #error is not portable enough.  */
00067      "Cannot determine unsigned 32-bit data type."
00068 #   endif
00069 #  endif
00070 # endif
00071 #endif
00072 
00073 #undef __P
00074 #if defined (__STDC__) && __STDC__
00075 # define __P(x) x
00076 #else
00077 # define __P(x) ()
00078 #endif
00079 
00080 /* Structure to save state of computation between the single steps.  */
00081 struct md5_ctx
00082 {
00083   md5_uint32 A;
00084   md5_uint32 B;
00085   md5_uint32 C;
00086   md5_uint32 D;
00087 
00088   md5_uint32 total[2];
00089   md5_uint32 buflen;
00090   char buffer[128];
00091 };
00092 
00093 /*
00094  * The following three functions are build up the low level used in
00095  * the functions `md5_stream' and `md5_buffer'.
00096  */
00097 
00098 /* Initialize structure containing state of computation.
00099    (RFC 1321, 3.3: Step 3)  */
00100 extern void __md5_init_ctx __P ((struct md5_ctx *ctx));
00101 extern void md5_init_ctx __P ((struct md5_ctx *ctx));
00102 
00103 /* Starting with the result of former calls of this function (or the
00104    initialization function update the context for the next LEN bytes
00105    starting at BUFFER.
00106    It is necessary that LEN is a multiple of 64!!! */
00107 extern void __md5_process_block __P ((const void *buffer, size_t len,
00108                                       struct md5_ctx *ctx));
00109 extern void md5_process_block __P ((const void *buffer, size_t len,
00110                                     struct md5_ctx *ctx));
00111 
00112 /* Starting with the result of former calls of this function (or the
00113    initialization function update the context for the next LEN bytes
00114    starting at BUFFER.
00115    It is NOT required that LEN is a multiple of 64.  */
00116 extern void __md5_process_bytes __P ((const void *buffer, size_t len,
00117                                       struct md5_ctx *ctx));
00118 extern void md5_process_bytes __P ((const void *buffer, size_t len,
00119                                     struct md5_ctx *ctx));
00120 
00121 /* Process the remaining bytes in the buffer and put result from CTX
00122    in first 16 bytes following RESBUF.  The result is always in little
00123    endian byte order, so that a byte-wise output yields to the wanted
00124    ASCII representation of the message digest.
00125 
00126    IMPORTANT: On some systems it is required that RESBUF is correctly
00127    aligned for a 32 bits value.  */
00128 extern void *__md5_finish_ctx __P ((struct md5_ctx *ctx, void *resbuf));
00129 extern void *md5_finish_ctx __P ((struct md5_ctx *ctx, void *resbuf));
00130 
00131 
00132 /* Put result from CTX in first 16 bytes following RESBUF.  The result is
00133    always in little endian byte order, so that a byte-wise output yields
00134    to the wanted ASCII representation of the message digest.
00135 
00136    IMPORTANT: On some systems it is required that RESBUF is correctly
00137    aligned for a 32 bits value.  */
00138 extern void *__md5_read_ctx __P ((const struct md5_ctx *ctx, void *resbuf));
00139 extern void *md5_read_ctx __P ((const struct md5_ctx *ctx, void *resbuf));
00140 
00141 
00142 /* Compute MD5 message digest for bytes read from STREAM.  The
00143    resulting message digest number will be written into the 16 bytes
00144    beginning at RESBLOCK.  */
00145 extern int __md5_stream __P ((FILE *stream, void *resblock));
00146 
00147 /* Compute MD5 message digest for LEN bytes beginning at BUFFER.  The
00148    result is always in little endian byte order, so that a byte-wise
00149    output yields to the wanted ASCII representation of the message
00150    digest.  */
00151 extern void *__md5_buffer __P ((const char *buffer, size_t len,
00152                                 void *resblock));
00153 extern void *md5_buffer __P ((const char *buffer, size_t len,
00154                               void *resblock));
00155 
00156 #endif /* md5.h */

Generated on Thu Feb 19 11:11:50 2009 for bglibs by  doxygen 1.5.4