mphell-random.h

Go to the documentation of this file.

/* 
  MPHELL-4.0 
  Author(s): The MPHELL team

 (C) Copyright 2015-2018 - Institut Fourier / Univ. Grenoble Alpes (France) 

 This file is part of the MPHELL Library.
 MPHELL is free software: you can redistribute it and/or modify
 it under the terms of the GNU Lesser General Public License as published by
 the Free Software Foundation, version 3 of the License.
 
 MPHELL 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 Lesser General Public License for more details.

 You should have received a copy of the GNU Lesser General Public License
 along with MPHELL.  If not, see <http://www.gnu.org/licenses/>.
*/

#ifndef RANDOM_H
#define RANDOM_H

#include "mphell-drbg.h"

enum random_algo {
    RANDOM_INTEL,       
    RANDOM_AES128,      
    RANDOM_AES192,      
    RANDOM_AES256,      
    RANDOM_SHA1,        
    RANDOM_SHA256,      
    STM32F4_RNG,        
    RANDOM_UNSET        
};

typedef enum random_algo random_type;

typedef struct {
    int8_t state_handle;    
    random_type type;       
}random_state_t;

typedef random_state_t random_state[1];

void
random_instantiate(mphell_status ret, random_state initial_state, 
        const uint16_t requested_instantiation_security_strength, 
        const uint8_t* personalization_string,
        const uint64_t pers_length, const random_type type,
        const entropy_type entropy, uint64_t reseed_interval);

void
random_reseed(mphell_status ret, random_state working_state, 
        const uint16_t entropy_length, const entropy_type entropy_src,
        const uint8_t* additional_input,
        const uint64_t add_length);

void
random_generate(mphell_status ret, uint8_t* returned_bytes, 
        random_state working_state,
        const uint32_t requested_number_of_bytes, 
        const uint16_t requested_security_strength,
        const uint8_t* additionnal_input, const uint64_t add_length);

void
random_uninstantiate(mphell_status ret, random_state working_state);

extern void (*stm32f4_rng)(mphell_status ret, uint8_t *data, const uint16_t length);

#endif