havege.h 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475
  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. #include <stddef.h>
  27. #define MBEDTLS_HAVEGE_COLLECT_SIZE 1024
  28. #ifdef __cplusplus
  29. extern "C" {
  30. #endif
  31. /**
  32. * \brief HAVEGE state structure
  33. */
  34. typedef struct
  35. {
  36. int PT1, PT2, offset[2];
  37. int pool[MBEDTLS_HAVEGE_COLLECT_SIZE];
  38. int WALK[8192];
  39. }
  40. mbedtls_havege_state;
  41. /**
  42. * \brief HAVEGE initialization
  43. *
  44. * \param hs HAVEGE state to be initialized
  45. */
  46. void mbedtls_havege_init( mbedtls_havege_state *hs );
  47. /**
  48. * \brief Clear HAVEGE state
  49. *
  50. * \param hs HAVEGE state to be cleared
  51. */
  52. void mbedtls_havege_free( mbedtls_havege_state *hs );
  53. /**
  54. * \brief HAVEGE rand function
  55. *
  56. * \param p_rng A HAVEGE state
  57. * \param output Buffer to fill
  58. * \param len Length of buffer
  59. *
  60. * \return 0
  61. */
  62. int mbedtls_havege_random( void *p_rng, unsigned char *output, size_t len );
  63. #ifdef __cplusplus
  64. }
  65. #endif
  66. #endif /* havege.h */