2 * \file entropy_poll.h
\r
4 * \brief Platform-specific and custom entropy polling functions
\r
7 * Copyright (C) 2006-2016, ARM Limited, All Rights Reserved
\r
8 * SPDX-License-Identifier: Apache-2.0
\r
10 * Licensed under the Apache License, Version 2.0 (the "License"); you may
\r
11 * not use this file except in compliance with the License.
\r
12 * You may obtain a copy of the License at
\r
14 * http://www.apache.org/licenses/LICENSE-2.0
\r
16 * Unless required by applicable law or agreed to in writing, software
\r
17 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
\r
18 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
\r
19 * See the License for the specific language governing permissions and
\r
20 * limitations under the License.
\r
22 * This file is part of mbed TLS (https://tls.mbed.org)
\r
24 #ifndef MBEDTLS_ENTROPY_POLL_H
\r
25 #define MBEDTLS_ENTROPY_POLL_H
\r
27 #if !defined(MBEDTLS_CONFIG_FILE)
\r
30 #include MBEDTLS_CONFIG_FILE
\r
40 * Default thresholds for built-in sources, in bytes
\r
42 #define MBEDTLS_ENTROPY_MIN_PLATFORM 32 /**< Minimum for platform source */
\r
43 #define MBEDTLS_ENTROPY_MIN_HAVEGE 32 /**< Minimum for HAVEGE */
\r
44 #define MBEDTLS_ENTROPY_MIN_HARDCLOCK 4 /**< Minimum for mbedtls_timing_hardclock() */
\r
45 #if !defined(MBEDTLS_ENTROPY_MIN_HARDWARE)
\r
46 #define MBEDTLS_ENTROPY_MIN_HARDWARE 32 /**< Minimum for the hardware source */
\r
50 * \brief Entropy poll callback that provides 0 entropy.
\r
52 #if defined(MBEDTLS_TEST_NULL_ENTROPY)
\r
53 int mbedtls_null_entropy_poll( void *data,
\r
54 unsigned char *output, size_t len, size_t *olen );
\r
57 #if !defined(MBEDTLS_NO_PLATFORM_ENTROPY)
\r
59 * \brief Platform-specific entropy poll callback
\r
61 int mbedtls_platform_entropy_poll( void *data,
\r
62 unsigned char *output, size_t len, size_t *olen );
\r
65 #if defined(MBEDTLS_HAVEGE_C)
\r
67 * \brief HAVEGE based entropy poll callback
\r
69 * Requires an HAVEGE state as its data pointer.
\r
71 int mbedtls_havege_poll( void *data,
\r
72 unsigned char *output, size_t len, size_t *olen );
\r
75 #if defined(MBEDTLS_TIMING_C)
\r
77 * \brief mbedtls_timing_hardclock-based entropy poll callback
\r
79 int mbedtls_hardclock_poll( void *data,
\r
80 unsigned char *output, size_t len, size_t *olen );
\r
83 #if defined(MBEDTLS_ENTROPY_HARDWARE_ALT)
\r
85 * \brief Entropy poll callback for a hardware source
\r
87 * \warning This is not provided by mbed TLS!
\r
88 * See \c MBEDTLS_ENTROPY_HARDWARE_ALT in config.h.
\r
90 * \note This must accept NULL as its first argument.
\r
92 int mbedtls_hardware_poll( void *data,
\r
93 unsigned char *output, size_t len, size_t *olen );
\r
96 #if defined(MBEDTLS_ENTROPY_NV_SEED)
\r
98 * \brief Entropy poll callback for a non-volatile seed file
\r
100 * \note This must accept NULL as its first argument.
\r
102 int mbedtls_nv_seed_poll( void *data,
\r
103 unsigned char *output, size_t len, size_t *olen );
\r
110 #endif /* entropy_poll.h */
\r