/* MIT License * * Copyright (c) 2016-2022 INRIA, CMU and Microsoft Corporation * Copyright (c) 2022-2023 HACL* Contributors * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ #ifndef __Hacl_HMAC_DRBG_H #define __Hacl_HMAC_DRBG_H #if defined(__cplusplus) extern "C" { #endif #include #include "krml/internal/types.h" #include "krml/lowstar_endianness.h" #include "krml/internal/target.h" #include "Hacl_Streaming_Types.h" #include "Hacl_HMAC.h" typedef Spec_Hash_Definitions_hash_alg Hacl_HMAC_DRBG_supported_alg; extern uint32_t Hacl_HMAC_DRBG_reseed_interval; extern uint32_t Hacl_HMAC_DRBG_max_output_length; extern uint32_t Hacl_HMAC_DRBG_max_length; extern uint32_t Hacl_HMAC_DRBG_max_personalization_string_length; extern uint32_t Hacl_HMAC_DRBG_max_additional_input_length; /** Return the minimal entropy input length of the desired hash function. @param a Hash algorithm to use. */ uint32_t Hacl_HMAC_DRBG_min_length(Spec_Hash_Definitions_hash_alg a); typedef struct Hacl_HMAC_DRBG_state_s { uint8_t *k; uint8_t *v; uint32_t *reseed_counter; } Hacl_HMAC_DRBG_state; bool Hacl_HMAC_DRBG_uu___is_State(Spec_Hash_Definitions_hash_alg a, Hacl_HMAC_DRBG_state projectee); /** Create a DRBG state. @param a Hash algorithm to use. The possible instantiations are ... * `Spec_Hash_Definitions_SHA2_256`, * `Spec_Hash_Definitions_SHA2_384`, * `Spec_Hash_Definitions_SHA2_512`, and * `Spec_Hash_Definitions_SHA1`. */ Hacl_HMAC_DRBG_state Hacl_HMAC_DRBG_create_in(Spec_Hash_Definitions_hash_alg a); /** Instantiate the DRBG. @param a Hash algorithm to use. (Value must match the value used in `Hacl_HMAC_DRBG_create_in`.) @param st Pointer to DRBG state. @param entropy_input_len Length of entropy input. @param entropy_input Pointer to `entropy_input_len` bytes of memory where entropy input is read from. @param nonce_len Length of nonce. @param nonce Pointer to `nonce_len` bytes of memory where nonce is read from. @param personalization_string_len length of personalization string. @param personalization_string Pointer to `personalization_string_len` bytes of memory where personalization string is read from. */ void Hacl_HMAC_DRBG_instantiate( Spec_Hash_Definitions_hash_alg a, Hacl_HMAC_DRBG_state st, uint32_t entropy_input_len, uint8_t *entropy_input, uint32_t nonce_len, uint8_t *nonce, uint32_t personalization_string_len, uint8_t *personalization_string ); /** Reseed the DRBG. @param a Hash algorithm to use. (Value must match the value used in `Hacl_HMAC_DRBG_create_in`.) @param st Pointer to DRBG state. @param entropy_input_len Length of entropy input. @param entropy_input Pointer to `entropy_input_len` bytes of memory where entropy input is read from. @param additional_input_input_len Length of additional input. @param additional_input_input Pointer to `additional_input_input_len` bytes of memory where additional input is read from. */ void Hacl_HMAC_DRBG_reseed( Spec_Hash_Definitions_hash_alg a, Hacl_HMAC_DRBG_state st, uint32_t entropy_input_len, uint8_t *entropy_input, uint32_t additional_input_input_len, uint8_t *additional_input_input ); /** Generate output. @param a Hash algorithm to use. (Value must match the value used in `create_in`.) @param output Pointer to `n` bytes of memory where random output is written to. @param st Pointer to DRBG state. @param n Length of desired output. @param additional_input_input_len Length of additional input. @param additional_input_input Pointer to `additional_input_input_len` bytes of memory where additional input is read from. */ bool Hacl_HMAC_DRBG_generate( Spec_Hash_Definitions_hash_alg a, uint8_t *output, Hacl_HMAC_DRBG_state st, uint32_t n, uint32_t additional_input_len, uint8_t *additional_input ); void Hacl_HMAC_DRBG_free(Spec_Hash_Definitions_hash_alg uu___, Hacl_HMAC_DRBG_state s); #if defined(__cplusplus) } #endif #define __Hacl_HMAC_DRBG_H_DEFINED #endif