/usr/share/doc/libkcapi/html/API-kcapi-cipher-stream-init-enc.html is in libkcapi-doc 1.0.3-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>kcapi_cipher_stream_init_enc</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"><link rel="home" href="index.html" title="Linux Kernel Crypto API User Space Interface Library"><link rel="up" href="ch03s06.html" title="Synchronous Symmetric Cipher API - Stream"><link rel="prev" href="ch03s06.html" title="Synchronous Symmetric Cipher API - Stream"><link rel="next" href="API-kcapi-cipher-stream-init-dec.html" title="kcapi_cipher_stream_init_dec"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">kcapi_cipher_stream_init_enc</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s06.html">Prev</a> </td><th width="60%" align="center">Synchronous Symmetric Cipher API - Stream</th><td width="20%" align="right"> <a accesskey="n" href="API-kcapi-cipher-stream-init-dec.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-kcapi-cipher-stream-init-enc"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>kcapi_cipher_stream_init_enc —
start an encryption operation (stream)
</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int32_t <b class="fsfunc">kcapi_cipher_stream_init_enc </b>(</code></td><td>struct kcapi_handle * <var class="pdparam">handle</var>, </td></tr><tr><td> </td><td>const uint8_t * <var class="pdparam">iv</var>, </td></tr><tr><td> </td><td>struct iovec * <var class="pdparam">iov</var>, </td></tr><tr><td> </td><td>uint32_t <var class="pdparam">iovlen</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm1261"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>handle</code></em></span></dt><dd><p>
[in] cipher handle
</p></dd><dt><span class="term"><em class="parameter"><code>iv</code></em></span></dt><dd><p>
[in] IV to be used for cipher operation
</p></dd><dt><span class="term"><em class="parameter"><code>iov</code></em></span></dt><dd><p>
[in] scatter/gather list with data to be encrypted. 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 encrypted
is available at the point of the call.
</p></dd><dt><span class="term"><em class="parameter"><code>iovlen</code></em></span></dt><dd><p>
[in] number of scatter/gather list elements. If iov
is NULL, this value must be zero.
</p></dd></dl></div></div><div class="refsect1"><a name="idm1284"></a><h2>Description</h2><p>
A stream encryption operation is started with this call. Multiple
successive <code class="function">kcapi_cipher_stream_update</code> function calls can be invoked to
send more plaintext data to be encrypted. The kernel buffers the input
until <code class="function">kcapi_cipher_stream_op</code> picks up the encrypted data. Once plaintext
is encrypted during the <code class="function">kcapi_cipher_stream_op</code> it is removed from the
kernel buffer.
</p><p>
The function calls of <code class="function">kcapi_cipher_stream_update</code> and
<code class="function">kcapi_cipher_stream_op</code> can be mixed, even by multiple threads of an
application.
</p><p>
The IV buffer must be exactly <code class="function">kcapi_cipher_ivsize</code> bytes in size.
</p><p>
<em class="parameter"><code>return</code></em> number of bytes sent to the kernel upon success;
a negative errno-style error code if an error occurred
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s06.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03s06.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kcapi-cipher-stream-init-dec.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Synchronous Symmetric Cipher API - Stream </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span class="phrase">kcapi_cipher_stream_init_dec</span></td></tr></table></div></body></html>
|