47f5d0b9e59a0d52a6e15fccb4ea460ebe43f418
[vlc.git] / 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 #if !defined( __LIBVLC__ )
26   #error You are not libvlc or one of its plugins. You cannot include this file
27 #endif
28
29 #ifndef _VLC_MD5_H
30 # define _VLC_MD5_H
31
32 /*****************************************************************************
33  * md5_s: MD5 message structure
34  *****************************************************************************
35  * This structure stores the static information needed to compute an MD5
36  * hash. It has an extra data buffer to allow non-aligned writes.
37  *****************************************************************************/
38 struct md5_s
39 {
40     uint64_t i_bits;      /* Total written bits */
41     uint32_t p_digest[4]; /* The MD5 digest */
42     uint32_t p_data[16];  /* Buffer to cache non-aligned writes */
43 };
44
45 VLC_EXPORT(void, InitMD5, ( struct md5_s * ) );
46 VLC_EXPORT(void, AddMD5, ( struct md5_s *, const void *, size_t ) );
47 VLC_EXPORT(void, EndMD5, ( struct md5_s * ) );
48
49 /** 
50  * Returns a char representation of the md5 hash, as shown by UNIX md5 or
51  * md5sum tools.
52  */
53 static inline char * psz_md5_hash( struct md5_s *md5_s )
54 {
55     char *psz = malloc( 33 ); /* md5 string is 32 bytes + NULL character */
56     if( !psz ) return NULL;
57
58     int i;
59     for ( i = 0; i < 4; i++ )
60     {
61         sprintf( &psz[8*i], "%02x%02x%02x%02x",
62             md5_s->p_digest[i] & 0xff,
63             ( md5_s->p_digest[i] >> 8 ) & 0xff,
64             ( md5_s->p_digest[i] >> 16 ) & 0xff,
65             md5_s->p_digest[i] >> 24
66         );
67     }
68     psz[32] = '\0';
69
70     return psz;
71 }
72
73 #endif