blob: cc686282a65fd9a9eba7dd54fca1291efe5e397e [file] [log] [blame]
Paul Bakker6083fd22011-12-03 21:45:14 +00001/*
2 * Entropy accumulator implementation
3 *
Bence Szépkúti1e148272020-08-07 13:07:28 +02004 * Copyright The Mbed TLS Contributors
Manuel Pégourié-Gonnard37ff1402015-09-04 14:21:07 +02005 * SPDX-License-Identifier: Apache-2.0
6 *
7 * Licensed under the Apache License, Version 2.0 (the "License"); you may
8 * not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
10 *
11 * http://www.apache.org/licenses/LICENSE-2.0
12 *
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
15 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
Paul Bakker6083fd22011-12-03 21:45:14 +000018 */
19
Gilles Peskinedb09ef62020-06-03 01:43:33 +020020#include "common.h"
Paul Bakker6083fd22011-12-03 21:45:14 +000021
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020022#if defined(MBEDTLS_ENTROPY_C)
Paul Bakker6083fd22011-12-03 21:45:14 +000023
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000024#include "mbedtls/entropy.h"
Chris Jonesea0a8652021-03-09 19:11:19 +000025#include "entropy_poll.h"
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050026#include "mbedtls/platform_util.h"
Janos Follath24eed8d2019-11-22 13:21:35 +000027#include "mbedtls/error.h"
Paul Bakker6083fd22011-12-03 21:45:14 +000028
Rich Evans00ab4702015-02-06 13:43:58 +000029#include <string.h>
30
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020031#if defined(MBEDTLS_FS_IO)
Paul Bakker66ff70d2014-03-26 11:54:05 +010032#include <stdio.h>
33#endif
34
Paul Bakker217efbc2016-07-14 14:30:03 +010035#if defined(MBEDTLS_ENTROPY_NV_SEED)
36#include "mbedtls/platform.h"
37#endif
38
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020039#if defined(MBEDTLS_SELF_TEST)
40#if defined(MBEDTLS_PLATFORM_C)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000041#include "mbedtls/platform.h"
Rich Evans00ab4702015-02-06 13:43:58 +000042#else
43#include <stdio.h>
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020044#define mbedtls_printf printf
45#endif /* MBEDTLS_PLATFORM_C */
46#endif /* MBEDTLS_SELF_TEST */
Rich Evans00ab4702015-02-06 13:43:58 +000047
Paul Bakker28c7e7f2011-12-15 19:49:30 +000048
Paul Bakker6083fd22011-12-03 21:45:14 +000049#define ENTROPY_MAX_LOOP 256 /**< Maximum amount to loop before error */
50
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020051void mbedtls_entropy_init( mbedtls_entropy_context *ctx )
Paul Bakker6083fd22011-12-03 21:45:14 +000052{
Andres Amaya Garciaa7559cb2017-06-29 16:12:31 +010053 ctx->source_count = 0;
54 memset( ctx->source, 0, sizeof( ctx->source ) );
Paul Bakker6083fd22011-12-03 21:45:14 +000055
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020056#if defined(MBEDTLS_THREADING_C)
57 mbedtls_mutex_init( &ctx->mutex );
Paul Bakkerf4e7dc52013-09-28 15:23:57 +020058#endif
59
Andres Amaya Garcia95869c42017-06-29 16:31:44 +010060 ctx->accumulator_started = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020061#if defined(MBEDTLS_ENTROPY_SHA512_ACCUMULATOR)
Andres Amaya Garciaa7559cb2017-06-29 16:12:31 +010062 mbedtls_sha512_init( &ctx->accumulator );
Paul Bakkerfb08fd22013-08-27 15:06:26 +020063#else
Andres Amaya Garciaa7559cb2017-06-29 16:12:31 +010064 mbedtls_sha256_init( &ctx->accumulator );
Paul Bakkerfb08fd22013-08-27 15:06:26 +020065#endif
Paul Bakker6083fd22011-12-03 21:45:14 +000066
Hanno Beckerd4a872e2017-09-07 08:09:33 +010067 /* Reminder: Update ENTROPY_HAVE_STRONG in the test files
Hanno Becker47deec42017-07-24 12:27:09 +010068 * when adding more strong entropy sources here. */
Hanno Beckerc6deafc2017-07-23 14:06:42 +010069
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020070#if !defined(MBEDTLS_NO_DEFAULT_ENTROPY_SOURCES)
71#if !defined(MBEDTLS_NO_PLATFORM_ENTROPY)
72 mbedtls_entropy_add_source( ctx, mbedtls_platform_entropy_poll, NULL,
Manuel Pégourié-Gonnard7580ba42015-06-19 10:26:32 +020073 MBEDTLS_ENTROPY_MIN_PLATFORM,
74 MBEDTLS_ENTROPY_SOURCE_STRONG );
Paul Bakker6083fd22011-12-03 21:45:14 +000075#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020076#if defined(MBEDTLS_TIMING_C)
Manuel Pégourié-Gonnard7580ba42015-06-19 10:26:32 +020077 mbedtls_entropy_add_source( ctx, mbedtls_hardclock_poll, NULL,
78 MBEDTLS_ENTROPY_MIN_HARDCLOCK,
79 MBEDTLS_ENTROPY_SOURCE_WEAK );
Paul Bakker6083fd22011-12-03 21:45:14 +000080#endif
Manuel Pégourié-Gonnard3f77dfb2015-06-19 10:06:21 +020081#if defined(MBEDTLS_ENTROPY_HARDWARE_ALT)
Manuel Pégourié-Gonnardfc2ccfe2015-07-10 11:15:50 +010082 mbedtls_entropy_add_source( ctx, mbedtls_hardware_poll, NULL,
Manuel Pégourié-Gonnard7580ba42015-06-19 10:26:32 +020083 MBEDTLS_ENTROPY_MIN_HARDWARE,
84 MBEDTLS_ENTROPY_SOURCE_STRONG );
Manuel Pégourié-Gonnard3f77dfb2015-06-19 10:06:21 +020085#endif
Paul Bakker9988d6b2016-06-01 11:29:42 +010086#if defined(MBEDTLS_ENTROPY_NV_SEED)
87 mbedtls_entropy_add_source( ctx, mbedtls_nv_seed_poll, NULL,
88 MBEDTLS_ENTROPY_BLOCK_SIZE,
89 MBEDTLS_ENTROPY_SOURCE_STRONG );
Andres Amaya Garciaa7559cb2017-06-29 16:12:31 +010090 ctx->initial_entropy_run = 0;
Paul Bakker9988d6b2016-06-01 11:29:42 +010091#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020092#endif /* MBEDTLS_NO_DEFAULT_ENTROPY_SOURCES */
Paul Bakker6083fd22011-12-03 21:45:14 +000093}
94
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020095void mbedtls_entropy_free( mbedtls_entropy_context *ctx )
Paul Bakker1ffefac2013-09-28 15:23:03 +020096{
Gilles Peskineb1583212021-02-22 21:26:54 +010097 /* If the context was already free, don't call free() again.
98 * This is important for mutexes which don't allow double-free. */
99 if( ctx->accumulator_started == -1 )
100 return;
101
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200102#if defined(MBEDTLS_THREADING_C)
103 mbedtls_mutex_free( &ctx->mutex );
Paul Bakkerf4e7dc52013-09-28 15:23:57 +0200104#endif
Andres Amaya Garciaa7559cb2017-06-29 16:12:31 +0100105#if defined(MBEDTLS_ENTROPY_SHA512_ACCUMULATOR)
106 mbedtls_sha512_free( &ctx->accumulator );
107#else
108 mbedtls_sha256_free( &ctx->accumulator );
109#endif
110#if defined(MBEDTLS_ENTROPY_NV_SEED)
111 ctx->initial_entropy_run = 0;
112#endif
113 ctx->source_count = 0;
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500114 mbedtls_platform_zeroize( ctx->source, sizeof( ctx->source ) );
Gilles Peskineb1583212021-02-22 21:26:54 +0100115 ctx->accumulator_started = -1;
Paul Bakker1ffefac2013-09-28 15:23:03 +0200116}
117
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200118int mbedtls_entropy_add_source( mbedtls_entropy_context *ctx,
119 mbedtls_entropy_f_source_ptr f_source, void *p_source,
Manuel Pégourié-Gonnard7580ba42015-06-19 10:26:32 +0200120 size_t threshold, int strong )
Paul Bakker6083fd22011-12-03 21:45:14 +0000121{
Hanno Becker61937d42017-04-26 15:01:23 +0100122 int idx, ret = 0;
Paul Bakkerbd4a9d02011-12-10 17:02:19 +0000123
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200124#if defined(MBEDTLS_THREADING_C)
125 if( ( ret = mbedtls_mutex_lock( &ctx->mutex ) ) != 0 )
Paul Bakker47703a02014-02-06 15:01:20 +0100126 return( ret );
127#endif
128
Hanno Becker61937d42017-04-26 15:01:23 +0100129 idx = ctx->source_count;
130 if( idx >= MBEDTLS_ENTROPY_MAX_SOURCES )
Paul Bakker47703a02014-02-06 15:01:20 +0100131 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200132 ret = MBEDTLS_ERR_ENTROPY_MAX_SOURCES;
Paul Bakker47703a02014-02-06 15:01:20 +0100133 goto exit;
134 }
Paul Bakker6083fd22011-12-03 21:45:14 +0000135
Hanno Becker61937d42017-04-26 15:01:23 +0100136 ctx->source[idx].f_source = f_source;
137 ctx->source[idx].p_source = p_source;
138 ctx->source[idx].threshold = threshold;
139 ctx->source[idx].strong = strong;
Paul Bakker6083fd22011-12-03 21:45:14 +0000140
141 ctx->source_count++;
142
Paul Bakker47703a02014-02-06 15:01:20 +0100143exit:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200144#if defined(MBEDTLS_THREADING_C)
145 if( mbedtls_mutex_unlock( &ctx->mutex ) != 0 )
146 return( MBEDTLS_ERR_THREADING_MUTEX_ERROR );
Paul Bakker47703a02014-02-06 15:01:20 +0100147#endif
148
149 return( ret );
Paul Bakker6083fd22011-12-03 21:45:14 +0000150}
151
152/*
153 * Entropy accumulator update
154 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200155static int entropy_update( mbedtls_entropy_context *ctx, unsigned char source_id,
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +0200156 const unsigned char *data, size_t len )
Paul Bakker6083fd22011-12-03 21:45:14 +0000157{
158 unsigned char header[2];
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200159 unsigned char tmp[MBEDTLS_ENTROPY_BLOCK_SIZE];
Paul Bakker6083fd22011-12-03 21:45:14 +0000160 size_t use_len = len;
161 const unsigned char *p = data;
Jaeden Amero66954e12018-01-25 16:05:54 +0000162 int ret = 0;
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +0200163
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200164 if( use_len > MBEDTLS_ENTROPY_BLOCK_SIZE )
Paul Bakker6083fd22011-12-03 21:45:14 +0000165 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200166#if defined(MBEDTLS_ENTROPY_SHA512_ACCUMULATOR)
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100167 if( ( ret = mbedtls_sha512_ret( data, len, tmp, 0 ) ) != 0 )
Jaeden Amero66954e12018-01-25 16:05:54 +0000168 goto cleanup;
Paul Bakkerfb08fd22013-08-27 15:06:26 +0200169#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100170 if( ( ret = mbedtls_sha256_ret( data, len, tmp, 0 ) ) != 0 )
Jaeden Amero66954e12018-01-25 16:05:54 +0000171 goto cleanup;
Paul Bakkerfb08fd22013-08-27 15:06:26 +0200172#endif
Paul Bakker6083fd22011-12-03 21:45:14 +0000173 p = tmp;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200174 use_len = MBEDTLS_ENTROPY_BLOCK_SIZE;
Paul Bakker6083fd22011-12-03 21:45:14 +0000175 }
176
177 header[0] = source_id;
178 header[1] = use_len & 0xFF;
179
Andres Amaya Garcia95869c42017-06-29 16:31:44 +0100180 /*
181 * Start the accumulator if this has not already happened. Note that
182 * it is sufficient to start the accumulator here only because all calls to
183 * gather entropy eventually execute this code.
184 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200185#if defined(MBEDTLS_ENTROPY_SHA512_ACCUMULATOR)
Andres Amaya Garcia95869c42017-06-29 16:31:44 +0100186 if( ctx->accumulator_started == 0 &&
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100187 ( ret = mbedtls_sha512_starts_ret( &ctx->accumulator, 0 ) ) != 0 )
Jaeden Amero66954e12018-01-25 16:05:54 +0000188 goto cleanup;
Andres Amaya Garcia95869c42017-06-29 16:31:44 +0100189 else
190 ctx->accumulator_started = 1;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100191 if( ( ret = mbedtls_sha512_update_ret( &ctx->accumulator, header, 2 ) ) != 0 )
Jaeden Amero66954e12018-01-25 16:05:54 +0000192 goto cleanup;
193 ret = mbedtls_sha512_update_ret( &ctx->accumulator, p, use_len );
Paul Bakkerfb08fd22013-08-27 15:06:26 +0200194#else
Andres Amaya Garcia95869c42017-06-29 16:31:44 +0100195 if( ctx->accumulator_started == 0 &&
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100196 ( ret = mbedtls_sha256_starts_ret( &ctx->accumulator, 0 ) ) != 0 )
Jaeden Amero66954e12018-01-25 16:05:54 +0000197 goto cleanup;
Andres Amaya Garcia95869c42017-06-29 16:31:44 +0100198 else
199 ctx->accumulator_started = 1;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100200 if( ( ret = mbedtls_sha256_update_ret( &ctx->accumulator, header, 2 ) ) != 0 )
Jaeden Amero66954e12018-01-25 16:05:54 +0000201 goto cleanup;
202 ret = mbedtls_sha256_update_ret( &ctx->accumulator, p, use_len );
Paul Bakkerfb08fd22013-08-27 15:06:26 +0200203#endif
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +0200204
Jaeden Amero66954e12018-01-25 16:05:54 +0000205cleanup:
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500206 mbedtls_platform_zeroize( tmp, sizeof( tmp ) );
Andres Amaya Garcia65121932017-07-05 15:45:47 +0100207
Jaeden Amero66954e12018-01-25 16:05:54 +0000208 return( ret );
Paul Bakker6083fd22011-12-03 21:45:14 +0000209}
210
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200211int mbedtls_entropy_update_manual( mbedtls_entropy_context *ctx,
Paul Bakker6083fd22011-12-03 21:45:14 +0000212 const unsigned char *data, size_t len )
213{
Janos Follath24eed8d2019-11-22 13:21:35 +0000214 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker47703a02014-02-06 15:01:20 +0100215
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200216#if defined(MBEDTLS_THREADING_C)
217 if( ( ret = mbedtls_mutex_lock( &ctx->mutex ) ) != 0 )
Paul Bakker47703a02014-02-06 15:01:20 +0100218 return( ret );
219#endif
220
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200221 ret = entropy_update( ctx, MBEDTLS_ENTROPY_SOURCE_MANUAL, data, len );
Paul Bakker47703a02014-02-06 15:01:20 +0100222
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200223#if defined(MBEDTLS_THREADING_C)
224 if( mbedtls_mutex_unlock( &ctx->mutex ) != 0 )
225 return( MBEDTLS_ERR_THREADING_MUTEX_ERROR );
Paul Bakker47703a02014-02-06 15:01:20 +0100226#endif
227
Paul Bakkerd8bb8262014-06-17 14:06:49 +0200228 return( ret );
Paul Bakker6083fd22011-12-03 21:45:14 +0000229}
230
231/*
232 * Run through the different sources to add entropy to our accumulator
233 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200234static int entropy_gather_internal( mbedtls_entropy_context *ctx )
Paul Bakker6083fd22011-12-03 21:45:14 +0000235{
Gilles Peskine006c1b52019-09-30 17:29:54 +0200236 int ret = MBEDTLS_ERR_ENTROPY_SOURCE_FAILED;
237 int i;
238 int have_one_strong = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200239 unsigned char buf[MBEDTLS_ENTROPY_MAX_GATHER];
Paul Bakker6083fd22011-12-03 21:45:14 +0000240 size_t olen;
Paul Bakker47703a02014-02-06 15:01:20 +0100241
Paul Bakker43655f42011-12-15 20:11:16 +0000242 if( ctx->source_count == 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200243 return( MBEDTLS_ERR_ENTROPY_NO_SOURCES_DEFINED );
Paul Bakker43655f42011-12-15 20:11:16 +0000244
Paul Bakker6083fd22011-12-03 21:45:14 +0000245 /*
246 * Run through our entropy sources
247 */
248 for( i = 0; i < ctx->source_count; i++ )
249 {
Manuel Pégourié-Gonnard7580ba42015-06-19 10:26:32 +0200250 if( ctx->source[i].strong == MBEDTLS_ENTROPY_SOURCE_STRONG )
251 have_one_strong = 1;
252
Paul Bakker6083fd22011-12-03 21:45:14 +0000253 olen = 0;
Paul Bakker66d5d072014-06-17 16:39:18 +0200254 if( ( ret = ctx->source[i].f_source( ctx->source[i].p_source,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200255 buf, MBEDTLS_ENTROPY_MAX_GATHER, &olen ) ) != 0 )
Paul Bakker6083fd22011-12-03 21:45:14 +0000256 {
Andres Amaya Garcia1adcd952017-06-26 09:58:59 +0100257 goto cleanup;
Paul Bakker6083fd22011-12-03 21:45:14 +0000258 }
259
260 /*
261 * Add if we actually gathered something
262 */
263 if( olen > 0 )
Paul Bakkerbd4a9d02011-12-10 17:02:19 +0000264 {
Andres Amaya Garcia95869c42017-06-29 16:31:44 +0100265 if( ( ret = entropy_update( ctx, (unsigned char) i,
266 buf, olen ) ) != 0 )
267 return( ret );
Paul Bakkerbd4a9d02011-12-10 17:02:19 +0000268 ctx->source[i].size += olen;
269 }
Paul Bakker6083fd22011-12-03 21:45:14 +0000270 }
271
Manuel Pégourié-Gonnard7580ba42015-06-19 10:26:32 +0200272 if( have_one_strong == 0 )
Andres Amaya Garcia1adcd952017-06-26 09:58:59 +0100273 ret = MBEDTLS_ERR_ENTROPY_NO_STRONG_SOURCE;
Manuel Pégourié-Gonnard7580ba42015-06-19 10:26:32 +0200274
Andres Amaya Garcia1adcd952017-06-26 09:58:59 +0100275cleanup:
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500276 mbedtls_platform_zeroize( buf, sizeof( buf ) );
Andres Amaya Garcia1adcd952017-06-26 09:58:59 +0100277
278 return( ret );
Paul Bakker6083fd22011-12-03 21:45:14 +0000279}
280
Paul Bakker47703a02014-02-06 15:01:20 +0100281/*
282 * Thread-safe wrapper for entropy_gather_internal()
283 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200284int mbedtls_entropy_gather( mbedtls_entropy_context *ctx )
Paul Bakker47703a02014-02-06 15:01:20 +0100285{
Janos Follath24eed8d2019-11-22 13:21:35 +0000286 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker47703a02014-02-06 15:01:20 +0100287
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200288#if defined(MBEDTLS_THREADING_C)
289 if( ( ret = mbedtls_mutex_lock( &ctx->mutex ) ) != 0 )
Paul Bakkerddd427a2014-04-09 14:47:58 +0200290 return( ret );
Paul Bakker47703a02014-02-06 15:01:20 +0100291#endif
292
Paul Bakkerddd427a2014-04-09 14:47:58 +0200293 ret = entropy_gather_internal( ctx );
Paul Bakker47703a02014-02-06 15:01:20 +0100294
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200295#if defined(MBEDTLS_THREADING_C)
296 if( mbedtls_mutex_unlock( &ctx->mutex ) != 0 )
297 return( MBEDTLS_ERR_THREADING_MUTEX_ERROR );
Paul Bakker47703a02014-02-06 15:01:20 +0100298#endif
299
Paul Bakkerddd427a2014-04-09 14:47:58 +0200300 return( ret );
Paul Bakker47703a02014-02-06 15:01:20 +0100301}
302
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200303int mbedtls_entropy_func( void *data, unsigned char *output, size_t len )
Paul Bakker6083fd22011-12-03 21:45:14 +0000304{
Gilles Peskine85485c72019-10-08 15:04:16 +0200305 int ret, count = 0, i, thresholds_reached;
306 size_t strong_size;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200307 mbedtls_entropy_context *ctx = (mbedtls_entropy_context *) data;
308 unsigned char buf[MBEDTLS_ENTROPY_BLOCK_SIZE];
Paul Bakker6083fd22011-12-03 21:45:14 +0000309
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200310 if( len > MBEDTLS_ENTROPY_BLOCK_SIZE )
311 return( MBEDTLS_ERR_ENTROPY_SOURCE_FAILED );
Paul Bakker6083fd22011-12-03 21:45:14 +0000312
Paul Bakkerd5c9f6d2016-06-01 11:30:54 +0100313#if defined(MBEDTLS_ENTROPY_NV_SEED)
314 /* Update the NV entropy seed before generating any entropy for outside
315 * use.
316 */
Paul Bakkerfc9c7c82016-06-01 15:25:50 +0100317 if( ctx->initial_entropy_run == 0 )
Paul Bakkerd5c9f6d2016-06-01 11:30:54 +0100318 {
Paul Bakkerfc9c7c82016-06-01 15:25:50 +0100319 ctx->initial_entropy_run = 1;
Paul Bakkerd5c9f6d2016-06-01 11:30:54 +0100320 if( ( ret = mbedtls_entropy_update_nv_seed( ctx ) ) != 0 )
321 return( ret );
322 }
323#endif
324
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200325#if defined(MBEDTLS_THREADING_C)
326 if( ( ret = mbedtls_mutex_lock( &ctx->mutex ) ) != 0 )
Paul Bakkerf4e7dc52013-09-28 15:23:57 +0200327 return( ret );
328#endif
329
Paul Bakker6083fd22011-12-03 21:45:14 +0000330 /*
331 * Always gather extra entropy before a call
332 */
333 do
334 {
335 if( count++ > ENTROPY_MAX_LOOP )
Paul Bakkerf4e7dc52013-09-28 15:23:57 +0200336 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200337 ret = MBEDTLS_ERR_ENTROPY_SOURCE_FAILED;
Paul Bakkerf4e7dc52013-09-28 15:23:57 +0200338 goto exit;
339 }
Paul Bakker6083fd22011-12-03 21:45:14 +0000340
Paul Bakker47703a02014-02-06 15:01:20 +0100341 if( ( ret = entropy_gather_internal( ctx ) ) != 0 )
Paul Bakkerf4e7dc52013-09-28 15:23:57 +0200342 goto exit;
Paul Bakkerbd4a9d02011-12-10 17:02:19 +0000343
Gilles Peskine85485c72019-10-08 15:04:16 +0200344 thresholds_reached = 1;
345 strong_size = 0;
Paul Bakkerbd4a9d02011-12-10 17:02:19 +0000346 for( i = 0; i < ctx->source_count; i++ )
Gilles Peskine85485c72019-10-08 15:04:16 +0200347 {
Manuel Pégourié-Gonnardbf82ff02015-06-19 09:40:51 +0200348 if( ctx->source[i].size < ctx->source[i].threshold )
Gilles Peskine85485c72019-10-08 15:04:16 +0200349 thresholds_reached = 0;
350 if( ctx->source[i].strong == MBEDTLS_ENTROPY_SOURCE_STRONG )
351 strong_size += ctx->source[i].size;
352 }
Paul Bakker6083fd22011-12-03 21:45:14 +0000353 }
Gilles Peskine85485c72019-10-08 15:04:16 +0200354 while( ! thresholds_reached || strong_size < MBEDTLS_ENTROPY_BLOCK_SIZE );
Paul Bakker6083fd22011-12-03 21:45:14 +0000355
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200356 memset( buf, 0, MBEDTLS_ENTROPY_BLOCK_SIZE );
Paul Bakker6083fd22011-12-03 21:45:14 +0000357
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200358#if defined(MBEDTLS_ENTROPY_SHA512_ACCUMULATOR)
Andres Amaya Garciab2b063f2017-07-20 16:45:24 +0100359 /*
360 * Note that at this stage it is assumed that the accumulator was started
361 * in a previous call to entropy_update(). If this is not guaranteed, the
362 * code below will fail.
363 */
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100364 if( ( ret = mbedtls_sha512_finish_ret( &ctx->accumulator, buf ) ) != 0 )
Andres Amaya Garcia207cea52017-06-29 13:28:13 +0100365 goto exit;
Paul Bakker9e36f042013-06-30 14:34:05 +0200366
Paul Bakker6083fd22011-12-03 21:45:14 +0000367 /*
Paul Bakkerbd4a9d02011-12-10 17:02:19 +0000368 * Reset accumulator and counters and recycle existing entropy
Paul Bakker6083fd22011-12-03 21:45:14 +0000369 */
Andres Amaya Garciaa7559cb2017-06-29 16:12:31 +0100370 mbedtls_sha512_free( &ctx->accumulator );
371 mbedtls_sha512_init( &ctx->accumulator );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100372 if( ( ret = mbedtls_sha512_starts_ret( &ctx->accumulator, 0 ) ) != 0 )
Andres Amaya Garcia207cea52017-06-29 13:28:13 +0100373 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100374 if( ( ret = mbedtls_sha512_update_ret( &ctx->accumulator, buf,
Andres Amaya Garcia207cea52017-06-29 13:28:13 +0100375 MBEDTLS_ENTROPY_BLOCK_SIZE ) ) != 0 )
376 goto exit;
Paul Bakkerfb08fd22013-08-27 15:06:26 +0200377
378 /*
Paul Bakkerb13d3ff2014-03-26 12:51:25 +0100379 * Perform second SHA-512 on entropy
Paul Bakkerfb08fd22013-08-27 15:06:26 +0200380 */
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100381 if( ( ret = mbedtls_sha512_ret( buf, MBEDTLS_ENTROPY_BLOCK_SIZE,
Andres Amaya Garcia207cea52017-06-29 13:28:13 +0100382 buf, 0 ) ) != 0 )
383 goto exit;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200384#else /* MBEDTLS_ENTROPY_SHA512_ACCUMULATOR */
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100385 if( ( ret = mbedtls_sha256_finish_ret( &ctx->accumulator, buf ) ) != 0 )
Andres Amaya Garcia207cea52017-06-29 13:28:13 +0100386 goto exit;
Paul Bakkerfb08fd22013-08-27 15:06:26 +0200387
388 /*
389 * Reset accumulator and counters and recycle existing entropy
390 */
Andres Amaya Garciaa7559cb2017-06-29 16:12:31 +0100391 mbedtls_sha256_free( &ctx->accumulator );
392 mbedtls_sha256_init( &ctx->accumulator );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100393 if( ( ret = mbedtls_sha256_starts_ret( &ctx->accumulator, 0 ) ) != 0 )
Andres Amaya Garcia207cea52017-06-29 13:28:13 +0100394 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100395 if( ( ret = mbedtls_sha256_update_ret( &ctx->accumulator, buf,
Andres Amaya Garcia207cea52017-06-29 13:28:13 +0100396 MBEDTLS_ENTROPY_BLOCK_SIZE ) ) != 0 )
397 goto exit;
Paul Bakkerb13d3ff2014-03-26 12:51:25 +0100398
399 /*
400 * Perform second SHA-256 on entropy
401 */
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100402 if( ( ret = mbedtls_sha256_ret( buf, MBEDTLS_ENTROPY_BLOCK_SIZE,
Andres Amaya Garcia207cea52017-06-29 13:28:13 +0100403 buf, 0 ) ) != 0 )
404 goto exit;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200405#endif /* MBEDTLS_ENTROPY_SHA512_ACCUMULATOR */
Paul Bakkerbd4a9d02011-12-10 17:02:19 +0000406
407 for( i = 0; i < ctx->source_count; i++ )
408 ctx->source[i].size = 0;
Paul Bakker6083fd22011-12-03 21:45:14 +0000409
410 memcpy( output, buf, len );
411
Paul Bakkerf4e7dc52013-09-28 15:23:57 +0200412 ret = 0;
413
414exit:
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500415 mbedtls_platform_zeroize( buf, sizeof( buf ) );
Andres Amaya Garcia1adcd952017-06-26 09:58:59 +0100416
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200417#if defined(MBEDTLS_THREADING_C)
418 if( mbedtls_mutex_unlock( &ctx->mutex ) != 0 )
419 return( MBEDTLS_ERR_THREADING_MUTEX_ERROR );
Paul Bakkerf4e7dc52013-09-28 15:23:57 +0200420#endif
421
422 return( ret );
Paul Bakker6083fd22011-12-03 21:45:14 +0000423}
424
Paul Bakkerd5c9f6d2016-06-01 11:30:54 +0100425#if defined(MBEDTLS_ENTROPY_NV_SEED)
426int mbedtls_entropy_update_nv_seed( mbedtls_entropy_context *ctx )
427{
428 int ret = MBEDTLS_ERR_ENTROPY_FILE_IO_ERROR;
Andres Amaya Garciaaf0b31d2017-07-05 14:23:54 +0100429 unsigned char buf[MBEDTLS_ENTROPY_BLOCK_SIZE];
Paul Bakkerd5c9f6d2016-06-01 11:30:54 +0100430
431 /* Read new seed and write it to NV */
432 if( ( ret = mbedtls_entropy_func( ctx, buf, MBEDTLS_ENTROPY_BLOCK_SIZE ) ) != 0 )
433 return( ret );
434
435 if( mbedtls_nv_seed_write( buf, MBEDTLS_ENTROPY_BLOCK_SIZE ) < 0 )
436 return( MBEDTLS_ERR_ENTROPY_FILE_IO_ERROR );
437
438 /* Manually update the remaining stream with a separator value to diverge */
439 memset( buf, 0, MBEDTLS_ENTROPY_BLOCK_SIZE );
Andres Amaya Garcia1adcd952017-06-26 09:58:59 +0100440 ret = mbedtls_entropy_update_manual( ctx, buf, MBEDTLS_ENTROPY_BLOCK_SIZE );
Paul Bakkerd5c9f6d2016-06-01 11:30:54 +0100441
Andres Amaya Garcia1adcd952017-06-26 09:58:59 +0100442 return( ret );
Paul Bakkerd5c9f6d2016-06-01 11:30:54 +0100443}
444#endif /* MBEDTLS_ENTROPY_NV_SEED */
445
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200446#if defined(MBEDTLS_FS_IO)
447int mbedtls_entropy_write_seed_file( mbedtls_entropy_context *ctx, const char *path )
Paul Bakker66ff70d2014-03-26 11:54:05 +0100448{
Victor Krasnoshchoka0c2d192020-09-03 00:07:05 +0300449 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Victor Krasnoshchoke79812e2020-08-27 00:19:55 +0300450 FILE *f = NULL;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200451 unsigned char buf[MBEDTLS_ENTROPY_BLOCK_SIZE];
Paul Bakker66ff70d2014-03-26 11:54:05 +0100452
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200453 if( ( ret = mbedtls_entropy_func( ctx, buf, MBEDTLS_ENTROPY_BLOCK_SIZE ) ) != 0 )
Paul Bakker66ff70d2014-03-26 11:54:05 +0100454 {
Victor Krasnoshchokb3129ba2020-08-29 22:54:37 +0300455 ret = MBEDTLS_ERR_ENTROPY_SOURCE_FAILED;
Paul Bakker66ff70d2014-03-26 11:54:05 +0100456 goto exit;
Victor Krasnoshchokb3129ba2020-08-29 22:54:37 +0300457 }
458
459 if( ( f = fopen( path, "wb" ) ) == NULL )
460 {
461 ret = MBEDTLS_ERR_ENTROPY_FILE_IO_ERROR;
462 goto exit;
463 }
Paul Bakker66ff70d2014-03-26 11:54:05 +0100464
465 if( fwrite( buf, 1, MBEDTLS_ENTROPY_BLOCK_SIZE, f ) != MBEDTLS_ENTROPY_BLOCK_SIZE )
466 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200467 ret = MBEDTLS_ERR_ENTROPY_FILE_IO_ERROR;
Paul Bakker66ff70d2014-03-26 11:54:05 +0100468 goto exit;
469 }
470
471 ret = 0;
472
473exit:
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500474 mbedtls_platform_zeroize( buf, sizeof( buf ) );
Andres Amaya Garcia1adcd952017-06-26 09:58:59 +0100475
Victor Krasnoshchokb3129ba2020-08-29 22:54:37 +0300476 if( f != NULL )
Victor Krasnoshchoke79812e2020-08-27 00:19:55 +0300477 fclose( f );
478
Paul Bakker66ff70d2014-03-26 11:54:05 +0100479 return( ret );
480}
481
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200482int mbedtls_entropy_update_seed_file( mbedtls_entropy_context *ctx, const char *path )
Paul Bakker66ff70d2014-03-26 11:54:05 +0100483{
Andres Amaya Garcia1adcd952017-06-26 09:58:59 +0100484 int ret = 0;
Paul Bakker66ff70d2014-03-26 11:54:05 +0100485 FILE *f;
486 size_t n;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200487 unsigned char buf[ MBEDTLS_ENTROPY_MAX_SEED_SIZE ];
Paul Bakker66ff70d2014-03-26 11:54:05 +0100488
489 if( ( f = fopen( path, "rb" ) ) == NULL )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200490 return( MBEDTLS_ERR_ENTROPY_FILE_IO_ERROR );
Paul Bakker66ff70d2014-03-26 11:54:05 +0100491
492 fseek( f, 0, SEEK_END );
493 n = (size_t) ftell( f );
494 fseek( f, 0, SEEK_SET );
495
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200496 if( n > MBEDTLS_ENTROPY_MAX_SEED_SIZE )
497 n = MBEDTLS_ENTROPY_MAX_SEED_SIZE;
Paul Bakker66ff70d2014-03-26 11:54:05 +0100498
499 if( fread( buf, 1, n, f ) != n )
Andres Amaya Garcia1adcd952017-06-26 09:58:59 +0100500 ret = MBEDTLS_ERR_ENTROPY_FILE_IO_ERROR;
501 else
502 ret = mbedtls_entropy_update_manual( ctx, buf, n );
Paul Bakker66ff70d2014-03-26 11:54:05 +0100503
504 fclose( f );
505
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500506 mbedtls_platform_zeroize( buf, sizeof( buf ) );
Andres Amaya Garcia1adcd952017-06-26 09:58:59 +0100507
508 if( ret != 0 )
509 return( ret );
Paul Bakker66ff70d2014-03-26 11:54:05 +0100510
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200511 return( mbedtls_entropy_write_seed_file( ctx, path ) );
Paul Bakker66ff70d2014-03-26 11:54:05 +0100512}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200513#endif /* MBEDTLS_FS_IO */
Paul Bakker66ff70d2014-03-26 11:54:05 +0100514
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200515#if defined(MBEDTLS_SELF_TEST)
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200516/*
517 * Dummy source function
518 */
519static int entropy_dummy_source( void *data, unsigned char *output,
520 size_t len, size_t *olen )
521{
522 ((void) data);
523
524 memset( output, 0x2a, len );
525 *olen = len;
526
527 return( 0 );
528}
529
Andres AGe7723ec2016-08-25 10:18:50 +0100530#if defined(MBEDTLS_ENTROPY_HARDWARE_ALT)
Andres AGb34e42e2016-08-22 11:08:50 +0100531
Andres AGe7723ec2016-08-25 10:18:50 +0100532static int mbedtls_entropy_source_self_test_gather( unsigned char *buf, size_t buf_len )
533{
534 int ret = 0;
535 size_t entropy_len = 0;
536 size_t olen = 0;
537 size_t attempts = buf_len;
538
539 while( attempts > 0 && entropy_len < buf_len )
540 {
541 if( ( ret = mbedtls_hardware_poll( NULL, buf + entropy_len,
542 buf_len - entropy_len, &olen ) ) != 0 )
543 return( ret );
544
545 entropy_len += olen;
546 attempts--;
547 }
548
549 if( entropy_len < buf_len )
550 {
551 ret = 1;
552 }
553
554 return( ret );
555}
556
557
558static int mbedtls_entropy_source_self_test_check_bits( const unsigned char *buf,
559 size_t buf_len )
560{
561 unsigned char set= 0xFF;
562 unsigned char unset = 0x00;
563 size_t i;
564
565 for( i = 0; i < buf_len; i++ )
566 {
567 set &= buf[i];
568 unset |= buf[i];
569 }
570
571 return( set == 0xFF || unset == 0x00 );
572}
Andres AGb34e42e2016-08-22 11:08:50 +0100573
574/*
Andres AGe7723ec2016-08-25 10:18:50 +0100575 * A test to ensure hat the entropy sources are functioning correctly
576 * and there is no obvious failure. The test performs the following checks:
Andres AGb34e42e2016-08-22 11:08:50 +0100577 * - The entropy source is not providing only 0s (all bits unset) or 1s (all
578 * bits set).
579 * - The entropy source is not providing values in a pattern. Because the
Andres AGe7723ec2016-08-25 10:18:50 +0100580 * hardware could be providing data in an arbitrary length, this check polls
581 * the hardware entropy source twice and compares the result to ensure they
582 * are not equal.
Andres AGb34e42e2016-08-22 11:08:50 +0100583 * - The error code returned by the entropy source is not an error.
584 */
Andres AGe7723ec2016-08-25 10:18:50 +0100585int mbedtls_entropy_source_self_test( int verbose )
Andres AGb34e42e2016-08-22 11:08:50 +0100586{
587 int ret = 0;
Andres AGe7723ec2016-08-25 10:18:50 +0100588 unsigned char buf0[2 * sizeof( unsigned long long int )];
589 unsigned char buf1[2 * sizeof( unsigned long long int )];
Andres AGb34e42e2016-08-22 11:08:50 +0100590
591 if( verbose != 0 )
592 mbedtls_printf( " ENTROPY_BIAS test: " );
593
Andres AGe7723ec2016-08-25 10:18:50 +0100594 memset( buf0, 0x00, sizeof( buf0 ) );
595 memset( buf1, 0x00, sizeof( buf1 ) );
Andres AGb34e42e2016-08-22 11:08:50 +0100596
Andres AGe7723ec2016-08-25 10:18:50 +0100597 if( ( ret = mbedtls_entropy_source_self_test_gather( buf0, sizeof( buf0 ) ) ) != 0 )
Andres AGb34e42e2016-08-22 11:08:50 +0100598 goto cleanup;
Andres AGe7723ec2016-08-25 10:18:50 +0100599 if( ( ret = mbedtls_entropy_source_self_test_gather( buf1, sizeof( buf1 ) ) ) != 0 )
600 goto cleanup;
601
602 /* Make sure that the returned values are not all 0 or 1 */
603 if( ( ret = mbedtls_entropy_source_self_test_check_bits( buf0, sizeof( buf0 ) ) ) != 0 )
604 goto cleanup;
605 if( ( ret = mbedtls_entropy_source_self_test_check_bits( buf1, sizeof( buf1 ) ) ) != 0 )
606 goto cleanup;
Andres AGb34e42e2016-08-22 11:08:50 +0100607
608 /* Make sure that the entropy source is not returning values in a
609 * pattern */
Andres AGe7723ec2016-08-25 10:18:50 +0100610 ret = memcmp( buf0, buf1, sizeof( buf0 ) ) == 0;
Andres AGb34e42e2016-08-22 11:08:50 +0100611
612cleanup:
Andres AGb34e42e2016-08-22 11:08:50 +0100613 if( verbose != 0 )
614 {
615 if( ret != 0 )
616 mbedtls_printf( "failed\n" );
617 else
618 mbedtls_printf( "passed\n" );
619
620 mbedtls_printf( "\n" );
621 }
622
623 return( ret != 0 );
624}
Andres AGe7723ec2016-08-25 10:18:50 +0100625
626#endif /* MBEDTLS_ENTROPY_HARDWARE_ALT */
Andres AGb34e42e2016-08-22 11:08:50 +0100627
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200628/*
629 * The actual entropy quality is hard to test, but we can at least
630 * test that the functions don't cause errors and write the correct
631 * amount of data to buffers.
632 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200633int mbedtls_entropy_self_test( int verbose )
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200634{
Andres Amaya Garciaa928e672016-09-13 13:30:02 +0100635 int ret = 1;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200636 mbedtls_entropy_context ctx;
637 unsigned char buf[MBEDTLS_ENTROPY_BLOCK_SIZE] = { 0 };
638 unsigned char acc[MBEDTLS_ENTROPY_BLOCK_SIZE] = { 0 };
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200639 size_t i, j;
640
641 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200642 mbedtls_printf( " ENTROPY test: " );
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200643
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200644 mbedtls_entropy_init( &ctx );
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200645
Manuel Pégourié-Gonnard7580ba42015-06-19 10:26:32 +0200646 /* First do a gather to make sure we have default sources */
Manuel Pégourié-Gonnarde94bfe62015-05-14 13:57:50 +0200647 if( ( ret = mbedtls_entropy_gather( &ctx ) ) != 0 )
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200648 goto cleanup;
649
Manuel Pégourié-Gonnard7580ba42015-06-19 10:26:32 +0200650 ret = mbedtls_entropy_add_source( &ctx, entropy_dummy_source, NULL, 16,
651 MBEDTLS_ENTROPY_SOURCE_WEAK );
Manuel Pégourié-Gonnarde94bfe62015-05-14 13:57:50 +0200652 if( ret != 0 )
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200653 goto cleanup;
654
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200655 if( ( ret = mbedtls_entropy_update_manual( &ctx, buf, sizeof buf ) ) != 0 )
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200656 goto cleanup;
657
658 /*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200659 * To test that mbedtls_entropy_func writes correct number of bytes:
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200660 * - use the whole buffer and rely on ASan to detect overruns
661 * - collect entropy 8 times and OR the result in an accumulator:
662 * any byte should then be 0 with probably 2^(-64), so requiring
663 * each of the 32 or 64 bytes to be non-zero has a false failure rate
664 * of at most 2^(-58) which is acceptable.
665 */
666 for( i = 0; i < 8; i++ )
667 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200668 if( ( ret = mbedtls_entropy_func( &ctx, buf, sizeof( buf ) ) ) != 0 )
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200669 goto cleanup;
670
671 for( j = 0; j < sizeof( buf ); j++ )
672 acc[j] |= buf[j];
673 }
674
675 for( j = 0; j < sizeof( buf ); j++ )
676 {
677 if( acc[j] == 0 )
678 {
679 ret = 1;
680 goto cleanup;
681 }
682 }
683
Andres AGe7723ec2016-08-25 10:18:50 +0100684#if defined(MBEDTLS_ENTROPY_HARDWARE_ALT)
685 if( ( ret = mbedtls_entropy_source_self_test( 0 ) ) != 0 )
686 goto cleanup;
687#endif
688
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200689cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200690 mbedtls_entropy_free( &ctx );
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200691
692 if( verbose != 0 )
693 {
694 if( ret != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200695 mbedtls_printf( "failed\n" );
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200696 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200697 mbedtls_printf( "passed\n" );
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200698
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200699 mbedtls_printf( "\n" );
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200700 }
701
702 return( ret != 0 );
703}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200704#endif /* MBEDTLS_SELF_TEST */
Manuel Pégourié-Gonnard4dd73922014-05-30 10:34:15 +0200705
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200706#endif /* MBEDTLS_ENTROPY_C */