mbedtls_psa_cipher_set_iv() function

Set the IV for a symmetric encryption or decryption operation. This function sets the IV (initialization vector), nonce or initial counter value for the encryption or decryption operation.

Syntax

Show:

Summary

Declaration

Definition

from psa_crypto_cipher.h:136

psa_status_t mbedtls_psa_cipher_set_iv( mbedtls_psa_cipher_operation_t *operation, const uint8_t *iv, size_t iv_length);

Implemented in psa_crypto_cipher.c:382

Arguments

Argument

Description

operation

Active cipher operation.

Buffer containing the IV to use.

iv_length

Size of the IV in bytes. It is guaranteed by the core to be less or equal to PSA_CIPHER_IV_MAX_SIZE.

Return value

#PSA_SUCCESS \emptydescription #PSA_ERROR_INVALID_ARGUMENT The size of \p iv is not acceptable for the chosen algorithm, or the chosen algorithm does not use an IV. #PSA_ERROR_INSUFFICIENT_MEMORY \emptydescription

Notes

The signature of this function is that of a PSA driver cipher_set_iv entry point. This function behaves as a cipher_set_iv entry point as defined in the PSA driver interface specification for transparent drivers.