Symbols ![]()
loading...
Files ![]()
loading...
PSA_AEAD_NONCE_LENGTH macro
The default nonce size for an AEAD algorithm, in bytes. This macro can be used to allocate a buffer of sufficient size to store the nonce output from #psa_aead_generate_nonce(). See also #PSA_AEAD_NONCE_MAX_SIZE. \warning This macro may evaluate its arguments multiple times or zero times, so you should not pass arguments that contain side effects.
Syntax
#define PSA_AEAD_NONCE_LENGTH(key_type, alg) \
(PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type) == 16 ? \
MBEDTLS_PSA_ALG_AEAD_EQUAL(alg, PSA_ALG_CCM) ? 13u : \
MBEDTLS_PSA_ALG_AEAD_EQUAL(alg, PSA_ALG_GCM) ? 12u : \
0u : \
(key_type) == PSA_KEY_TYPE_CHACHA20 && \
MBEDTLS_PSA_ALG_AEAD_EQUAL(alg, PSA_ALG_CHACHA20_POLY1305) ? 12u : \
0u)
Return value
The default nonce size for the specified key type and algorithm. If the key type or AEAD algorithm is not recognized, or the parameters are incompatible, return 0.
Notes
This is not the maximum size of nonce supported as input to #psa_aead_set_nonce(), #psa_aead_encrypt() or #psa_aead_decrypt(), just the default size that is generated by #psa_aead_generate_nonce().
References
Code
Location