DOKK / manpages / debian 12 / libkcapi-dev / kcapi_akcipher_stream_init_vfy.3.en
KCAPI_AKCIPHER_STREA(3) Programming Interface KCAPI_AKCIPHER_STREA(3)

kcapi_akcipher_stream_init_vfy - start an signature verification operation (stream)

ssize_t kcapi_akcipher_stream_init_vfy(struct kcapi_handle * handle, struct iovec * iov, size_t iovlen);

handle

[in] cipher handle

iov

[in] scatter/gather list with data to be verified. This is the pointer to the first iov entry if an array of iov entries is supplied. See sendmsg(2) for details on how iov is to be used. This pointer may be NULL if no data to be verified is available at the point of the call.

iovlen

[in] number of scatter/gather list elements. If iov is NULL, this value must be zero.

A stream signature verification operation is started with this call. Multiple successive kcapi_akcipher_stream_update function calls can be invoked to send more plaintext data to be verified. The last invocation to supply data must be done with kcapi_akcipher_stream_update_last. The kernel buffers the input until kcapi_akcipher_stream_op picks up the verified data. Once plaintext is verified during the kcapi_cipher_stream_op it is removed from the kernel buffer.

The function calls of kcapi_akcipher_stream_update and kcapi_akcipher_stream_op can be mixed, even by multiple threads of an application.

return number of bytes sent to the kernel upon success; a negative errno-style error code if an error occurred

Stephan Mueller <smueller@chronox.de>

Author.

February 2022 libkcapi Manual 1.4.0