/usr/share/doc/libkcapi/html/API-kcapi-md-hmac-sha1.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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>kcapi_md_hmac_sha1</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="ch03s13.html" title="Message Digest Cipher API - Convenience"><link rel="prev" href="API-kcapi-md-sha512.html" title="kcapi_md_sha512"><link rel="next" href="API-kcapi-md-hmac-sha224.html" title="kcapi_md_hmac_sha224"></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_hmac_sha1</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kcapi-md-sha512.html">Prev</a> </td><th width="60%" align="center">Message Digest Cipher API - Convenience</th><td width="20%" align="right"> <a accesskey="n" href="API-kcapi-md-hmac-sha224.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-kcapi-md-hmac-sha1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>kcapi_md_hmac_sha1 —
HMAC SHA-1 keyed message digest on one buffer
</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_hmac_sha1 </b>(</code></td><td>const uint8_t * <var class="pdparam">key</var>, </td></tr><tr><td> </td><td>uint32_t <var class="pdparam">keylen</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="idm3434"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>key</code></em></span></dt><dd><p>
[in] buffer with HMAC key
</p></dd><dt><span class="term"><em class="parameter"><code>keylen</code></em></span></dt><dd><p>
[in] length of HMAC key buffer
</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="idm3467"></a><h2>Description</h2><p>
With this one-shot convenience function, a keyed 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 keyed
message digest.
</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="API-kcapi-md-sha512.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03s13.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kcapi-md-hmac-sha224.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">kcapi_md_sha512</span> </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_md_hmac_sha224</span></td></tr></table></div></body></html>
|