Function esp_idf_svc::sys::mbedtls_ccm_set_lengths
source ยท pub unsafe extern "C" fn mbedtls_ccm_set_lengths(
ctx: *mut mbedtls_ccm_context,
total_ad_len: usize,
plaintext_len: usize,
tag_len: usize,
) -> i32
Expand description
\brief This function declares the lengths of the message and additional data for a CCM encryption or decryption operation.
This function and mbedtls_ccm_starts() must be called
before calling mbedtls_ccm_update_ad() or
mbedtls_ccm_update(). This function can be called before
or after mbedtls_ccm_starts().
\note This function is not implemented in Mbed TLS yet.
\param ctx The CCM context. This must be initialized.
\param total_ad_len The total length of additional data in bytes.
This must be less than 2^16 - 2^8
.
\param plaintext_len The length in bytes of the plaintext to encrypt or
result of the decryption (thus not encompassing the
additional data that are not encrypted).
\param tag_len The length of the tag to generate in Bytes:
4, 6, 8, 10, 12, 14 or 16.
For CCM*, zero is also valid.
\return \c 0 on success. \return #MBEDTLS_ERR_CCM_BAD_INPUT on failure: \p ctx is in an invalid state, \p total_ad_len is greater than \c 0xFF00.