DOKK / manpages / debian 12 / libkcapi-dev / kcapi_aead_getdata_input.3.en
KCAPI_AEAD_GETDATA_I(3) Programming Interface KCAPI_AEAD_GETDATA_I(3)

kcapi_aead_getdata_input - get the pointers into input buffer

void kcapi_aead_getdata_input(struct kcapi_handle * handle, uint8_t * encdata, size_t encdatalen, int enc, uint8_t ** aad, size_t * aadlen, uint8_t ** data, size_t * datalen, uint8_t ** tag, size_t * taglen);

handle

[in] cipher handle

encdata

[in] data buffer returned by the encryption operation

encdatalen

[in] size of the encryption data buffer

enc

[in] does output buffer hold encryption or decryption result?

aad

[out] AD buffer pointer; when set to NULL, no data pointer is returned

aadlen

[out] length of AD; when aad was set to NULL, no information is returned

data

[out] pointer to output buffer from AEAD encryption operation when set to NULL, no data pointer is returned

datalen

[out] length of data buffer; when data was set to NULL, no information is returned

tag

[out] tag buffer pointer; when set to NULL, no data pointer is returned

taglen

[out] length of tag; when tag was set to NULL, no information is returned

This function is a service function to the consumer to locate the right ciphertext buffer offset holding the authentication tag. In addition, it provides the consumer with the length of the tag and the length of the ciphertext.

Stephan Mueller <smueller@chronox.de>

Author.

February 2022 libkcapi Manual 1.4.0