/usr/share/doc/libkcapi/html/API-kcapi-md-digest.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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>kcapi_md_digest</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="ch03s12.html" title="Message Digest Cipher API - One Shot"><link rel="prev" href="ch03s12.html" title="Message Digest Cipher API - One Shot"><link rel="next" href="ch03s13.html" title="Message Digest Cipher API - Convenience"></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_md_digest</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s12.html">Prev</a> </td><th width="60%" align="center">Message Digest Cipher API - One Shot</th><td width="20%" align="right"> <a accesskey="n" href="ch03s13.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-kcapi-md-digest"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>kcapi_md_digest —
calculate message digest on buffer (one-shot)
</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_md_digest </b>(</code></td><td>struct kcapi_handle * <var class="pdparam">handle</var>, </td></tr><tr><td> </td><td>const uint8_t * <var class="pdparam">in</var>, </td></tr><tr><td> </td><td>uint32_t <var class="pdparam">inlen</var>, </td></tr><tr><td> </td><td>uint8_t * <var class="pdparam">out</var>, </td></tr><tr><td> </td><td>uint32_t <var class="pdparam">outlen</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm3091"></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>in</code></em></span></dt><dd><p>
[in] buffer with input data
</p></dd><dt><span class="term"><em class="parameter"><code>inlen</code></em></span></dt><dd><p>
[in] length of input buffer
</p></dd><dt><span class="term"><em class="parameter"><code>out</code></em></span></dt><dd><p>
[out] buffer for message digest
</p></dd><dt><span class="term"><em class="parameter"><code>outlen</code></em></span></dt><dd><p>
[in] length of out
</p></dd></dl></div></div><div class="refsect1"><a name="idm3119"></a><h2>Description</h2><p>
With this one-shot function, a message digest of the given buffer is
generated. The output buffer must be allocated by the caller and have at
least the length of the message digest size for the chosen message digest.
</p><p>
The message digest handle must have been initialized, potentially by also
setting the key using the generic message digest API functions.
</p><p>
The input buffer can be at most INT_MAX in size.
</p><p>
<em class="parameter"><code>return</code></em> size of message digest upon success;
-EIO - data cannot be obtained;
-ENOMEM - buffer is too small for the complete message digest,
the buffer is filled with the truncated message digest
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s12.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03s12.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch03s13.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Message Digest Cipher API - One Shot </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Message Digest Cipher API - Convenience</td></tr></table></div></body></html>
|