psa_cipher_decrypt() function
Decrypt a message using a symmetric cipher. This function decrypts a message encrypted with a symmetric cipher.
Arguments
key
Identifier of the key to use for the operation. It must remain valid until the operation terminates. It must allow the usage #PSA_KEY_USAGE_DECRYPT.
alg
The cipher algorithm to compute (\c PSA_ALG_XXX value such that #PSA_ALG_IS_CIPHER(\p alg) is true).
input
Buffer containing the message to decrypt. This consists of the IV followed by the ciphertext proper.
input_length
Size of the \p input buffer in bytes.
output
Buffer where the plaintext is to be written.
output_size
Size of the \p output buffer in bytes.
output_length
On success, the number of bytes that make up the output.
Return value
#PSA_SUCCESS Success. #PSA_ERROR_INVALID_HANDLE \emptydescription #PSA_ERROR_NOT_PERMITTED \emptydescription #PSA_ERROR_INVALID_ARGUMENT \p key is not compatible with \p alg. #PSA_ERROR_NOT_SUPPORTED \p alg is not supported or is not a cipher algorithm. #PSA_ERROR_BUFFER_TOO_SMALL \emptydescription #PSA_ERROR_INSUFFICIENT_MEMORY \emptydescription #PSA_ERROR_COMMUNICATION_FAILURE \emptydescription #PSA_ERROR_HARDWARE_FAILURE \emptydescription #PSA_ERROR_STORAGE_FAILURE \emptydescription #PSA_ERROR_CORRUPTION_DETECTED \emptydescription #PSA_ERROR_BAD_STATE The library has not been previously initialized by psa_crypto_init(). It is implementation-dependent whether a failure to initialize results in this error code.
psa_cipher_decrypt() calls 7 functions:
![]()
psa_cipher_decrypt()
psa_cipher_decrypt() reads 7 variables:
![]()
psa_cipher_decrypt()