David Fletcher / Mbed 2 deprecated cc3100_Test_websock_Camera_CM3

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependencies:   mbed

SHA1/polarssl/md.h@0:400d8e75a8d0, 2015-09-06 (annotated)

Committer:
dflet
Date:
Sun Sep 06 15:19:36 2015 +0000
Revision:
0:400d8e75a8d0
TI's websocket Camera demo, also uses Arducam mini 0v5642 camera.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dflet 0:400d8e75a8d0 1 /**
dflet 0:400d8e75a8d0 2 * \file md.h
dflet 0:400d8e75a8d0 3 *
dflet 0:400d8e75a8d0 4 * \brief Generic message digest wrapper
dflet 0:400d8e75a8d0 5 *
dflet 0:400d8e75a8d0 6 * \author Adriaan de Jong <dejong@fox-it.com>
dflet 0:400d8e75a8d0 7 *
dflet 0:400d8e75a8d0 8 * Copyright (C) 2006-2014, ARM Limited, All Rights Reserved
dflet 0:400d8e75a8d0 9 *
dflet 0:400d8e75a8d0 10 * This file is part of mbed TLS (https://tls.mbed.org)
dflet 0:400d8e75a8d0 11 *
dflet 0:400d8e75a8d0 12 * This program is free software; you can redistribute it and/or modify
dflet 0:400d8e75a8d0 13 * it under the terms of the GNU General Public License as published by
dflet 0:400d8e75a8d0 14 * the Free Software Foundation; either version 2 of the License, or
dflet 0:400d8e75a8d0 15 * (at your option) any later version.
dflet 0:400d8e75a8d0 16 *
dflet 0:400d8e75a8d0 17 * This program is distributed in the hope that it will be useful,
dflet 0:400d8e75a8d0 18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
dflet 0:400d8e75a8d0 19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
dflet 0:400d8e75a8d0 20 * GNU General Public License for more details.
dflet 0:400d8e75a8d0 21 *
dflet 0:400d8e75a8d0 22 * You should have received a copy of the GNU General Public License along
dflet 0:400d8e75a8d0 23 * with this program; if not, write to the Free Software Foundation, Inc.,
dflet 0:400d8e75a8d0 24 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
dflet 0:400d8e75a8d0 25 */
dflet 0:400d8e75a8d0 26 #ifndef POLARSSL_MD_H
dflet 0:400d8e75a8d0 27 #define POLARSSL_MD_H
dflet 0:400d8e75a8d0 28
dflet 0:400d8e75a8d0 29 #include <stddef.h>
dflet 0:400d8e75a8d0 30
dflet 0:400d8e75a8d0 31 #if defined(_MSC_VER) && !defined(inline)
dflet 0:400d8e75a8d0 32 #define inline _inline
dflet 0:400d8e75a8d0 33 #else
dflet 0:400d8e75a8d0 34 #if defined(__ARMCC_VERSION) && !defined(inline)
dflet 0:400d8e75a8d0 35 #define inline __inline
dflet 0:400d8e75a8d0 36 #endif /* __ARMCC_VERSION */
dflet 0:400d8e75a8d0 37 #endif /*_MSC_VER */
dflet 0:400d8e75a8d0 38
dflet 0:400d8e75a8d0 39 #define POLARSSL_ERR_MD_FEATURE_UNAVAILABLE -0x5080 /**< The selected feature is not available. */
dflet 0:400d8e75a8d0 40 #define POLARSSL_ERR_MD_BAD_INPUT_DATA -0x5100 /**< Bad input parameters to function. */
dflet 0:400d8e75a8d0 41 #define POLARSSL_ERR_MD_ALLOC_FAILED -0x5180 /**< Failed to allocate memory. */
dflet 0:400d8e75a8d0 42 #define POLARSSL_ERR_MD_FILE_IO_ERROR -0x5200 /**< Opening or reading of file failed. */
dflet 0:400d8e75a8d0 43
dflet 0:400d8e75a8d0 44 #ifdef __cplusplus
dflet 0:400d8e75a8d0 45 extern "C" {
dflet 0:400d8e75a8d0 46 #endif
dflet 0:400d8e75a8d0 47
dflet 0:400d8e75a8d0 48 typedef enum {
dflet 0:400d8e75a8d0 49 POLARSSL_MD_NONE=0,
dflet 0:400d8e75a8d0 50 POLARSSL_MD_MD2,
dflet 0:400d8e75a8d0 51 POLARSSL_MD_MD4,
dflet 0:400d8e75a8d0 52 POLARSSL_MD_MD5,
dflet 0:400d8e75a8d0 53 POLARSSL_MD_SHA1,
dflet 0:400d8e75a8d0 54 POLARSSL_MD_SHA224,
dflet 0:400d8e75a8d0 55 POLARSSL_MD_SHA256,
dflet 0:400d8e75a8d0 56 POLARSSL_MD_SHA384,
dflet 0:400d8e75a8d0 57 POLARSSL_MD_SHA512,
dflet 0:400d8e75a8d0 58 POLARSSL_MD_RIPEMD160,
dflet 0:400d8e75a8d0 59 } md_type_t;
dflet 0:400d8e75a8d0 60
dflet 0:400d8e75a8d0 61 #if defined(POLARSSL_SHA512_C)
dflet 0:400d8e75a8d0 62 #define POLARSSL_MD_MAX_SIZE 64 /* longest known is SHA512 */
dflet 0:400d8e75a8d0 63 #else
dflet 0:400d8e75a8d0 64 #define POLARSSL_MD_MAX_SIZE 32 /* longest known is SHA256 or less */
dflet 0:400d8e75a8d0 65 #endif
dflet 0:400d8e75a8d0 66
dflet 0:400d8e75a8d0 67 /**
dflet 0:400d8e75a8d0 68 * Message digest information. Allows message digest functions to be called
dflet 0:400d8e75a8d0 69 * in a generic way.
dflet 0:400d8e75a8d0 70 */
dflet 0:400d8e75a8d0 71 typedef struct {
dflet 0:400d8e75a8d0 72 /** Digest identifier */
dflet 0:400d8e75a8d0 73 md_type_t type;
dflet 0:400d8e75a8d0 74
dflet 0:400d8e75a8d0 75 /** Name of the message digest */
dflet 0:400d8e75a8d0 76 const char * name;
dflet 0:400d8e75a8d0 77
dflet 0:400d8e75a8d0 78 /** Output length of the digest function */
dflet 0:400d8e75a8d0 79 int size;
dflet 0:400d8e75a8d0 80
dflet 0:400d8e75a8d0 81 /** Digest initialisation function */
dflet 0:400d8e75a8d0 82 void (*starts_func)( void *ctx );
dflet 0:400d8e75a8d0 83
dflet 0:400d8e75a8d0 84 /** Digest update function */
dflet 0:400d8e75a8d0 85 void (*update_func)( void *ctx, const unsigned char *input, size_t ilen );
dflet 0:400d8e75a8d0 86
dflet 0:400d8e75a8d0 87 /** Digest finalisation function */
dflet 0:400d8e75a8d0 88 void (*finish_func)( void *ctx, unsigned char *output );
dflet 0:400d8e75a8d0 89
dflet 0:400d8e75a8d0 90 /** Generic digest function */
dflet 0:400d8e75a8d0 91 void (*digest_func)( const unsigned char *input, size_t ilen,
dflet 0:400d8e75a8d0 92 unsigned char *output );
dflet 0:400d8e75a8d0 93
dflet 0:400d8e75a8d0 94 /** Generic file digest function */
dflet 0:400d8e75a8d0 95 int (*file_func)( const char *path, unsigned char *output );
dflet 0:400d8e75a8d0 96
dflet 0:400d8e75a8d0 97 /** HMAC Initialisation function */
dflet 0:400d8e75a8d0 98 void (*hmac_starts_func)( void *ctx, const unsigned char *key,
dflet 0:400d8e75a8d0 99 size_t keylen );
dflet 0:400d8e75a8d0 100
dflet 0:400d8e75a8d0 101 /** HMAC update function */
dflet 0:400d8e75a8d0 102 void (*hmac_update_func)( void *ctx, const unsigned char *input,
dflet 0:400d8e75a8d0 103 size_t ilen );
dflet 0:400d8e75a8d0 104
dflet 0:400d8e75a8d0 105 /** HMAC finalisation function */
dflet 0:400d8e75a8d0 106 void (*hmac_finish_func)( void *ctx, unsigned char *output);
dflet 0:400d8e75a8d0 107
dflet 0:400d8e75a8d0 108 /** HMAC context reset function */
dflet 0:400d8e75a8d0 109 void (*hmac_reset_func)( void *ctx );
dflet 0:400d8e75a8d0 110
dflet 0:400d8e75a8d0 111 /** Generic HMAC function */
dflet 0:400d8e75a8d0 112 void (*hmac_func)( const unsigned char *key, size_t keylen,
dflet 0:400d8e75a8d0 113 const unsigned char *input, size_t ilen,
dflet 0:400d8e75a8d0 114 unsigned char *output );
dflet 0:400d8e75a8d0 115
dflet 0:400d8e75a8d0 116 /** Allocate a new context */
dflet 0:400d8e75a8d0 117 void * (*ctx_alloc_func)( void );
dflet 0:400d8e75a8d0 118
dflet 0:400d8e75a8d0 119 /** Free the given context */
dflet 0:400d8e75a8d0 120 void (*ctx_free_func)( void *ctx );
dflet 0:400d8e75a8d0 121
dflet 0:400d8e75a8d0 122 /** Internal use only */
dflet 0:400d8e75a8d0 123 void (*process_func)( void *ctx, const unsigned char *input );
dflet 0:400d8e75a8d0 124 } md_info_t;
dflet 0:400d8e75a8d0 125
dflet 0:400d8e75a8d0 126 /**
dflet 0:400d8e75a8d0 127 * Generic message digest context.
dflet 0:400d8e75a8d0 128 */
dflet 0:400d8e75a8d0 129 typedef struct {
dflet 0:400d8e75a8d0 130 /** Information about the associated message digest */
dflet 0:400d8e75a8d0 131 const md_info_t *md_info;
dflet 0:400d8e75a8d0 132
dflet 0:400d8e75a8d0 133 /** Digest-specific context */
dflet 0:400d8e75a8d0 134 void *md_ctx;
dflet 0:400d8e75a8d0 135 } md_context_t;
dflet 0:400d8e75a8d0 136
dflet 0:400d8e75a8d0 137 #define MD_CONTEXT_T_INIT { \
dflet 0:400d8e75a8d0 138 NULL, /* md_info */ \
dflet 0:400d8e75a8d0 139 NULL, /* md_ctx */ \
dflet 0:400d8e75a8d0 140 }
dflet 0:400d8e75a8d0 141
dflet 0:400d8e75a8d0 142 /**
dflet 0:400d8e75a8d0 143 * \brief Returns the list of digests supported by the generic digest module.
dflet 0:400d8e75a8d0 144 *
dflet 0:400d8e75a8d0 145 * \return a statically allocated array of digests, the last entry
dflet 0:400d8e75a8d0 146 * is 0.
dflet 0:400d8e75a8d0 147 */
dflet 0:400d8e75a8d0 148 const int *md_list( void );
dflet 0:400d8e75a8d0 149
dflet 0:400d8e75a8d0 150 /**
dflet 0:400d8e75a8d0 151 * \brief Returns the message digest information associated with the
dflet 0:400d8e75a8d0 152 * given digest name.
dflet 0:400d8e75a8d0 153 *
dflet 0:400d8e75a8d0 154 * \param md_name Name of the digest to search for.
dflet 0:400d8e75a8d0 155 *
dflet 0:400d8e75a8d0 156 * \return The message digest information associated with md_name or
dflet 0:400d8e75a8d0 157 * NULL if not found.
dflet 0:400d8e75a8d0 158 */
dflet 0:400d8e75a8d0 159 const md_info_t *md_info_from_string( const char *md_name );
dflet 0:400d8e75a8d0 160
dflet 0:400d8e75a8d0 161 /**
dflet 0:400d8e75a8d0 162 * \brief Returns the message digest information associated with the
dflet 0:400d8e75a8d0 163 * given digest type.
dflet 0:400d8e75a8d0 164 *
dflet 0:400d8e75a8d0 165 * \param md_type type of digest to search for.
dflet 0:400d8e75a8d0 166 *
dflet 0:400d8e75a8d0 167 * \return The message digest information associated with md_type or
dflet 0:400d8e75a8d0 168 * NULL if not found.
dflet 0:400d8e75a8d0 169 */
dflet 0:400d8e75a8d0 170 const md_info_t *md_info_from_type( md_type_t md_type );
dflet 0:400d8e75a8d0 171
dflet 0:400d8e75a8d0 172 /**
dflet 0:400d8e75a8d0 173 * \brief Initialize a md_context (as NONE)
dflet 0:400d8e75a8d0 174 */
dflet 0:400d8e75a8d0 175 void md_init( md_context_t *ctx );
dflet 0:400d8e75a8d0 176
dflet 0:400d8e75a8d0 177 /**
dflet 0:400d8e75a8d0 178 * \brief Free and clear the message-specific context of ctx.
dflet 0:400d8e75a8d0 179 * Freeing ctx itself remains the responsibility of the
dflet 0:400d8e75a8d0 180 * caller.
dflet 0:400d8e75a8d0 181 */
dflet 0:400d8e75a8d0 182 void md_free( md_context_t *ctx );
dflet 0:400d8e75a8d0 183
dflet 0:400d8e75a8d0 184 /**
dflet 0:400d8e75a8d0 185 * \brief Initialises and fills the message digest context structure
dflet 0:400d8e75a8d0 186 * with the appropriate values.
dflet 0:400d8e75a8d0 187 *
dflet 0:400d8e75a8d0 188 * \note Currently also clears structure. In future versions you
dflet 0:400d8e75a8d0 189 * will be required to call md_init() on the structure
dflet 0:400d8e75a8d0 190 * first.
dflet 0:400d8e75a8d0 191 *
dflet 0:400d8e75a8d0 192 * \param ctx context to initialise. May not be NULL. The
dflet 0:400d8e75a8d0 193 * digest-specific context (ctx->md_ctx) must be NULL. It will
dflet 0:400d8e75a8d0 194 * be allocated, and must be freed using md_free_ctx() later.
dflet 0:400d8e75a8d0 195 * \param md_info message digest to use.
dflet 0:400d8e75a8d0 196 *
dflet 0:400d8e75a8d0 197 * \returns \c 0 on success, \c POLARSSL_ERR_MD_BAD_INPUT_DATA on
dflet 0:400d8e75a8d0 198 * parameter failure, \c POLARSSL_ERR_MD_ALLOC_FAILED if
dflet 0:400d8e75a8d0 199 * allocation of the digest-specific context failed.
dflet 0:400d8e75a8d0 200 */
dflet 0:400d8e75a8d0 201 int md_init_ctx( md_context_t *ctx, const md_info_t *md_info );
dflet 0:400d8e75a8d0 202
dflet 0:400d8e75a8d0 203 #if ! defined(POLARSSL_DEPRECATED_REMOVED)
dflet 0:400d8e75a8d0 204 #if defined(POLARSSL_DEPRECATED_WARNING)
dflet 0:400d8e75a8d0 205 #define DEPRECATED __attribute__((deprecated))
dflet 0:400d8e75a8d0 206 #else
dflet 0:400d8e75a8d0 207 #define DEPRECATED
dflet 0:400d8e75a8d0 208 #endif
dflet 0:400d8e75a8d0 209 /**
dflet 0:400d8e75a8d0 210 * \brief Free the message-specific context of ctx. Freeing ctx itself
dflet 0:400d8e75a8d0 211 * remains the responsibility of the caller.
dflet 0:400d8e75a8d0 212 *
dflet 0:400d8e75a8d0 213 * \deprecated Use md_free() instead
dflet 0:400d8e75a8d0 214 *
dflet 0:400d8e75a8d0 215 * \param ctx Free the message-specific context
dflet 0:400d8e75a8d0 216 *
dflet 0:400d8e75a8d0 217 * \returns 0
dflet 0:400d8e75a8d0 218 */
dflet 0:400d8e75a8d0 219 int md_free_ctx( md_context_t *ctx ) DEPRECATED;
dflet 0:400d8e75a8d0 220 #undef DEPRECATED
dflet 0:400d8e75a8d0 221 #endif /* POLARSSL_DEPRECATED_REMOVED */
dflet 0:400d8e75a8d0 222
dflet 0:400d8e75a8d0 223 /**
dflet 0:400d8e75a8d0 224 * \brief Returns the size of the message digest output.
dflet 0:400d8e75a8d0 225 *
dflet 0:400d8e75a8d0 226 * \param md_info message digest info
dflet 0:400d8e75a8d0 227 *
dflet 0:400d8e75a8d0 228 * \return size of the message digest output.
dflet 0:400d8e75a8d0 229 */
dflet 0:400d8e75a8d0 230 static inline unsigned char md_get_size( const md_info_t *md_info )
dflet 0:400d8e75a8d0 231 {
dflet 0:400d8e75a8d0 232 if( md_info == NULL )
dflet 0:400d8e75a8d0 233 return( 0 );
dflet 0:400d8e75a8d0 234
dflet 0:400d8e75a8d0 235 return md_info->size;
dflet 0:400d8e75a8d0 236 }
dflet 0:400d8e75a8d0 237
dflet 0:400d8e75a8d0 238 /**
dflet 0:400d8e75a8d0 239 * \brief Returns the type of the message digest output.
dflet 0:400d8e75a8d0 240 *
dflet 0:400d8e75a8d0 241 * \param md_info message digest info
dflet 0:400d8e75a8d0 242 *
dflet 0:400d8e75a8d0 243 * \return type of the message digest output.
dflet 0:400d8e75a8d0 244 */
dflet 0:400d8e75a8d0 245 static inline md_type_t md_get_type( const md_info_t *md_info )
dflet 0:400d8e75a8d0 246 {
dflet 0:400d8e75a8d0 247 if( md_info == NULL )
dflet 0:400d8e75a8d0 248 return( POLARSSL_MD_NONE );
dflet 0:400d8e75a8d0 249
dflet 0:400d8e75a8d0 250 return md_info->type;
dflet 0:400d8e75a8d0 251 }
dflet 0:400d8e75a8d0 252
dflet 0:400d8e75a8d0 253 /**
dflet 0:400d8e75a8d0 254 * \brief Returns the name of the message digest output.
dflet 0:400d8e75a8d0 255 *
dflet 0:400d8e75a8d0 256 * \param md_info message digest info
dflet 0:400d8e75a8d0 257 *
dflet 0:400d8e75a8d0 258 * \return name of the message digest output.
dflet 0:400d8e75a8d0 259 */
dflet 0:400d8e75a8d0 260 static inline const char *md_get_name( const md_info_t *md_info )
dflet 0:400d8e75a8d0 261 {
dflet 0:400d8e75a8d0 262 if( md_info == NULL )
dflet 0:400d8e75a8d0 263 return( NULL );
dflet 0:400d8e75a8d0 264
dflet 0:400d8e75a8d0 265 return md_info->name;
dflet 0:400d8e75a8d0 266 }
dflet 0:400d8e75a8d0 267
dflet 0:400d8e75a8d0 268 /**
dflet 0:400d8e75a8d0 269 * \brief Set-up the given context for a new message digest
dflet 0:400d8e75a8d0 270 *
dflet 0:400d8e75a8d0 271 * \param ctx generic message digest context.
dflet 0:400d8e75a8d0 272 *
dflet 0:400d8e75a8d0 273 * \returns 0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter
dflet 0:400d8e75a8d0 274 * verification fails.
dflet 0:400d8e75a8d0 275 */
dflet 0:400d8e75a8d0 276 int md_starts( md_context_t *ctx );
dflet 0:400d8e75a8d0 277
dflet 0:400d8e75a8d0 278 /**
dflet 0:400d8e75a8d0 279 * \brief Generic message digest process buffer
dflet 0:400d8e75a8d0 280 *
dflet 0:400d8e75a8d0 281 * \param ctx Generic message digest context
dflet 0:400d8e75a8d0 282 * \param input buffer holding the datal
dflet 0:400d8e75a8d0 283 * \param ilen length of the input data
dflet 0:400d8e75a8d0 284 *
dflet 0:400d8e75a8d0 285 * \returns 0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter
dflet 0:400d8e75a8d0 286 * verification fails.
dflet 0:400d8e75a8d0 287 */
dflet 0:400d8e75a8d0 288 int md_update( md_context_t *ctx, const unsigned char *input, size_t ilen );
dflet 0:400d8e75a8d0 289
dflet 0:400d8e75a8d0 290 /**
dflet 0:400d8e75a8d0 291 * \brief Generic message digest final digest
dflet 0:400d8e75a8d0 292 *
dflet 0:400d8e75a8d0 293 * \param ctx Generic message digest context
dflet 0:400d8e75a8d0 294 * \param output Generic message digest checksum result
dflet 0:400d8e75a8d0 295 *
dflet 0:400d8e75a8d0 296 * \returns 0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter
dflet 0:400d8e75a8d0 297 * verification fails.
dflet 0:400d8e75a8d0 298 */
dflet 0:400d8e75a8d0 299 int md_finish( md_context_t *ctx, unsigned char *output );
dflet 0:400d8e75a8d0 300
dflet 0:400d8e75a8d0 301 /**
dflet 0:400d8e75a8d0 302 * \brief Output = message_digest( input buffer )
dflet 0:400d8e75a8d0 303 *
dflet 0:400d8e75a8d0 304 * \param md_info message digest info
dflet 0:400d8e75a8d0 305 * \param input buffer holding the data
dflet 0:400d8e75a8d0 306 * \param ilen length of the input data
dflet 0:400d8e75a8d0 307 * \param output Generic message digest checksum result
dflet 0:400d8e75a8d0 308 *
dflet 0:400d8e75a8d0 309 * \returns 0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter
dflet 0:400d8e75a8d0 310 * verification fails.
dflet 0:400d8e75a8d0 311 */
dflet 0:400d8e75a8d0 312 int md( const md_info_t *md_info, const unsigned char *input, size_t ilen,
dflet 0:400d8e75a8d0 313 unsigned char *output );
dflet 0:400d8e75a8d0 314
dflet 0:400d8e75a8d0 315 /**
dflet 0:400d8e75a8d0 316 * \brief Output = message_digest( file contents )
dflet 0:400d8e75a8d0 317 *
dflet 0:400d8e75a8d0 318 * \param md_info message digest info
dflet 0:400d8e75a8d0 319 * \param path input file name
dflet 0:400d8e75a8d0 320 * \param output generic message digest checksum result
dflet 0:400d8e75a8d0 321 *
dflet 0:400d8e75a8d0 322 * \return 0 if successful, POLARSSL_ERR_MD_FILE_OPEN_FAILED if fopen
dflet 0:400d8e75a8d0 323 * failed, POLARSSL_ERR_MD_FILE_READ_FAILED if fread failed,
dflet 0:400d8e75a8d0 324 * POLARSSL_ERR_MD_BAD_INPUT_DATA if md_info was NULL.
dflet 0:400d8e75a8d0 325 */
dflet 0:400d8e75a8d0 326 int md_file( const md_info_t *md_info, const char *path,
dflet 0:400d8e75a8d0 327 unsigned char *output );
dflet 0:400d8e75a8d0 328
dflet 0:400d8e75a8d0 329 /**
dflet 0:400d8e75a8d0 330 * \brief Generic HMAC context setup
dflet 0:400d8e75a8d0 331 *
dflet 0:400d8e75a8d0 332 * \param ctx HMAC context to be initialized
dflet 0:400d8e75a8d0 333 * \param key HMAC secret key
dflet 0:400d8e75a8d0 334 * \param keylen length of the HMAC key
dflet 0:400d8e75a8d0 335 *
dflet 0:400d8e75a8d0 336 * \returns 0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter
dflet 0:400d8e75a8d0 337 * verification fails.
dflet 0:400d8e75a8d0 338 */
dflet 0:400d8e75a8d0 339 int md_hmac_starts( md_context_t *ctx, const unsigned char *key,
dflet 0:400d8e75a8d0 340 size_t keylen );
dflet 0:400d8e75a8d0 341
dflet 0:400d8e75a8d0 342 /**
dflet 0:400d8e75a8d0 343 * \brief Generic HMAC process buffer
dflet 0:400d8e75a8d0 344 *
dflet 0:400d8e75a8d0 345 * \param ctx HMAC context
dflet 0:400d8e75a8d0 346 * \param input buffer holding the data
dflet 0:400d8e75a8d0 347 * \param ilen length of the input data
dflet 0:400d8e75a8d0 348 *
dflet 0:400d8e75a8d0 349 * \returns 0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter
dflet 0:400d8e75a8d0 350 * verification fails.
dflet 0:400d8e75a8d0 351 */
dflet 0:400d8e75a8d0 352 int md_hmac_update( md_context_t *ctx, const unsigned char *input,
dflet 0:400d8e75a8d0 353 size_t ilen );
dflet 0:400d8e75a8d0 354
dflet 0:400d8e75a8d0 355 /**
dflet 0:400d8e75a8d0 356 * \brief Generic HMAC final digest
dflet 0:400d8e75a8d0 357 *
dflet 0:400d8e75a8d0 358 * \param ctx HMAC context
dflet 0:400d8e75a8d0 359 * \param output Generic HMAC checksum result
dflet 0:400d8e75a8d0 360 *
dflet 0:400d8e75a8d0 361 * \returns 0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter
dflet 0:400d8e75a8d0 362 * verification fails.
dflet 0:400d8e75a8d0 363 */
dflet 0:400d8e75a8d0 364 int md_hmac_finish( md_context_t *ctx, unsigned char *output);
dflet 0:400d8e75a8d0 365
dflet 0:400d8e75a8d0 366 /**
dflet 0:400d8e75a8d0 367 * \brief Generic HMAC context reset
dflet 0:400d8e75a8d0 368 *
dflet 0:400d8e75a8d0 369 * \param ctx HMAC context to be reset
dflet 0:400d8e75a8d0 370 *
dflet 0:400d8e75a8d0 371 * \returns 0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter
dflet 0:400d8e75a8d0 372 * verification fails.
dflet 0:400d8e75a8d0 373 */
dflet 0:400d8e75a8d0 374 int md_hmac_reset( md_context_t *ctx );
dflet 0:400d8e75a8d0 375
dflet 0:400d8e75a8d0 376 /**
dflet 0:400d8e75a8d0 377 * \brief Output = Generic_HMAC( hmac key, input buffer )
dflet 0:400d8e75a8d0 378 *
dflet 0:400d8e75a8d0 379 * \param md_info message digest info
dflet 0:400d8e75a8d0 380 * \param key HMAC secret key
dflet 0:400d8e75a8d0 381 * \param keylen length of the HMAC key
dflet 0:400d8e75a8d0 382 * \param input buffer holding the data
dflet 0:400d8e75a8d0 383 * \param ilen length of the input data
dflet 0:400d8e75a8d0 384 * \param output Generic HMAC-result
dflet 0:400d8e75a8d0 385 *
dflet 0:400d8e75a8d0 386 * \returns 0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter
dflet 0:400d8e75a8d0 387 * verification fails.
dflet 0:400d8e75a8d0 388 */
dflet 0:400d8e75a8d0 389 int md_hmac( const md_info_t *md_info, const unsigned char *key, size_t keylen,
dflet 0:400d8e75a8d0 390 const unsigned char *input, size_t ilen,
dflet 0:400d8e75a8d0 391 unsigned char *output );
dflet 0:400d8e75a8d0 392
dflet 0:400d8e75a8d0 393 /* Internal use */
dflet 0:400d8e75a8d0 394 int md_process( md_context_t *ctx, const unsigned char *data );
dflet 0:400d8e75a8d0 395
dflet 0:400d8e75a8d0 396 #ifdef __cplusplus
dflet 0:400d8e75a8d0 397 }
dflet 0:400d8e75a8d0 398 #endif
dflet 0:400d8e75a8d0 399
dflet 0:400d8e75a8d0 400 #endif /* POLARSSL_MD_H */
dflet 0:400d8e75a8d0 401