11.12.3.4.169. Function sss_aead_init

11.12.3.4.169.1. Function Documentation

sss_status_t sss_aead_init(sss_aead_t *context, uint8_t *nonce, size_t nonceLen, size_t tagLen, size_t aadLen, size_t payloadLen)

AEAD init. The function starts the aead operation.

Return

Status of the operation

Parameters
  • context: Pointer to aead crypto context.

  • nonce: The operation nonce or IV. When using internal IV algorithms (only encrypt) for SE051, iv buffer will be filled with genereted Initialization Vector.

  • nonceLen: The length of nonce in bytes. For AES-GCM it must be >= 1. For AES-CCM it must be 7, 8, 9, 10, 11, 12, or 13.

  • tagLen: Length of the computed or received tag in bytes. For AES-GCM it must be 4,8,12,13,14,15 or 16. For AES-CCM it must be 4,6,8,10,12,14 or 16.

  • aadLen: Input size in bytes of AAD. Used only for AES-CCM. Ignored for AES-GCM.

  • payloadLen: Length in bytes of the payload. Used only for AES-CCM. Ignored for AES-GCM.

Return Value