psa_hash_compare() function

Calculate the hash (digest) of a message and compare it with a reference value.

Syntax

Show:

Summary

Declaration

Definition

from crypto.h:898

psa_status_t psa_hash_compare(psa_algorithm_t alg, const uint8_t *input, size_t input_length, const uint8_t *hash, size_t hash_length);

Implemented in psa_crypto.c:2483

Arguments

Argument

Description

alg

The hash algorithm to compute (\c PSA_ALG_XXX value such that #PSA_ALG_IS_HASH(\p alg) is true).

input

Buffer containing the message to hash.

input_length

Size of the \p input buffer in bytes.

hash

Buffer containing the expected hash value.

hash_length

Size of the \p hash buffer in bytes.

Return value

#PSA_SUCCESS The expected hash is identical to the actual hash of the input. #PSA_ERROR_INVALID_SIGNATURE The hash of the message was calculated successfully, but it differs from the expected hash. #PSA_ERROR_NOT_SUPPORTED \p alg is not supported or is not a hash algorithm. #PSA_ERROR_INVALID_ARGUMENT \p input_length or \p hash_length do not match the hash size for \p alg #PSA_ERROR_INSUFFICIENT_MEMORY \emptydescription #PSA_ERROR_COMMUNICATION_FAILURE \emptydescription #PSA_ERROR_HARDWARE_FAILURE \emptydescription #PSA_ERROR_CORRUPTION_DETECTED \emptydescription #PSA_ERROR_BAD_STATE The library has not been previously initialized by psa_crypto_init(). It is implementation-dependent whether a failure to initialize results in this error code.