mbedtls/library/psa_crypto_aead.h

17  * \note The signature of this function is that of a PSA driver
22  * \param[in]  attributes         The attributes of the key to use for the
25  * \param      key_buffer_size    Size of the \p key_buffer buffer in bytes.
28  * \param      nonce_length       Size of the nonce buffer in bytes. This must
32  *                                key_type is the type of key.
35  * \param      additional_data_length  Size of additional_data in bytes.
37  * \param      plaintext_length   Size of plaintext in bytes.
40  *                                part of this output. For algorithms where the
45  * \param      ciphertext_size    Size of the ciphertext buffer in bytes. This
51  *                                  of key.
54  *                                  ciphertext size of any supported AEAD
56  * \param[out] ciphertext_length  On success, the size of the output in the
79  * \note The signature of this function is that of a PSA driver
84  * \param[in]  attributes         The attributes of the key to use for the
87  * \param      key_buffer_size    Size of the \p key_buffer buffer in bytes.
90  * \param      nonce_length       Size of the nonce buffer in bytes. This must
94  *                                key_type is the type of key.
97  * \param      additional_data_length  Size of additional_data in bytes.
104  * \param      ciphertext_length  Size of ciphertext in bytes.
106  * \param      plaintext_size     Size of the plaintext buffer in bytes. This
112  *                                  type of key.
115  *                                  plaintext size of any supported AEAD
117  * \param[out] plaintext_length   On success, the size of the output in the
141  *  \note The signature of this function is that of a PSA driver
156  * \param[in]  attributes       The attributes of the key to use for the
159  * \param      key_buffer_size  Size of the \p key_buffer buffer in bytes.
184  * \note The signature of this function is that of a PSA driver
199  * \param[in]  attributes       The attributes of the key to use for the
202  * \param      key_buffer_size  Size of the \p key_buffer buffer in bytes.
227  * \note The signature of this function is that of a PSA driver aead_set_nonce
243  * \param nonce_length          Size of the nonce in bytes.
248  *         The size of \p nonce is not acceptable for the chosen algorithm.
250  *         Algorithm previously set is not supported in this configuration of
258 /** Declare the lengths of the message and additional data for AEAD.
260  * \note The signature of this function is that of a PSA driver aead_set_lengths
281  * \param ad_length             Size of the non-encrypted additional
283  * \param plaintext_length      Size of the plaintext to encrypt in bytes.
288  *         At least one of the lengths is not acceptable for the chosen
291  *         Algorithm previously set is not supported in this configuration of
301  *  \note The signature of this function is that of a PSA driver
309  * fragments of the additional data. It will not call this function after
321  * \param[in] input             Buffer containing the fragment of
323  * \param input_length          Size of the \p input buffer in bytes.
328  *         Algorithm previously set is not supported in this configuration of
338  *  \note The signature of this function is that of a PSA driver
345  *       mbedtls_psa_aead_decrypt_setup(). The choice of setup function
356  * it may delay the end of the corresponding output until a subsequent
358  * sufficient input. The amount of data that can be delayed in this way is
364  * \param input_length          Size of the \p input buffer in bytes.
366  * \param output_size           Size of the \p output buffer in bytes.
372  *                                  \c key_type is the type of key and \c alg is
377  *                                  output size of any supported AEAD
379  * \param[out] output_length    On success, the number of bytes
386  *         The size of the \p output buffer is too small.
401  *  \note The signature of this function is that of a PSA driver
409  * This function finishes the authentication of the additional data
423  * \param[out] ciphertext       Buffer where the last part of the ciphertext
425  * \param ciphertext_size       Size of the \p ciphertext buffer in bytes.
430  *                                \c alg) where \c key_type is the type of key
434  *                                the maximum output size of any supported AEAD
436  * \param[out] ciphertext_length On success, the number of bytes of
440  * \param tag_size              Size of the \p tag buffer in bytes.
446  *                                bit-size of the key, and \c alg are the
450  *                                maximum tag size of any supported AEAD
452  * \param[out] tag_length       On success, the number of bytes
458  *         The size of the \p tag buffer is too small.
474  *  \note The signature of this function is that of a PSA driver