entropy.h

Go to the documentation of this file.

 
#ifndef POLARSSL_ENTROPY_H
#define POLARSSL_ENTROPY_H
 
#include <string.h>
 
#if !defined(POLARSSL_CONFIG_FILE)
#include "config.h"
#else
#include POLARSSL_CONFIG_FILE
#endif
 
#if defined(POLARSSL_SHA512_C) && !defined(POLARSSL_ENTROPY_FORCE_SHA256)
#include "sha512.h"
#define POLARSSL_ENTROPY_SHA512_ACCUMULATOR
#else
#if defined(POLARSSL_SHA256_C)
#define POLARSSL_ENTROPY_SHA256_ACCUMULATOR
#include "sha256.h"
#endif
#endif
 
#if defined(POLARSSL_THREADING_C)
#include "threading.h"
#endif
 
#if defined(POLARSSL_HAVEGE_C)
#include "havege.h"
#endif
 
#define POLARSSL_ERR_ENTROPY_SOURCE_FAILED                 -0x003C  
#define POLARSSL_ERR_ENTROPY_MAX_SOURCES                   -0x003E  
#define POLARSSL_ERR_ENTROPY_NO_SOURCES_DEFINED            -0x0040  
#define POLARSSL_ERR_ENTROPY_FILE_IO_ERROR                 -0x0058  
#if !defined(ENTROPY_MAX_SOURCES)
#define ENTROPY_MAX_SOURCES     20      
#endif
 
#if !defined(ENTROPY_MAX_GATHER)
#define ENTROPY_MAX_GATHER      128     
#endif
 
/* \} name SECTION: Module settings */
 
#if defined(POLARSSL_ENTROPY_SHA512_ACCUMULATOR)
#define ENTROPY_BLOCK_SIZE      64      
#else
#define ENTROPY_BLOCK_SIZE      32      
#endif
 
#define ENTROPY_MAX_SEED_SIZE   1024    
#define ENTROPY_SOURCE_MANUAL   ENTROPY_MAX_SOURCES
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef int (*f_source_ptr)(void *data, unsigned char *output, size_t len,
                            size_t *olen);
 
typedef struct
{
    f_source_ptr    f_source;   
    void *          p_source;   
    size_t          size;       
    size_t          threshold;  
}
source_state;
 
typedef struct
{
#if defined(POLARSSL_ENTROPY_SHA512_ACCUMULATOR)
    sha512_context  accumulator;
#else
    sha256_context  accumulator;
#endif
    int             source_count;
    source_state    source[ENTROPY_MAX_SOURCES];
#if defined(POLARSSL_HAVEGE_C)
    havege_state    havege_data;
#endif
#if defined(POLARSSL_THREADING_C)
    threading_mutex_t mutex;    
#endif
}
entropy_context;
 
void entropy_init( entropy_context *ctx );
 
void entropy_free( entropy_context *ctx );
 
int entropy_add_source( entropy_context *ctx,
                        f_source_ptr f_source, void *p_source,
                        size_t threshold );
 
int entropy_gather( entropy_context *ctx );
 
int entropy_func( void *data, unsigned char *output, size_t len );
 
int entropy_update_manual( entropy_context *ctx,
                           const unsigned char *data, size_t len );
 
#if defined(POLARSSL_FS_IO)
int entropy_write_seed_file( entropy_context *ctx, const char *path );
 
int entropy_update_seed_file( entropy_context *ctx, const char *path );
#endif /* POLARSSL_FS_IO */
 
#if defined(POLARSSL_SELF_TEST)
int entropy_self_test( int verbose );
#endif /* POLARSSL_SELF_TEST */
 
#ifdef __cplusplus
}
#endif
 
#endif /* entropy.h */