PolarSSL is now part of ARM Official announcement and rebranded as mbed TLS.

API Documentation (Doxygen generated)

These pages are generated with doxygen directly from the source code!

md5.h File Reference

MD5 message digest algorithm (hash function) More...

#include "config.h"
#include <stddef.h>
#include <stdint.h>
Include dependency graph for md5.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  mbedtls_md5_context
 MD5 context structure. More...
 

Macros

#define MBEDTLS_ERR_MD5_HW_ACCEL_FAILED   -0x002F
 MD5 hardware accelerator failed. More...
 
#define MBEDTLS_DEPRECATED
 
#define MBEDTLS_DEPRECATED
 

Typedefs

typedef struct mbedtls_md5_context mbedtls_md5_context
 MD5 context structure. More...
 

Functions

void mbedtls_md5_init (mbedtls_md5_context *ctx)
 Initialize MD5 context. More...
 
void mbedtls_md5_free (mbedtls_md5_context *ctx)
 Clear MD5 context. More...
 
void mbedtls_md5_clone (mbedtls_md5_context *dst, const mbedtls_md5_context *src)
 Clone (the state of) an MD5 context. More...
 
int mbedtls_md5_starts_ret (mbedtls_md5_context *ctx)
 MD5 context setup. More...
 
int mbedtls_md5_update_ret (mbedtls_md5_context *ctx, const unsigned char *input, size_t ilen)
 MD5 process buffer. More...
 
int mbedtls_md5_finish_ret (mbedtls_md5_context *ctx, unsigned char output[16])
 MD5 final digest. More...
 
int mbedtls_internal_md5_process (mbedtls_md5_context *ctx, const unsigned char data[64])
 MD5 process data block (internal use only) More...
 
MBEDTLS_DEPRECATED void mbedtls_md5_starts (mbedtls_md5_context *ctx)
 MD5 context setup. More...
 
MBEDTLS_DEPRECATED void mbedtls_md5_update (mbedtls_md5_context *ctx, const unsigned char *input, size_t ilen)
 MD5 process buffer. More...
 
MBEDTLS_DEPRECATED void mbedtls_md5_finish (mbedtls_md5_context *ctx, unsigned char output[16])
 MD5 final digest. More...
 
MBEDTLS_DEPRECATED void mbedtls_md5_process (mbedtls_md5_context *ctx, const unsigned char data[64])
 MD5 process data block (internal use only) More...
 
int mbedtls_md5_ret (const unsigned char *input, size_t ilen, unsigned char output[16])
 Output = MD5( input buffer ) More...
 
MBEDTLS_DEPRECATED void mbedtls_md5 (const unsigned char *input, size_t ilen, unsigned char output[16])
 Output = MD5( input buffer ) More...
 
int mbedtls_md5_self_test (int verbose)
 Checkup routine. More...
 

Detailed Description

MD5 message digest algorithm (hash function)

Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.

Definition in file md5.h.

Macro Definition Documentation

#define MBEDTLS_DEPRECATED

Definition at line 268 of file md5.h.

#define MBEDTLS_DEPRECATED

Definition at line 268 of file md5.h.

#define MBEDTLS_ERR_MD5_HW_ACCEL_FAILED   -0x002F

MD5 hardware accelerator failed.

Definition at line 41 of file md5.h.

Typedef Documentation

MD5 context structure.

Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.

Function Documentation

int mbedtls_internal_md5_process ( mbedtls_md5_context ctx,
const unsigned char  data[64] 
)

MD5 process data block (internal use only)

Parameters
ctxMD5 context
databuffer holding one block of data
Returns
0 if successful
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
MBEDTLS_DEPRECATED void mbedtls_md5 ( const unsigned char *  input,
size_t  ilen,
unsigned char  output[16] 
)

Output = MD5( input buffer )

Deprecated:
Superseded by mbedtls_md5_ret() in 2.7.0
Parameters
inputbuffer holding the data
ilenlength of the input data
outputMD5 checksum result
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
void mbedtls_md5_clone ( mbedtls_md5_context dst,
const mbedtls_md5_context src 
)

Clone (the state of) an MD5 context.

Parameters
dstThe destination context
srcThe context to be cloned
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
MBEDTLS_DEPRECATED void mbedtls_md5_finish ( mbedtls_md5_context ctx,
unsigned char  output[16] 
)

MD5 final digest.

Deprecated:
Superseded by mbedtls_md5_finish_ret() in 2.7.0
Parameters
ctxMD5 context
outputMD5 checksum result
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
int mbedtls_md5_finish_ret ( mbedtls_md5_context ctx,
unsigned char  output[16] 
)

MD5 final digest.

Parameters
ctxMD5 context
outputMD5 checksum result
Returns
0 if successful
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
void mbedtls_md5_free ( mbedtls_md5_context ctx)

Clear MD5 context.

Parameters
ctxMD5 context to be cleared
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
void mbedtls_md5_init ( mbedtls_md5_context ctx)

Initialize MD5 context.

Parameters
ctxMD5 context to be initialized
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
MBEDTLS_DEPRECATED void mbedtls_md5_process ( mbedtls_md5_context ctx,
const unsigned char  data[64] 
)

MD5 process data block (internal use only)

Deprecated:
Superseded by mbedtls_internal_md5_process() in 2.7.0
Parameters
ctxMD5 context
databuffer holding one block of data
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
int mbedtls_md5_ret ( const unsigned char *  input,
size_t  ilen,
unsigned char  output[16] 
)

Output = MD5( input buffer )

Parameters
inputbuffer holding the data
ilenlength of the input data
outputMD5 checksum result
Returns
0 if successful
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
int mbedtls_md5_self_test ( int  verbose)

Checkup routine.

Returns
0 if successful, or 1 if the test failed
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
MBEDTLS_DEPRECATED void mbedtls_md5_starts ( mbedtls_md5_context ctx)

MD5 context setup.

Deprecated:
Superseded by mbedtls_md5_starts_ret() in 2.7.0
Parameters
ctxcontext to be initialized
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
int mbedtls_md5_starts_ret ( mbedtls_md5_context ctx)

MD5 context setup.

Parameters
ctxcontext to be initialized
Returns
0 if successful
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
MBEDTLS_DEPRECATED void mbedtls_md5_update ( mbedtls_md5_context ctx,
const unsigned char *  input,
size_t  ilen 
)

MD5 process buffer.

Deprecated:
Superseded by mbedtls_md5_update_ret() in 2.7.0
Parameters
ctxMD5 context
inputbuffer holding the data
ilenlength of the input data
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
int mbedtls_md5_update_ret ( mbedtls_md5_context ctx,
const unsigned char *  input,
size_t  ilen 
)

MD5 process buffer.

Parameters
ctxMD5 context
inputbuffer holding the data
ilenlength of the input data
Returns
0 if successful
Warning
MD5 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.