mbed TLS library
Dependents: HTTPClient-SSL WS_SERVER
md5.h
00001 /** 00002 * \file md5.h 00003 * 00004 * \brief MD5 message digest algorithm (hash function) 00005 * 00006 * Copyright (C) 2006-2013, ARM Limited, All Rights Reserved 00007 * 00008 * This file is part of mbed TLS (https://tls.mbed.org) 00009 * 00010 * This program is free software; you can redistribute it and/or modify 00011 * it under the terms of the GNU General Public License as published by 00012 * the Free Software Foundation; either version 2 of the License, or 00013 * (at your option) any later version. 00014 * 00015 * This program is distributed in the hope that it will be useful, 00016 * but WITHOUT ANY WARRANTY; without even the implied warranty of 00017 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 00018 * GNU General Public License for more details. 00019 * 00020 * You should have received a copy of the GNU General Public License along 00021 * with this program; if not, write to the Free Software Foundation, Inc., 00022 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. 00023 */ 00024 #ifndef POLARSSL_MD5_H 00025 #define POLARSSL_MD5_H 00026 00027 #if !defined(POLARSSL_CONFIG_FILE) 00028 #include "config.h" 00029 #else 00030 #include POLARSSL_CONFIG_FILE 00031 #endif 00032 00033 #include <stddef.h> 00034 00035 #if defined(_MSC_VER) && !defined(EFIX64) && !defined(EFI32) 00036 #include <basetsd.h> 00037 typedef UINT32 uint32_t; 00038 #else 00039 #include <inttypes.h> 00040 #endif 00041 00042 #define POLARSSL_ERR_MD5_FILE_IO_ERROR -0x0074 /**< Read/write error in file. */ 00043 00044 #if !defined(POLARSSL_MD5_ALT) 00045 // Regular implementation 00046 // 00047 00048 #ifdef __cplusplus 00049 extern "C" { 00050 #endif 00051 00052 /** 00053 * \brief MD5 context structure 00054 */ 00055 typedef struct 00056 { 00057 uint32_t total[2]; /*!< number of bytes processed */ 00058 uint32_t state[4]; /*!< intermediate digest state */ 00059 unsigned char buffer[64]; /*!< data block being processed */ 00060 00061 unsigned char ipad[64]; /*!< HMAC: inner padding */ 00062 unsigned char opad[64]; /*!< HMAC: outer padding */ 00063 } 00064 md5_context; 00065 00066 /** 00067 * \brief Initialize MD5 context 00068 * 00069 * \param ctx MD5 context to be initialized 00070 */ 00071 void md5_init( md5_context *ctx ); 00072 00073 /** 00074 * \brief Clear MD5 context 00075 * 00076 * \param ctx MD5 context to be cleared 00077 */ 00078 void md5_free( md5_context *ctx ); 00079 00080 /** 00081 * \brief MD5 context setup 00082 * 00083 * \param ctx context to be initialized 00084 */ 00085 void md5_starts( md5_context *ctx ); 00086 00087 /** 00088 * \brief MD5 process buffer 00089 * 00090 * \param ctx MD5 context 00091 * \param input buffer holding the data 00092 * \param ilen length of the input data 00093 */ 00094 void md5_update( md5_context *ctx, const unsigned char *input, size_t ilen ); 00095 00096 /** 00097 * \brief MD5 final digest 00098 * 00099 * \param ctx MD5 context 00100 * \param output MD5 checksum result 00101 */ 00102 void md5_finish( md5_context *ctx, unsigned char output[16] ); 00103 00104 /* Internal use */ 00105 void md5_process( md5_context *ctx, const unsigned char data[64] ); 00106 00107 #ifdef __cplusplus 00108 } 00109 #endif 00110 00111 #else /* POLARSSL_MD5_ALT */ 00112 #include "md5_alt.h" 00113 #endif /* POLARSSL_MD5_ALT */ 00114 00115 #ifdef __cplusplus 00116 extern "C" { 00117 #endif 00118 00119 /** 00120 * \brief Output = MD5( input buffer ) 00121 * 00122 * \param input buffer holding the data 00123 * \param ilen length of the input data 00124 * \param output MD5 checksum result 00125 */ 00126 void md5( const unsigned char *input, size_t ilen, unsigned char output[16] ); 00127 00128 /** 00129 * \brief Output = MD5( file contents ) 00130 * 00131 * \param path input file name 00132 * \param output MD5 checksum result 00133 * 00134 * \return 0 if successful, or POLARSSL_ERR_MD5_FILE_IO_ERROR 00135 */ 00136 int md5_file( const char *path, unsigned char output[16] ); 00137 00138 /** 00139 * \brief MD5 HMAC context setup 00140 * 00141 * \param ctx HMAC context to be initialized 00142 * \param key HMAC secret key 00143 * \param keylen length of the HMAC key 00144 */ 00145 void md5_hmac_starts( md5_context *ctx, 00146 const unsigned char *key, size_t keylen ); 00147 00148 /** 00149 * \brief MD5 HMAC process buffer 00150 * 00151 * \param ctx HMAC context 00152 * \param input buffer holding the data 00153 * \param ilen length of the input data 00154 */ 00155 void md5_hmac_update( md5_context *ctx, 00156 const unsigned char *input, size_t ilen ); 00157 00158 /** 00159 * \brief MD5 HMAC final digest 00160 * 00161 * \param ctx HMAC context 00162 * \param output MD5 HMAC checksum result 00163 */ 00164 void md5_hmac_finish( md5_context *ctx, unsigned char output[16] ); 00165 00166 /** 00167 * \brief MD5 HMAC context reset 00168 * 00169 * \param ctx HMAC context to be reset 00170 */ 00171 void md5_hmac_reset( md5_context *ctx ); 00172 00173 /** 00174 * \brief Output = HMAC-MD5( hmac key, input buffer ) 00175 * 00176 * \param key HMAC secret key 00177 * \param keylen length of the HMAC key 00178 * \param input buffer holding the data 00179 * \param ilen length of the input data 00180 * \param output HMAC-MD5 result 00181 */ 00182 void md5_hmac( const unsigned char *key, size_t keylen, 00183 const unsigned char *input, size_t ilen, 00184 unsigned char output[16] ); 00185 00186 /** 00187 * \brief Checkup routine 00188 * 00189 * \return 0 if successful, or 1 if the test failed 00190 */ 00191 int md5_self_test( int verbose ); 00192 00193 #ifdef __cplusplus 00194 } 00195 #endif 00196 00197 #endif /* md5.h */ 00198
Generated on Tue Jul 12 2022 13:50:37 by 1.7.2