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

NAME

6       kcapi_kpp_ssgen_aio - generate a shared secret (asynchronous one shot)
7

SYNOPSIS

9       int32_t kcapi_kpp_ssgen_aio(struct kcapi_handle * handle,
10                                   struct iovec * iniov,
11                                   struct iovec * outiov, uint32_t iovlen,
12                                   int access);
13

ARGUMENTS

15       handle
16           [in] cipher handle
17
18       iniov
19           [in] head of scatter-gather list of the source buffers with the
20           public keys of the peer
21
22       outiov
23           [out] head of scatter-gather list of the destination buffers filled
24           with the generated shared secret
25
26       iovlen
27           [in] number of scatter-gather list entries
28
29       access
30           [in] kernel access type (KCAPI_ACCESS_HEURISTIC - use internal
31           heuristic for fastest kernel access; KCAPI_ACCESS_VMSPLICE - use
32           vmsplice access; KCAPI_ACCESS_SENDMSG - sendmsg access)
33

DESCRIPTION

35       The individual scatter-gather list entries are processed with separate
36       invocations of the the given cipher.
37
38       The memory should be aligned at the page boundary using
39       posix_memalign(sysconf(_SC_PAGESIZE)), If it is not aligned at the page
40       boundary, the vmsplice call may not send all data to the kernel.
41
42       return number of bytes verify upon success; a negative errno-style
43       error code if an error occurred
44

AUTHOR

46       Stephan Mueller <smueller@chronox.de>
47           Author.
48
50libkcapi Manual 1.1.5             August 2019           KCAPI_KPP_SSGEN_AIO(3)
Impressum