PolarSSL v1.3.9
Data Structures | Macros | Enumerations | Functions
md.h File Reference

Generic message digest wrapper. More...

#include <string.h>
Include dependency graph for md.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  md_info_t
 Message digest information. More...
 
struct  md_context_t
 Generic message digest context. More...
 

Macros

#define POLARSSL_ERR_MD_FEATURE_UNAVAILABLE   -0x5080
 The selected feature is not available. More...
 
#define POLARSSL_ERR_MD_BAD_INPUT_DATA   -0x5100
 Bad input parameters to function. More...
 
#define POLARSSL_ERR_MD_ALLOC_FAILED   -0x5180
 Failed to allocate memory. More...
 
#define POLARSSL_ERR_MD_FILE_IO_ERROR   -0x5200
 Opening or reading of file failed. More...
 
#define POLARSSL_MD_MAX_SIZE   32 /* longest known is SHA256 or less */
 
#define MD_CONTEXT_T_INIT
 

Enumerations

enum  md_type_t {
  POLARSSL_MD_NONE =0, POLARSSL_MD_MD2, POLARSSL_MD_MD4, POLARSSL_MD_MD5,
  POLARSSL_MD_SHA1, POLARSSL_MD_SHA224, POLARSSL_MD_SHA256, POLARSSL_MD_SHA384,
  POLARSSL_MD_SHA512, POLARSSL_MD_RIPEMD160
}
 

Functions

const int * md_list (void)
 Returns the list of digests supported by the generic digest module. More...
 
const md_info_tmd_info_from_string (const char *md_name)
 Returns the message digest information associated with the given digest name. More...
 
const md_info_tmd_info_from_type (md_type_t md_type)
 Returns the message digest information associated with the given digest type. More...
 
void md_init (md_context_t *ctx)
 Initialize a md_context (as NONE) More...
 
void md_free (md_context_t *ctx)
 Free and clear the message-specific context of ctx. More...
 
int md_init_ctx (md_context_t *ctx, const md_info_t *md_info)
 Initialises and fills the message digest context structure with the appropriate values. More...
 
int md_free_ctx (md_context_t *ctx)
 Free the message-specific context of ctx. More...
 
static unsigned char md_get_size (const md_info_t *md_info)
 Returns the size of the message digest output. More...
 
static md_type_t md_get_type (const md_info_t *md_info)
 Returns the type of the message digest output. More...
 
static const char * md_get_name (const md_info_t *md_info)
 Returns the name of the message digest output. More...
 
int md_starts (md_context_t *ctx)
 Set-up the given context for a new message digest. More...
 
int md_update (md_context_t *ctx, const unsigned char *input, size_t ilen)
 Generic message digest process buffer. More...
 
int md_finish (md_context_t *ctx, unsigned char *output)
 Generic message digest final digest. More...
 
int md (const md_info_t *md_info, const unsigned char *input, size_t ilen, unsigned char *output)
 Output = message_digest( input buffer ) More...
 
int md_file (const md_info_t *md_info, const char *path, unsigned char *output)
 Output = message_digest( file contents ) More...
 
int md_hmac_starts (md_context_t *ctx, const unsigned char *key, size_t keylen)
 Generic HMAC context setup. More...
 
int md_hmac_update (md_context_t *ctx, const unsigned char *input, size_t ilen)
 Generic HMAC process buffer. More...
 
int md_hmac_finish (md_context_t *ctx, unsigned char *output)
 Generic HMAC final digest. More...
 
int md_hmac_reset (md_context_t *ctx)
 Generic HMAC context reset. More...
 
int md_hmac (const md_info_t *md_info, const unsigned char *key, size_t keylen, const unsigned char *input, size_t ilen, unsigned char *output)
 Output = Generic_HMAC( hmac key, input buffer ) More...
 
int md_process (md_context_t *ctx, const unsigned char *data)
 

Detailed Description

Generic message digest wrapper.

Author
Adriaan de Jong dejon.nosp@m.g@fo.nosp@m.x-it..nosp@m.com

Copyright (C) 2006-2014, Brainspark B.V.

