mbedtls/library/psa_crypto_aead.h

19  *       entry point as defined in the PSA driver interface specification for
22  * \param[in]  attributes         The attributes of the key to use for the
24  * \param[in]  key_buffer         The buffer containing the key context.
25  * \param      key_buffer_size    Size of the \p key_buffer buffer in bytes.
27  * \param[in]  nonce              Nonce or IV to use.
28  * \param      nonce_length       Size of the nonce buffer in bytes. This must
33  * \param[in]  additional_data    Additional data that will be authenticated
35  * \param      additional_data_length  Size of additional_data in bytes.
36  * \param[in]  plaintext          Data that will be authenticated and encrypted.
37  * \param      plaintext_length   Size of plaintext in bytes.
45  * \param      ciphertext_size    Size of the ciphertext buffer in bytes. This
56  * \param[out] ciphertext_length  On success, the size of the output in the
81  *       entry point as defined in the PSA driver interface specification for
84  * \param[in]  attributes         The attributes of the key to use for the
86  * \param[in]  key_buffer         The buffer containing the key context.
87  * \param      key_buffer_size    Size of the \p key_buffer buffer in bytes.
89  * \param[in]  nonce              Nonce or IV to use.
90  * \param      nonce_length       Size of the nonce buffer in bytes. This must
95  * \param[in]  additional_data    Additional data that has been authenticated
97  * \param      additional_data_length  Size of additional_data in bytes.
98  * \param[in]  ciphertext         Data that has been authenticated and
104  * \param      ciphertext_length  Size of ciphertext in bytes.
106  * \param      plaintext_size     Size of the plaintext buffer in bytes. This
117  * \param[out] plaintext_length   On success, the size of the output in the
143  *       aead_encrypt_setup entry point as defined in the PSA driver interface
152  * \param[in,out] operation     The operation object to set up. It must have
154  *                              #mbedtls_psa_aead_operation_t and not yet in
156  * \param[in]  attributes       The attributes of the key to use for the
158  * \param[in]  key_buffer       The buffer containing the key context.
159  * \param      key_buffer_size  Size of the \p key_buffer buffer in bytes.
160                                 It must be consistent with the size in bits
161                                 recorded in \p attributes.
186  *       aead_decrypt_setup entry point as defined in the PSA driver interface
195  * \param[in,out] operation     The operation object to set up. It must have
197  *                              #mbedtls_psa_aead_operation_t and not yet in
199  * \param[in]  attributes       The attributes of the key to use for the
201  * \param[in]  key_buffer       The buffer containing the key context.
202  * \param      key_buffer_size  Size of the \p key_buffer buffer in bytes.
203                                 It must be consistent with the size in bits
204                                 recorded in \p attributes.
229  *       defined in the PSA driver interface specification for transparent
241  * \param[in,out] operation     Active AEAD operation.
242  * \param[in] nonce             Buffer containing the nonce to use.
243  * \param nonce_length          Size of the nonce in bytes.
250  *         Algorithm previously set is not supported in this configuration of
262  *       as defined in the PSA driver interface specification for transparent
274  * - For the other AEAD algorithms defined in this specification, calling
280  * \param[in,out] operation     Active AEAD operation.
282  *                              authenticated data in bytes.
283  * \param plaintext_length      Size of the plaintext to encrypt in bytes.
291  *         Algorithm previously set is not supported in this configuration of
303  *       entry point as defined in the PSA driver interface specification for
320  * \param[in,out] operation     Active AEAD operation.
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
336 /** Encrypt or decrypt a message fragment in an active AEAD operation.
340  *       point as defined in the PSA driver interface specification for
358  * sufficient input. The amount of data that can be delayed in this way is
361  * \param[in,out] operation     Active AEAD operation.
362  * \param[in] input             Buffer containing the message fragment to
364  * \param input_length          Size of the \p input buffer in bytes.
366  * \param output_size           Size of the \p output buffer in bytes.
399 /** Finish encrypting a message in an AEAD operation.
403  *       point as defined in the PSA driver interface specification for
422  * \param[in,out] operation     Active AEAD operation.
425  * \param ciphertext_size       Size of the \p ciphertext buffer in bytes.
440  * \param tag_size              Size of the \p tag buffer in bytes.
447  *                                algorithm that were used in the call to
476  *       point as defined in the PSA driver interface specification for
485  * been initialized as described in #mbedtls_psa_aead_operation_t.
487  * In particular, calling mbedtls_psa_aead_abort() after the operation has been
491  * \param[in,out] operation     Initialized AEAD operation.