include/vlc_md5.h

   1 /*****************************************************************************
   2  * vlc_md5.h: MD5 hash
   3  *****************************************************************************
   4  * Copyright (C) 2004-2005 the VideoLAN team
   5  * $Id$
   6  *
   7  * Authors: Jon Lech Johansen <jon-vl@nanocrew.net>
   8  *          Sam Hocevar <sam@zoy.org>
   9  *
  10  * This program is free software; you can redistribute it and/or modify
  11  * it under the terms of the GNU General Public License as published by
  12  * the Free Software Foundation; either version 2 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License
  21  * along with this program; if not, write to the Free Software
  22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  23  *****************************************************************************/
  24
  25 #ifndef VLC_MD5_H
  26 # define VLC_MD5_H
  27
  28 /**
  29  * \file
  30  * This file defines functions and structures for handling md5 checksums
  31  */
  32
  33 /*****************************************************************************
  34  * md5_s: MD5 message structure
  35  *****************************************************************************
  36  * This structure stores the static information needed to compute an MD5
  37  * hash. It has an extra data buffer to allow non-aligned writes.
  38  *****************************************************************************/
  39 struct md5_s
  40 {
  41     uint64_t i_bits;      /* Total written bits */
  42     uint32_t p_digest[4]; /* The MD5 digest */
  43     uint32_t p_data[16];  /* Buffer to cache non-aligned writes */
  44 };
  45
  46 VLC_API void InitMD5( struct md5_s * );
  47 VLC_API void AddMD5( struct md5_s *, const void *, size_t );
  48 VLC_API void EndMD5( struct md5_s * );
  49
  50 /**
  51  * Returns a char representation of the md5 hash, as shown by UNIX md5 or
  52  * md5sum tools.
  53  */
  54 static inline char * psz_md5_hash( struct md5_s *md5_s )
  55 {
  56     char *psz = malloc( 33 ); /* md5 string is 32 bytes + NULL character */
  57     if( !psz ) return NULL;
  58
  59     int i;
  60     for ( i = 0; i < 4; i++ )
  61     {
  62         sprintf( &psz[8*i], "%02x%02x%02x%02x",
  63             md5_s->p_digest[i] & 0xff,
  64             ( md5_s->p_digest[i] >> 8 ) & 0xff,
  65             ( md5_s->p_digest[i] >> 16 ) & 0xff,
  66             md5_s->p_digest[i] >> 24
  67         );
  68     }
  69     psz[32] = '\0';
  70
  71     return psz;
  72 }
  73
  74 #endif