entropy.h File Reference

Entropy accumulator implementation. More...

#include "mbedtls/config.h"
#include <stddef.h>

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...

Macros
#define	MBEDTLS_ERR_ENTROPY_SOURCE_FAILED   -0x003C
	Critical entropy source failure.
#define	MBEDTLS_ERR_ENTROPY_MAX_SOURCES   -0x003E
	No more sources can be added.
#define	MBEDTLS_ERR_ENTROPY_NO_SOURCES_DEFINED   -0x0040
	No sources have been added to poll.
#define	MBEDTLS_ERR_ENTROPY_NO_STRONG_SOURCE   -0x003D
	No strong sources have been added to poll.
#define	MBEDTLS_ERR_ENTROPY_FILE_IO_ERROR   -0x003F
	Read/write error in file.
#define	MBEDTLS_ENTROPY_BLOCK_SIZE   32
	Block size of entropy accumulator (SHA-256)
#define	MBEDTLS_ENTROPY_MAX_SEED_SIZE   1024
	Maximum size of seed we read from seed file.
#define	MBEDTLS_ENTROPY_SOURCE_STRONG   1
	Entropy source is strong
#define	MBEDTLS_ENTROPY_SOURCE_WEAK   0
	Entropy source is weak
SECTION: Module settings
The configuration options you can set for this module are in this section. Either change them in config.h or define them on the compiler command line.
#define	MBEDTLS_ENTROPY_MAX_SOURCES   20
	Maximum number of sources supported.
#define	MBEDTLS_ENTROPY_MAX_GATHER   128
	Maximum amount requested from entropy sources.

Typedefs
typedef int(*	mbedtls_entropy_f_source_ptr) (void *data, unsigned char *output, size_t len, size_t *olen)
	Entropy poll callback pointer.
typedef struct mbedtls_entropy_source_state	mbedtls_entropy_source_state
	Entropy source state.
typedef struct mbedtls_entropy_context	mbedtls_entropy_context
	Entropy context structure.

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)

Detailed Description

Entropy accumulator implementation.

Definition in file entropy.h.