1KCAPI_AEAD_GETDATA_I(3)      Programming Interface     KCAPI_AEAD_GETDATA_I(3)
2
3
4

NAME

6       kcapi_aead_getdata_input - get the pointers into input buffer
7

SYNOPSIS

9       void kcapi_aead_getdata_input(struct kcapi_handle * handle,
10                                     uint8_t * encdata, size_t encdatalen,
11                                     int enc, uint8_t ** aad, size_t * aadlen,
12                                     uint8_t ** data, size_t * datalen,
13                                     uint8_t ** tag, size_t * taglen);
14

ARGUMENTS

16       handle
17           [in] cipher handle
18
19       encdata
20           [in] data buffer returned by the encryption operation
21
22       encdatalen
23           [in] size of the encryption data buffer
24
25       enc
26           [in] does output buffer hold encryption or decryption result?
27
28       aad
29           [out] AD buffer pointer; when set to NULL, no data pointer is
30           returned
31
32       aadlen
33           [out] length of AD; when aad was set to NULL, no information is
34           returned
35
36       data
37           [out] pointer to output buffer from AEAD encryption operation when
38           set to NULL, no data pointer is returned
39
40       datalen
41           [out] length of data buffer; when data was set to NULL, no
42           information is returned
43
44       tag
45           [out] tag buffer pointer; when set to NULL, no data pointer is
46           returned
47
48       taglen
49           [out] length of tag; when tag was set to NULL, no information is
50           returned
51

DESCRIPTION

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

AUTHOR

59       Stephan Mueller <smueller@chronox.de>
60           Author.
61

63libkcapi Manual 1.4.0            January 2023          KCAPI_AEAD_GETDATA_I(3)
Impressum