havege.h 1.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081
  1. /**
  2. * \file havege.h
  3. *
  4. * \brief HAVEGE: HArdware Volatile Entropy Gathering and Expansion
  5. */
  6. /*
  7. * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
  8. * SPDX-License-Identifier: Apache-2.0
  9. *
  10. * Licensed under the Apache License, Version 2.0 (the "License"); you may
  11. * not use this file except in compliance with the License.
  12. * You may obtain a copy of the License at
  13. *
  14. * http://www.apache.org/licenses/LICENSE-2.0
  15. *
  16. * Unless required by applicable law or agreed to in writing, software
  17. * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  18. * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  19. * See the License for the specific language governing permissions and
  20. * limitations under the License.
  21. *
  22. * This file is part of mbed TLS (https://tls.mbed.org)
  23. */
  24. #ifndef MBEDTLS_HAVEGE_H
  25. #define MBEDTLS_HAVEGE_H
  26. #if !defined(MBEDTLS_CONFIG_FILE)
  27. #include "config.h"
  28. #else
  29. #include MBEDTLS_CONFIG_FILE
  30. #endif
  31. #include <stddef.h>
  32. #define MBEDTLS_HAVEGE_COLLECT_SIZE 1024
  33. #ifdef __cplusplus
  34. extern "C" {
  35. #endif
  36. /**
  37. * \brief HAVEGE state structure
  38. */
  39. typedef struct mbedtls_havege_state
  40. {
  41. int PT1, PT2, offset[2];
  42. int pool[MBEDTLS_HAVEGE_COLLECT_SIZE];
  43. int WALK[8192];
  44. }
  45. mbedtls_havege_state;
  46. /**
  47. * \brief HAVEGE initialization
  48. *
  49. * \param hs HAVEGE state to be initialized
  50. */
  51. void mbedtls_havege_init( mbedtls_havege_state *hs );
  52. /**
  53. * \brief Clear HAVEGE state
  54. *
  55. * \param hs HAVEGE state to be cleared
  56. */
  57. void mbedtls_havege_free( mbedtls_havege_state *hs );
  58. /**
  59. * \brief HAVEGE rand function
  60. *
  61. * \param p_rng A HAVEGE state
  62. * \param output Buffer to fill
  63. * \param len Length of buffer
  64. *
  65. * \return 0
  66. */
  67. int mbedtls_havege_random( void *p_rng, unsigned char *output, size_t len );
  68. #ifdef __cplusplus
  69. }
  70. #endif
  71. #endif /* havege.h */