3 This file is part of the ARM-Crypto-Lib.
4 Copyright (C) 2006-2010 Daniel Otte (daniel.otte@rub.de)
6 This program is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>.
22 * \email daniel.otte@rub.de
24 * \license GPLv3 or later
25 * \brief This file contains an implementaition of a pseudo-random-number generator.
28 * rndCore is expanded to 512 bits for more security.
31 ################################################################################################
33 # +---------------------------+ #
37 +---------------+ # o---------o (xor)+---------+ o---------o o----o o---------o # +--------------+
38 | entropy Block | -----> | sha-256 | --(offset)-< | rndCore | ---> | sha-256 | --+----| +1 |---> | sha-256 | -----> | random Block |
39 +---------------+ # o---------o (xor)+---------+ o---------o | o----o o---------o # +--------------+
43 # (offset)---------------------+ #
45 ################################################################################################
52 #include "entropium.h"
57 * \brief secret entropy pool.
58 * This is the core of the random which is generated
63 /*************************************************************************/
65 /* idea is: hash the message and add it via xor to rndCore
69 * we simply first "hash" rndCore, then entropy.
71 void entropium_addEntropy(unsigned length_b, const void* data){
73 static uint8_t offset=0; /* selects if higher or lower half gets updated */
75 sha256_nextBlock(&s, rndCore);
76 while (length_b>=512){
77 sha256_nextBlock(&s, data);
78 data = (uint8_t*)data+ 512/8;
81 sha256_lastBlock(&s, data, length_b);
84 rndCore[i+offset] ^= s.h[i];
86 offset ^= 8; /* hehe */
89 /*************************************************************************/
91 void entropium_getRandomBlock(void *b){
96 sha256_lastBlock(&s, rndCore, 512); /* remember the byte order! */
99 rndCore[i+offset] ^= s.h[i];
101 offset ^= 8; /* hehe */
102 memcpy(b, s.h, 32); /* back up first hash in b */
103 ((uint8_t*)b)[*((uint8_t*)b)&31]++; /* the important increment step */
105 sha256_lastBlock(&s, b, 256);
109 /*************************************************************************/
112 uint8_t entropium_getRandomByte(void){
113 static uint8_t block[32];
114 static uint8_t i = 0;
117 entropium_getRandomBlock((void*)block);
123 void entropium_fillBlockRandom(void* block, unsigned length_B){
124 while(length_B>ENTROPIUM_RANDOMBLOCK_SIZE){
125 entropium_getRandomBlock(block);
126 block = (uint8_t*)block + ENTROPIUM_RANDOMBLOCK_SIZE;
127 length_B -= ENTROPIUM_RANDOMBLOCK_SIZE;
130 *((uint8_t*)block) = entropium_getRandomByte();
131 block= (uint8_t*)block +1; --length_B;