/usr/share/doc/libgcrypt20-doc/html/hmac256.html is in libgcrypt20-doc 1.6.5-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 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for Libgcrypt
(version 1.6.5, 9 February 2016),
which is GNU's library of cryptographic building blocks.
Copyright (C) 2000, 2002, 2003, 2004, 2006, 2007, 2008, 2009, 2011, 2012 Free Software Foundation, Inc.
Copyright (C) 2012, 2013 g10 Code GmbH
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version. The text of the license can be found in the
section entitled "GNU General Public License". -->
<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ -->
<head>
<title>The Libgcrypt Reference Manual: hmac256</title>
<meta name="description" content="The Libgcrypt Reference Manual: hmac256">
<meta name="keywords" content="The Libgcrypt Reference Manual: hmac256">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Tools.html#Tools" rel="up" title="Tools">
<link href="Architecture.html#Architecture" rel="next" title="Architecture">
<link href="Tools.html#Tools" rel="prev" title="Tools">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space: nowrap}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: serif; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<a name="hmac256"></a>
<div class="header">
<p>
Up: <a href="Tools.html#Tools" accesskey="u" rel="up">Tools</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="A-HMAC_002dSHA_002d256-tool"></a>
<h3 class="section">15.1 A HMAC-SHA-256 tool</h3>
<p>This is a standalone HMAC-SHA-256 implementation used to compute an
HMAC-SHA-256 message authentication code. The tool has originally
been developed as a second implementation for Libgcrypt to allow
comparing against the primary implementation and to be used for
internal consistency checks. It should not be used for sensitive data
because no mechanisms to clear the stack etc are used.
</p>
<p>The code has been written in a highly portable manner and requires
only a few standard definitions to be provided in a config.h file.
</p>
<p><code>hmac256</code> is commonly invoked as
</p>
<div class="example">
<pre class="example">hmac256 "This is my key" foo.txt
</pre></div>
<p>This compute the MAC on the file <samp>foo.txt</samp> using the key given on
the command line.
</p>
<p><code>hmac256</code> understands these options:
</p>
<dl compact="compact">
<dt><code>--binary</code></dt>
<dd><p>Print the MAC as a binary string. The default is to print the MAC
encoded has lower case hex digits.
</p>
</dd>
<dt><code>--version</code></dt>
<dd><p>Print version of the program and exit.
</p>
</dd>
</dl>
</body>
</html>
|