git.sur5r.net Git - freertos/blob - FreeRTOS-Labs/Source/mbedtls/include/mbedtls/havege.h

   1 /**\r
   2  * \file havege.h\r
   3  *\r
   4  * \brief HAVEGE: HArdware Volatile Entropy Gathering and Expansion\r
   5  */\r
   6 /*\r
   7  *  Copyright (C) 2006-2015, ARM Limited, All Rights Reserved\r
   8  *  SPDX-License-Identifier: Apache-2.0\r
   9  *\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
  13  *\r
  14  *  http://www.apache.org/licenses/LICENSE-2.0\r
  15  *\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
  21  *\r
  22  *  This file is part of mbed TLS (https://tls.mbed.org)\r
  23  */\r
  24 #ifndef MBEDTLS_HAVEGE_H\r
  25 #define MBEDTLS_HAVEGE_H\r
  26 \r
  27 #if !defined(MBEDTLS_CONFIG_FILE)\r
  28 #include "config.h"\r
  29 #else\r
  30 #include MBEDTLS_CONFIG_FILE\r
  31 #endif\r
  32 \r
  33 #include <stddef.h>\r
  34 \r
  35 #define MBEDTLS_HAVEGE_COLLECT_SIZE 1024\r
  36 \r
  37 #ifdef __cplusplus\r
  38 extern "C" {\r
  39 #endif\r
  40 \r
  41 /**\r
  42  * \brief          HAVEGE state structure\r
  43  */\r
  44 typedef struct mbedtls_havege_state\r
  45 {\r
  46     int PT1, PT2, offset[2];\r
  47     int pool[MBEDTLS_HAVEGE_COLLECT_SIZE];\r
  48     int WALK[8192];\r
  49 }\r
  50 mbedtls_havege_state;\r
  51 \r
  52 /**\r
  53  * \brief          HAVEGE initialization\r
  54  *\r
  55  * \param hs       HAVEGE state to be initialized\r
  56  */\r
  57 void mbedtls_havege_init( mbedtls_havege_state *hs );\r
  58 \r
  59 /**\r
  60  * \brief          Clear HAVEGE state\r
  61  *\r
  62  * \param hs       HAVEGE state to be cleared\r
  63  */\r
  64 void mbedtls_havege_free( mbedtls_havege_state *hs );\r
  65 \r
  66 /**\r
  67  * \brief          HAVEGE rand function\r
  68  *\r
  69  * \param p_rng    A HAVEGE state\r
  70  * \param output   Buffer to fill\r
  71  * \param len      Length of buffer\r
  72  *\r
  73  * \return         0\r
  74  */\r
  75 int mbedtls_havege_random( void *p_rng, unsigned char *output, size_t len );\r
  76 \r
  77 #ifdef __cplusplus\r
  78 }\r
  79 #endif\r
  80 \r
  81 #endif /* havege.h */\r