pub unsafe extern "C" fn kcapi_aead_getdata_output(
    handle: *mut kcapi_handle,
    encdata: *mut u8,
    encdatalen: size_t,
    enc: c_int,
    aad: *mut *mut u8,
    aadlen: *mut size_t,
    data: *mut *mut u8,
    datalen: *mut size_t,
    tag: *mut *mut u8,
    taglen: *mut size_t
)
Expand description

kcapi_aead_getdata_output() - get the pointers into output buffer

@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; returned pointer may also be NULL @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; returned pointer may also be NULL @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.