This file is part of PolarSSL (http://www.polarssl.org) Lead Maintainer: Paul Bakker <polarssl_maintainer at polarssl.org>

All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Definition in file md.h.

Macro Definition Documentation

#define MD_CONTEXT_T_INIT
Value:
{ \
NULL, /* md_info */ \
NULL, /* md_ctx */ \
}

Definition at line 140 of file md.h.

#define POLARSSL_ERR_MD_ALLOC_FAILED   -0x5180

Failed to allocate memory.

Definition at line 44 of file md.h.

#define POLARSSL_ERR_MD_BAD_INPUT_DATA   -0x5100

Bad input parameters to function.

Definition at line 43 of file md.h.

#define POLARSSL_ERR_MD_FEATURE_UNAVAILABLE   -0x5080

The selected feature is not available.

Definition at line 42 of file md.h.

#define POLARSSL_ERR_MD_FILE_IO_ERROR   -0x5200

Opening or reading of file failed.

Definition at line 45 of file md.h.

#define POLARSSL_MD_MAX_SIZE   32 /* longest known is SHA256 or less */

Definition at line 67 of file md.h.

Enumeration Type Documentation

enum md_type_t
Enumerator
POLARSSL_MD_NONE 
POLARSSL_MD_MD2 
POLARSSL_MD_MD4 
POLARSSL_MD_MD5 
POLARSSL_MD_SHA1 
POLARSSL_MD_SHA224 
POLARSSL_MD_SHA256 
POLARSSL_MD_SHA384 
POLARSSL_MD_SHA512 
POLARSSL_MD_RIPEMD160 

Definition at line 51 of file md.h.

Function Documentation

int md ( const md_info_t md_info,
const unsigned char *  input,
size_t  ilen,
unsigned char *  output 
)

Output = message_digest( input buffer )

Parameters
md_infomessage digest info
inputbuffer holding the data
ilenlength of the input data
outputGeneric message digest checksum result
Returns
0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter verification fails.
int md_file ( const md_info_t md_info,
const char *  path,
unsigned char *  output 
)

Output = message_digest( file contents )

Parameters
md_infomessage digest info
pathinput file name
outputgeneric message digest checksum result
Returns
0 if successful, POLARSSL_ERR_MD_FILE_OPEN_FAILED if fopen failed, POLARSSL_ERR_MD_FILE_READ_FAILED if fread failed, POLARSSL_ERR_MD_BAD_INPUT_DATA if md_info was NULL.
int md_finish ( md_context_t ctx,
unsigned char *  output 
)

Generic message digest final digest.

Parameters
ctxGeneric message digest context
outputGeneric message digest checksum result
Returns
0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter verification fails.
void md_free ( md_context_t ctx)

Free and clear the message-specific context of ctx.

Freeing ctx itself remains the responsibility of the caller.

int md_free_ctx ( md_context_t ctx)

Free the message-specific context of ctx.

Freeing ctx itself remains the responsibility of the caller.

Note
Deprecated: Redirects to md_free()
Parameters
ctxFree the message-specific context
Returns
0
static const char* md_get_name ( const md_info_t md_info)
inlinestatic

Returns the name of the message digest output.

Parameters
md_infomessage digest info
Returns
name of the message digest output.

Definition at line 255 of file md.h.

References md_info_t::name.

static unsigned char md_get_size ( const md_info_t md_info)
inlinestatic

Returns the size of the message digest output.

Parameters
md_infomessage digest info
Returns
size of the message digest output.

Definition at line 225 of file md.h.

References md_info_t::size.

static md_type_t md_get_type ( const md_info_t md_info)
inlinestatic

Returns the type of the message digest output.

Parameters
md_infomessage digest info
Returns
type of the message digest output.

Definition at line 240 of file md.h.

References POLARSSL_MD_NONE, and md_info_t::type.

int md_hmac ( const md_info_t md_info,
const unsigned char *  key,
size_t  keylen,
const unsigned char *  input,
size_t  ilen,
unsigned char *  output 
)

Output = Generic_HMAC( hmac key, input buffer )

Parameters
md_infomessage digest info
keyHMAC secret key
keylenlength of the HMAC key
inputbuffer holding the data
ilenlength of the input data
outputGeneric HMAC-result
Returns
0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter verification fails.
int md_hmac_finish ( md_context_t ctx,
unsigned char *  output 
)

Generic HMAC final digest.

Parameters
ctxHMAC context
outputGeneric HMAC checksum result
Returns
0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter verification fails.
int md_hmac_reset ( md_context_t ctx)

Generic HMAC context reset.

Parameters
ctxHMAC context to be reset
Returns
0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter verification fails.
int md_hmac_starts ( md_context_t ctx,
const unsigned char *  key,
size_t  keylen 
)

Generic HMAC context setup.

Parameters
ctxHMAC context to be initialized
keyHMAC secret key
keylenlength of the HMAC key
Returns
0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter verification fails.
int md_hmac_update ( md_context_t ctx,
const unsigned char *  input,
size_t  ilen 
)

Generic HMAC process buffer.

Parameters
ctxHMAC context
inputbuffer holding the data
ilenlength of the input data
Returns
0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter verification fails.
const md_info_t* md_info_from_string ( const char *  md_name)

Returns the message digest information associated with the given digest name.

Parameters
md_nameName of the digest to search for.
Returns
The message digest information associated with md_name or NULL if not found.
const md_info_t* md_info_from_type ( md_type_t  md_type)

Returns the message digest information associated with the given digest type.

Parameters
md_typetype of digest to search for.
Returns
The message digest information associated with md_type or NULL if not found.
void md_init ( md_context_t ctx)

Initialize a md_context (as NONE)

int md_init_ctx ( md_context_t ctx,
const md_info_t md_info 
)

Initialises and fills the message digest context structure with the appropriate values.

Note
Currently also clears structure. In future versions you will be required to call md_init() on the structure first.
Parameters
ctxcontext to initialise. May not be NULL. The digest-specific context (ctx->md_ctx) must be NULL. It will be allocated, and must be freed using md_free_ctx() later.
md_infomessage digest to use.
Returns
0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA on parameter failure, POLARSSL_ERR_MD_ALLOC_FAILED if allocation of the digest-specific context failed.
const int* md_list ( void  )

Returns the list of digests supported by the generic digest module.

Returns
a statically allocated array of digests, the last entry is 0.
int md_process ( md_context_t ctx,
const unsigned char *  data 
)
int md_starts ( md_context_t ctx)

Set-up the given context for a new message digest.

Parameters
ctxgeneric message digest context.
Returns
0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter verification fails.
int md_update ( md_context_t ctx,
const unsigned char *  input,
size_t  ilen 
)

Generic message digest process buffer.

Parameters
ctxGeneric message digest context
inputbuffer holding the datal
ilenlength of the input data
Returns
0 on success, POLARSSL_ERR_MD_BAD_INPUT_DATA if parameter verification fails.