mbedtls/library/psa_crypto_mac.h

2  *  PSA MAC layer on top of Mbed TLS software crypto
14 /** Calculate the MAC (message authentication code) of a message using Mbed TLS.
24  *                              computing the MAC. This buffer contains the key
28  * \param alg                   The MAC algorithm to use (\c PSA_ALG_XXX value
32  * \param[out] mac              Buffer where the MAC value is to be written.
33  * \param mac_size              Size of the \p mac buffer in bytes.
35  *                              that make up the MAC value.
53     uint8_t *mac,
57 /** Set up a multipart MAC calculation operation using Mbed TLS.
69  *                              computing the MAC. This buffer contains the key
73  * \param alg                   The MAC algorithm to use (\c PSA_ALG_XXX value
92 /** Set up a multipart MAC verification operation using Mbed TLS.
104  *                              computing the MAC. This buffer contains the key
108  * \param alg                   The MAC algorithm to use (\c PSA_ALG_XXX value
127 /** Add a message fragment to a multipart MAC operation using Mbed TLS.
140  * \param[in,out] operation Active MAC operation.
142  *                          the MAC calculation.
157 /** Finish the calculation of the MAC of a message using Mbed TLS.
165  * This function calculates the MAC of the message formed by concatenating
171  * \param[in,out] operation Active MAC operation.
172  * \param[out] mac          Buffer where the MAC value is to be written.
173  * \param mac_size          Output size requested for the MAC algorithm. The PSA
174  *                          core guarantees this is a valid MAC length for the
177  *                          \p mac buffer is large enough to contain the
180  *                          \p mac, which will be equal to the requested length
186  *         The operation state is not valid (it must be an active mac sign
189  *         The size of the \p mac buffer is too small. A sufficient buffer size
196     uint8_t *mac,
200 /** Finish the calculation of the MAC of a message and compare it with
209  * function. This function calculates the MAC of the message formed by
211  * mbedtls_psa_mac_update(). It then compares the calculated MAC with the
212  * expected MAC passed as a parameter to this function.
217  * \param[in,out] operation Active MAC operation.
218  * \param[in] mac           Buffer containing the expected MAC value.
219  * \param mac_length        Length in bytes of the expected MAC value. The PSA
220  *                          core guarantees that this length is a valid MAC
225  *         The expected MAC is identical to the actual MAC of the message.
227  *         The MAC of the message was calculated successfully, but it
228  *         differs from the expected MAC.
230  *         The operation state is not valid (it must be an active mac verify
237     const uint8_t *mac,
240 /** Abort a MAC operation using Mbed TLS.
256  * \param[in,out] operation Initialized MAC operation.