mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2025-01-17 04:52:59 +01:00
Merge pull request #12418 from Rotzbua/doc_sha3
sys/hashes/sha3: docu rename hashes to FIPS 202 standard
This commit is contained in:
commit
2fb4a79d9a
@ -34,17 +34,17 @@ extern "C" {
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief Length of SHA256 digests in bytes
|
||||
* @brief Length of SHA3-256 digests in bytes
|
||||
*/
|
||||
#define SHA3_256_DIGEST_LENGTH 32
|
||||
|
||||
/**
|
||||
* @brief Length of SHA384 digests in bytes
|
||||
* @brief Length of SHA3-384 digests in bytes
|
||||
*/
|
||||
#define SHA3_384_DIGEST_LENGTH 48
|
||||
|
||||
/**
|
||||
* @brief Length of SHA512 digests in bytes
|
||||
* @brief Length of SHA3-512 digests in bytes
|
||||
*/
|
||||
#define SHA3_512_DIGEST_LENGTH 64
|
||||
|
||||
@ -98,7 +98,7 @@ void Keccak_final(keccak_state_t *ctx, unsigned char *output,
|
||||
unsigned long long int outputByteLen);
|
||||
|
||||
/**
|
||||
* @brief SHA-3-256 initialization. Begins a SHA-3-256 operation.
|
||||
* @brief SHA3-256 initialization. Begins a SHA3-256 operation.
|
||||
*
|
||||
* @param[in] ctx keccak_state_t handle to initialise
|
||||
*/
|
||||
@ -114,7 +114,7 @@ void sha3_256_init(keccak_state_t *ctx);
|
||||
void sha3_update(keccak_state_t *ctx, const void *data, size_t len);
|
||||
|
||||
/**
|
||||
* @brief SHA-3-256 finalization. Pads the input data and exports the hash value
|
||||
* @brief SHA3-256 finalization. Pads the input data and exports the hash value
|
||||
*
|
||||
* @param[in,out] ctx context handle to use
|
||||
* @param[out] digest resulting digest, this is the hash of all the bytes
|
||||
@ -122,14 +122,14 @@ void sha3_update(keccak_state_t *ctx, const void *data, size_t len);
|
||||
void sha3_256_final(keccak_state_t *ctx, void *digest);
|
||||
|
||||
/**
|
||||
* @brief SHA-3-384 initialization. Begins a SHA-3-256 operation.
|
||||
* @brief SHA3-384 initialization. Begins a SHA3-384 operation.
|
||||
*
|
||||
* @param[in] ctx keccak_state_t handle to initialise
|
||||
*/
|
||||
void sha3_384_init(keccak_state_t *ctx);
|
||||
|
||||
/**
|
||||
* @brief SHA-3-384 finalization. Pads the input data and exports the hash value
|
||||
* @brief SHA3-384 finalization. Pads the input data and exports the hash value
|
||||
*
|
||||
* @param[in,out] ctx context handle to use
|
||||
* @param[out] digest resulting digest, this is the hash of all the bytes
|
||||
@ -137,14 +137,14 @@ void sha3_384_init(keccak_state_t *ctx);
|
||||
void sha3_384_final(keccak_state_t *ctx, void *digest);
|
||||
|
||||
/**
|
||||
* @brief SHA-3-512 initialization. Begins a SHA-3-256 operation.
|
||||
* @brief SHA3-512 initialization. Begins a SHA3-512 operation.
|
||||
*
|
||||
* @param[in] ctx keccak_state_t handle to initialise
|
||||
*/
|
||||
void sha3_512_init(keccak_state_t *ctx);
|
||||
|
||||
/**
|
||||
* @brief SHA-3-512 finalization. Pads the input data and exports the hash value
|
||||
* @brief SHA3-512 finalization. Pads the input data and exports the hash value
|
||||
*
|
||||
* @param[in,out] ctx context handle to use
|
||||
* @param[out] digest resulting digest, this is the hash of all the bytes
|
||||
@ -154,7 +154,7 @@ void sha3_512_final(keccak_state_t *ctx, void *digest);
|
||||
|
||||
/**
|
||||
* @brief A wrapper function to simplify the generation of a hash, this is
|
||||
* useful for generating SHA-3-256 from one buffer
|
||||
* useful for generating SHA3-256 from one buffer
|
||||
*
|
||||
* @param[in] data pointer to the buffer to generate hash from
|
||||
* @param[in] len length of the buffer
|
||||
@ -165,7 +165,7 @@ void sha3_256(void *digest, const void *data, size_t len);
|
||||
|
||||
/**
|
||||
* @brief A wrapper function to simplify the generation of a hash, this is
|
||||
* useful for generating SHA-3-384 from one buffer
|
||||
* useful for generating SHA3-384 from one buffer
|
||||
*
|
||||
* @param[in] data pointer to the buffer to generate hash from
|
||||
* @param[in] len length of the buffer
|
||||
@ -176,7 +176,7 @@ void sha3_384(void *digest, const void *data, size_t len);
|
||||
|
||||
/**
|
||||
* @brief A wrapper function to simplify the generation of a hash, this is
|
||||
* useful for generating SHA-3-512 from one buffer
|
||||
* useful for generating SHA3-512 from one buffer
|
||||
*
|
||||
* @param[in] data pointer to the buffer to generate hash from
|
||||
* @param[in] len length of the buffer
|
||||
|
Loading…
Reference in New Issue
Block a user