Function esp_idf_svc::sys::mbedtls_chachapoly_auth_decrypt

source ยท
pub unsafe extern "C" fn mbedtls_chachapoly_auth_decrypt(
    ctx: *mut mbedtls_chachapoly_context,
    length: usize,
    nonce: *const u8,
    aad: *const u8,
    aad_len: usize,
    tag: *const u8,
    input: *const u8,
    output: *mut u8,
) -> i32
Expand description

\brief This function performs a complete ChaCha20-Poly1305 authenticated decryption with the previously-set key.

\note Before using this function, you must set the key with \c mbedtls_chachapoly_setkey().

\param ctx The ChaCha20-Poly1305 context to use (holds the key). \param length The length (in Bytes) of the data to decrypt. \param nonce The \c 96 Bit (\c 12 bytes) nonce/IV to use. \param aad The buffer containing the additional authenticated data (AAD). This pointer can be \c NULL if aad_len == 0. \param aad_len The length (in bytes) of the AAD data to process. \param tag The buffer holding the authentication tag. This must be a readable buffer of length \c 16 Bytes. \param input The buffer containing the data to decrypt. This pointer can be \c NULL if ilen == 0. \param output The buffer to where the decrypted data is written. This pointer can be \c NULL if ilen == 0.

\return \c 0 on success. \return #MBEDTLS_ERR_CHACHAPOLY_AUTH_FAILED if the data was not authentic. \return Another negative error code on other kinds of failure.