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

NAME

6       kcapi_akcipher_stream_update - send more data for processing (stream)
7

SYNOPSIS

9       ssize_t kcapi_akcipher_stream_update(struct kcapi_handle * handle,
10                                            struct iovec * iov,
11                                            size_t iovlen);
12

ARGUMENTS

14       handle
15           [in] cipher handle
16
17       iov
18           [in] scatter/gather list with data to be processed by the cipher
19           operation.
20
21       iovlen
22           [in] number of scatter/gather list elements.
23

DESCRIPTION

25       Using this function call, more data can be submitted to the kernel.
26
27       This function may cause the caller to sleep if the kernel buffer
28       holding the data is getting full. The process will be woken up once
29       more buffer space becomes available by calling
30       kcapi_akcipher_stream_op.
31

NOTE

33       with the separate API calls of kcapi_akcipher_stream_update and
34       kcapi_akcipher_stream_op a multi-threaded application can be
35       implemented where one thread sends data to be processed and one thread
36       picks up data processed by the cipher operation.
37

WARNING

39       The memory referenced by iov is not accessed by the kernel during this
40       call. The memory is first accessed when kcapi_cipher_stream_op is
41       called. Thus, you MUST make sure that the referenced memory is still
42       present at the time kcapi_cipher_stream_op is called.
43
44       return number of bytes sent to the kernel upon success; a negative
45       errno-style error code if an error occurred
46

AUTHOR

48       Stephan Mueller <smueller@chronox.de>
49           Author.
50

52libkcapi Manual 1.4.0            January 2023          KCAPI_AKCIPHER_STREA(3)
Impressum