mbedtls_psa_mac_sign_setup() function

The operation object to set up. It must have been initialized and not yet in use.

The attributes of the key to use for the operation.

The buffer containing the key to use for computing the MAC. This buffer contains the key in export representation as defined by psa_export_key() (i.e. the raw key bytes).

Size of the \p key_buffer buffer in bytes.

The MAC algorithm to use (\c PSA_ALG_XXX value such that #PSA_ALG_IS_MAC(\p alg) is true).

Abort a MAC operation using Mbed TLS. Aborting an operation frees all associated resources except for the \p operation structure itself. Once aborted, the operation object can be reused for another operation by calling mbedtls_psa_mac_sign_setup() or mbedtls_psa_mac_verify_setup() again. The PSA core may call this function any time after the operation object has been initialized by one of the methods described in #mbedtls_psa_mac_operation_t. In particular, calling mbedtls_psa_mac_abort() after the operation has been terminated by a call to mbedtls_psa_mac_abort(), mbedtls_psa_mac_sign_finish() or mbedtls_psa_mac_verify_finish() is safe and has no effect.

Add a message fragment to a multipart MAC operation using Mbed TLS. The PSA core calls mbedtls_psa_mac_sign_setup() or mbedtls_psa_mac_verify_setup() before calling this function. If this function returns an error status, the PSA core aborts the operation by calling mbedtls_psa_mac_abort().

Set up a multipart MAC verification operation using Mbed TLS.

Finish the calculation of the MAC of a message using Mbed TLS. The PSA core calls mbedtls_psa_mac_sign_setup() before calling this function. This function calculates the MAC of the message formed by concatenating the inputs passed to preceding calls to mbedtls_psa_mac_update(). Whether this function returns successfully or not, the PSA core subsequently aborts the operation by calling mbedtls_psa_mac_abort().

Finish the calculation of the MAC of a message and compare it with an expected value using Mbed TLS. The PSA core calls mbedtls_psa_mac_verify_setup() before calling this function. This function calculates the MAC of the message formed by concatenating the inputs passed to preceding calls to mbedtls_psa_mac_update(). It then compares the calculated MAC with the expected MAC passed as a parameter to this function. Whether this function returns successfully or not, the PSA core subsequently aborts the operation by calling mbedtls_psa_mac_abort().