Nicolas Borla / Mbed OS BBR_1Ebene
Embed: (wiki syntax)

« Back to documentation index

entropy.h File Reference

entropy.h File Reference

Entropy accumulator implementation. More...

Go to the source code of this file.

Data Structures

struct  mbedtls_entropy_source_state
 Entropy source state. More...
struct  mbedtls_entropy_context
 Entropy context structure. More...

Typedefs

typedef int(* mbedtls_entropy_f_source_ptr )(void *data, unsigned char *output, size_t len, size_t *olen)
 Entropy poll callback pointer.

Functions

void mbedtls_entropy_init (mbedtls_entropy_context *ctx)
 Initialize the context.
void mbedtls_entropy_free (mbedtls_entropy_context *ctx)
 Free the data in the context.
int mbedtls_entropy_add_source (mbedtls_entropy_context *ctx, mbedtls_entropy_f_source_ptr f_source, void *p_source, size_t threshold, int strong)
 Adds an entropy source to poll (Thread-safe if MBEDTLS_THREADING_C is enabled)
int mbedtls_entropy_gather (mbedtls_entropy_context *ctx)
 Trigger an extra gather poll for the accumulator (Thread-safe if MBEDTLS_THREADING_C is enabled)
int mbedtls_entropy_func (void *data, unsigned char *output, size_t len)
 Retrieve entropy from the accumulator (Maximum length: MBEDTLS_ENTROPY_BLOCK_SIZE) (Thread-safe if MBEDTLS_THREADING_C is enabled)
int mbedtls_entropy_update_manual (mbedtls_entropy_context *ctx, const unsigned char *data, size_t len)
 Add data to the accumulator manually (Thread-safe if MBEDTLS_THREADING_C is enabled)
int mbedtls_entropy_update_nv_seed (mbedtls_entropy_context *ctx)
 Trigger an update of the seed file in NV by using the current entropy pool.
int mbedtls_entropy_write_seed_file (mbedtls_entropy_context *ctx, const char *path)
 Write a seed file.
int mbedtls_entropy_update_seed_file (mbedtls_entropy_context *ctx, const char *path)
 Read and update a seed file.
int mbedtls_entropy_self_test (int verbose)
 Checkup routine.
int mbedtls_entropy_source_self_test (int verbose)
 Checkup routine.

Detailed Description

Entropy accumulator implementation.

Definition in file entropy.h.


Typedef Documentation

typedef int(* mbedtls_entropy_f_source_ptr)(void *data, unsigned char *output, size_t len, size_t *olen)

Entropy poll callback pointer.

Parameters:
dataCallback-specific data pointer
outputData to fill
lenMaximum size to provide
olenThe actual amount of bytes put into the buffer (Can be 0)
Returns:
0 if no critical failures occurred, MBEDTLS_ERR_ENTROPY_SOURCE_FAILED otherwise

Definition at line 104 of file entropy.h.


Function Documentation

int mbedtls_entropy_add_source ( mbedtls_entropy_context ctx,
mbedtls_entropy_f_source_ptr  f_source,
void *  p_source,
size_t  threshold,
int  strong 
)

Adds an entropy source to poll (Thread-safe if MBEDTLS_THREADING_C is enabled)

Parameters:
ctxEntropy context
f_sourceEntropy function
p_sourceFunction data
thresholdMinimum required from source before entropy is released ( with mbedtls_entropy_func() ) (in bytes)
strongMBEDTLS_ENTROPY_SOURCE_STRONG or MBEDTSL_ENTROPY_SOURCE_WEAK. At least one strong source needs to be added. Weaker sources (such as the cycle counter) can be used as a complement.
Returns:
0 if successful or MBEDTLS_ERR_ENTROPY_MAX_SOURCES

Definition at line 147 of file entropy.c.

void mbedtls_entropy_free ( mbedtls_entropy_context ctx )

Free the data in the context.

Parameters:
ctxEntropy context to free

Definition at line 126 of file entropy.c.

int mbedtls_entropy_func ( void *  data,
unsigned char *  output,
size_t  len 
)

Retrieve entropy from the accumulator (Maximum length: MBEDTLS_ENTROPY_BLOCK_SIZE) (Thread-safe if MBEDTLS_THREADING_C is enabled)

Parameters:
dataEntropy context
outputBuffer to fill
lenNumber of bytes desired, must be at most MBEDTLS_ENTROPY_BLOCK_SIZE
Returns:
0 if successful, or MBEDTLS_ERR_ENTROPY_SOURCE_FAILED

Definition at line 330 of file entropy.c.

int mbedtls_entropy_gather ( mbedtls_entropy_context ctx )

Trigger an extra gather poll for the accumulator (Thread-safe if MBEDTLS_THREADING_C is enabled)

Parameters:
ctxEntropy context
Returns:
0 if successful, or MBEDTLS_ERR_ENTROPY_SOURCE_FAILED

Definition at line 311 of file entropy.c.

void mbedtls_entropy_init ( mbedtls_entropy_context ctx )

Initialize the context.

Parameters:
ctxEntropy context to initialize

Definition at line 69 of file entropy.c.

int mbedtls_entropy_self_test ( int  verbose )

Checkup routine.

This module self-test also calls the entropy self-test, mbedtls_entropy_source_self_test();

Returns:
0 if successful, or 1 if a test failed

Definition at line 648 of file entropy.c.

int mbedtls_entropy_source_self_test ( int  verbose )

Checkup routine.

Verifies the integrity of the hardware entropy source provided by the function 'mbedtls_hardware_poll()'.

Note this is the only hardware entropy source that is known at link time, and other entropy sources configured dynamically at runtime by the function mbedtls_entropy_add_source() will not be tested.

Returns:
0 if successful, or 1 if a test failed

Definition at line 600 of file entropy.c.

int mbedtls_entropy_update_manual ( mbedtls_entropy_context ctx,
const unsigned char *  data,
size_t  len 
)

Add data to the accumulator manually (Thread-safe if MBEDTLS_THREADING_C is enabled)

Parameters:
ctxEntropy context
dataData to add
lenLength of data
Returns:
0 if successful

Definition at line 240 of file entropy.c.

int mbedtls_entropy_update_nv_seed ( mbedtls_entropy_context ctx )

Trigger an update of the seed file in NV by using the current entropy pool.

Parameters:
ctxEntropy context
Returns:
0 if successful

Definition at line 447 of file entropy.c.

int mbedtls_entropy_update_seed_file ( mbedtls_entropy_context ctx,
const char *  path 
)

Read and update a seed file.

Seed is added to this instance. No more than MBEDTLS_ENTROPY_MAX_SEED_SIZE bytes are read from the seed file. The rest is ignored.

Parameters:
ctxEntropy context
pathName of the file
Returns:
0 if successful, MBEDTLS_ERR_ENTROPY_FILE_IO_ERROR on file error, MBEDTLS_ERR_ENTROPY_SOURCE_FAILED

Definition at line 495 of file entropy.c.

int mbedtls_entropy_write_seed_file ( mbedtls_entropy_context ctx,
const char *  path 
)

Write a seed file.

Parameters:
ctxEntropy context
pathName of the file
Returns:
0 if successful, MBEDTLS_ERR_ENTROPY_FILE_IO_ERROR on file error, or MBEDTLS_ERR_ENTROPY_SOURCE_FAILED

Definition at line 468 of file entropy.c.