1<!-- HTML header for doxygen 1.8.10--> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml"> 4<head> 5<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> 6<meta http-equiv="X-UA-Compatible" content="IE=9"/> 7<meta name="generator" content="Doxygen 1.8.14"/> 8<title>Intel® Enhanced Privacy ID SDK: epid/member/tiny/math/sha512.h File Reference</title> 9<link href="tabs.css" rel="stylesheet" type="text/css"/> 10<script type="text/javascript" src="jquery.js"></script> 11<script type="text/javascript" src="dynsections.js"></script> 12<link href="navtree.css" rel="stylesheet" type="text/css"/> 13<script type="text/javascript" src="resize.js"></script> 14<script type="text/javascript" src="navtreedata.js"></script> 15<script type="text/javascript" src="navtree.js"></script> 16<script type="text/javascript"> 17/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ 18 $(document).ready(initResizable); 19/* @license-end */</script> 20<link href="doxygen.css" rel="stylesheet" type="text/css" /> 21<link href="epidstyle.css" rel="stylesheet" type="text/css"/> 22</head> 23<body> 24<div id="top"><!-- do not remove this div, it is closed by doxygen! --> 25<div id="titlearea"> 26<table cellspacing="0" cellpadding="0"> 27 <tbody> 28 <tr style="height: 56px;"> 29 <td id="projectalign" style="padding-left: 0.5em;"> 30 <div id="projectname"><a 31 onclick="storeLink('index.html')" 32 id="projectlink" 33 class="index.html" 34 href="index.html">Intel® Enhanced Privacy ID SDK</a> 35 <span id="projectnumber">6.0.1</span> 36</div> 37 </td> 38 </tr> 39 </tbody> 40</table> 41</div> 42<!-- end header part --> 43<!-- Generated by Doxygen 1.8.14 --> 44</div><!-- top --> 45<div id="side-nav" class="ui-resizable side-nav-resizable"> 46 <div id="nav-tree"> 47 <div id="nav-tree-contents"> 48 <div id="nav-sync" class="sync"></div> 49 </div> 50 </div> 51 <div id="splitbar" style="-moz-user-select:none;" 52 class="ui-resizable-handle"> 53 </div> 54</div> 55<script type="text/javascript"> 56/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ 57$(document).ready(function(){initNavTree('sha512_8h.html','');}); 58/* @license-end */ 59</script> 60<div id="doc-content"> 61<div class="header"> 62 <div class="summary"> 63<a href="#define-members">Macros</a> | 64<a href="#func-members">Functions</a> </div> 65 <div class="headertitle"> 66<div class="title">sha512.h File Reference</div> </div> 67</div><!--header--> 68<div class="contents"> 69 70<p>Interface to a SHA-512 implementation. 71<a href="#details">More...</a></p> 72<div class="textblock"><code>#include <stddef.h></code><br /> 73<code>#include <stdint.h></code><br /> 74</div><table class="memberdecls"> 75<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a> 76Macros</h2></td></tr> 77<tr class="memitem:ac7071364cb94c9fcce009ba16a4bdca1"><td class="memItemLeft" align="right" valign="top"><a id="ac7071364cb94c9fcce009ba16a4bdca1"></a> 78#define </td><td class="memItemRight" valign="bottom"><a class="el" href="sha512_8h.html#ac7071364cb94c9fcce009ba16a4bdca1">SHA512_BLOCK_SIZE</a>   (128)</td></tr> 79<tr class="memdesc:ac7071364cb94c9fcce009ba16a4bdca1"><td class="mdescLeft"> </td><td class="mdescRight">block size <br /></td></tr> 80<tr class="separator:ac7071364cb94c9fcce009ba16a4bdca1"><td class="memSeparator" colspan="2"> </td></tr> 81<tr class="memitem:a67f489f3eee39c447a6db3ba34ef75f2"><td class="memItemLeft" align="right" valign="top"><a id="a67f489f3eee39c447a6db3ba34ef75f2"></a> 82#define </td><td class="memItemRight" valign="bottom"><a class="el" href="sha512_8h.html#a67f489f3eee39c447a6db3ba34ef75f2">SHA512_DIGEST_SIZE</a>   (64)</td></tr> 83<tr class="memdesc:a67f489f3eee39c447a6db3ba34ef75f2"><td class="mdescLeft"> </td><td class="mdescRight">digest size <br /></td></tr> 84<tr class="separator:a67f489f3eee39c447a6db3ba34ef75f2"><td class="memSeparator" colspan="2"> </td></tr> 85<tr class="memitem:ab16e074d262ae09949e0bf222f95f5be"><td class="memItemLeft" align="right" valign="top"><a id="ab16e074d262ae09949e0bf222f95f5be"></a> 86#define </td><td class="memItemRight" valign="bottom"><a class="el" href="sha512_8h.html#ab16e074d262ae09949e0bf222f95f5be">SHA512_DIGEST_WORDS</a>   (8)</td></tr> 87<tr class="memdesc:ab16e074d262ae09949e0bf222f95f5be"><td class="mdescLeft"> </td><td class="mdescRight">number of words in SHA state <br /></td></tr> 88<tr class="separator:ab16e074d262ae09949e0bf222f95f5be"><td class="memSeparator" colspan="2"> </td></tr> 89</table><table class="memberdecls"> 90<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a> 91Functions</h2></td></tr> 92<tr class="memitem:a3cf87b13e209264d7aba7d708560dfde"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="sha512_8h.html#a3cf87b13e209264d7aba7d708560dfde">tinysha512_init</a> (sha512_state *s)</td></tr> 93<tr class="memdesc:a3cf87b13e209264d7aba7d708560dfde"><td class="mdescLeft"> </td><td class="mdescRight">The SHA state. <a href="#a3cf87b13e209264d7aba7d708560dfde">More...</a><br /></td></tr> 94<tr class="separator:a3cf87b13e209264d7aba7d708560dfde"><td class="memSeparator" colspan="2"> </td></tr> 95<tr class="memitem:a47108f5097342900a4a07f52b6204082"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="sha512_8h.html#a47108f5097342900a4a07f52b6204082">tinysha512_update</a> (sha512_state *s, void const *data, size_t data_length)</td></tr> 96<tr class="memdesc:a47108f5097342900a4a07f52b6204082"><td class="mdescLeft"> </td><td class="mdescRight">Hashes data into state using SHA-512. <a href="#a47108f5097342900a4a07f52b6204082">More...</a><br /></td></tr> 97<tr class="separator:a47108f5097342900a4a07f52b6204082"><td class="memSeparator" colspan="2"> </td></tr> 98<tr class="memitem:ace9440a26ec431a1596f40284cc8d5ee"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="sha512_8h.html#ace9440a26ec431a1596f40284cc8d5ee">tinysha512_final</a> (unsigned char *digest, sha512_state *s)</td></tr> 99<tr class="memdesc:ace9440a26ec431a1596f40284cc8d5ee"><td class="mdescLeft"> </td><td class="mdescRight">Computes the SHA-512 hash in the digest buffer. <a href="#ace9440a26ec431a1596f40284cc8d5ee">More...</a><br /></td></tr> 100<tr class="separator:ace9440a26ec431a1596f40284cc8d5ee"><td class="memSeparator" colspan="2"> </td></tr> 101</table> 102<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> 103<div class="textblock"><p>Interface to a SHA-512 implementation. </p> 104</div><h2 class="groupheader">Function Documentation</h2> 105<a id="ace9440a26ec431a1596f40284cc8d5ee"></a> 106<h2 class="memtitle"><span class="permalink"><a href="#ace9440a26ec431a1596f40284cc8d5ee">◆ </a></span>tinysha512_final()</h2> 107 108<div class="memitem"> 109<div class="memproto"> 110 <table class="memname"> 111 <tr> 112 <td class="memname">void tinysha512_final </td> 113 <td>(</td> 114 <td class="paramtype">unsigned char * </td> 115 <td class="paramname"><em>digest</em>, </td> 116 </tr> 117 <tr> 118 <td class="paramkey"></td> 119 <td></td> 120 <td class="paramtype">sha512_state * </td> 121 <td class="paramname"><em>s</em> </td> 122 </tr> 123 <tr> 124 <td></td> 125 <td>)</td> 126 <td></td><td></td> 127 </tr> 128 </table> 129</div><div class="memdoc"> 130 131<p>Computes the SHA-512 hash in the digest buffer. </p> 132<dl class="section note"><dt>Note</dt><dd>Assumes SHA512_DIGEST_SIZE bytes are available to accept the digest.</dd></dl> 133<dl class="section warning"><dt>Warning</dt><dd>The state buffer 'leftover' is left in memory after processing. If your application intends to have sensitive data in this buffer, remember to erase it after the data has been processed</dd></dl> 134<dl class="params"><dt>Parameters</dt><dd> 135 <table class="params"> 136 <tr><td class="paramdir">[out]</td><td class="paramname">digest</td><td>The computed digest. Must be non-null or behavior is undefined.</td></tr> 137 <tr><td class="paramdir">[in]</td><td class="paramname">s</td><td>The hash state. Must be non-null or behavior is undefined. </td></tr> 138 </table> 139 </dd> 140</dl> 141 142</div> 143</div> 144<a id="a3cf87b13e209264d7aba7d708560dfde"></a> 145<h2 class="memtitle"><span class="permalink"><a href="#a3cf87b13e209264d7aba7d708560dfde">◆ </a></span>tinysha512_init()</h2> 146 147<div class="memitem"> 148<div class="memproto"> 149 <table class="memname"> 150 <tr> 151 <td class="memname">void tinysha512_init </td> 152 <td>(</td> 153 <td class="paramtype">sha512_state * </td> 154 <td class="paramname"><em>s</em></td><td>)</td> 155 <td></td> 156 </tr> 157 </table> 158</div><div class="memdoc"> 159 160<p>The SHA state. </p> 161<p>Initializes the hash state</p> 162<dl class="params"><dt>Parameters</dt><dd> 163 <table class="params"> 164 <tr><td class="paramdir">[in,out]</td><td class="paramname">s</td><td>The hash state to initialize. </td></tr> 165 </table> 166 </dd> 167</dl> 168 169</div> 170</div> 171<a id="a47108f5097342900a4a07f52b6204082"></a> 172<h2 class="memtitle"><span class="permalink"><a href="#a47108f5097342900a4a07f52b6204082">◆ </a></span>tinysha512_update()</h2> 173 174<div class="memitem"> 175<div class="memproto"> 176 <table class="memname"> 177 <tr> 178 <td class="memname">void tinysha512_update </td> 179 <td>(</td> 180 <td class="paramtype">sha512_state * </td> 181 <td class="paramname"><em>s</em>, </td> 182 </tr> 183 <tr> 184 <td class="paramkey"></td> 185 <td></td> 186 <td class="paramtype">void const * </td> 187 <td class="paramname"><em>data</em>, </td> 188 </tr> 189 <tr> 190 <td class="paramkey"></td> 191 <td></td> 192 <td class="paramtype">size_t </td> 193 <td class="paramname"><em>data_length</em> </td> 194 </tr> 195 <tr> 196 <td></td> 197 <td>)</td> 198 <td></td><td></td> 199 </tr> 200 </table> 201</div><div class="memdoc"> 202 203<p>Hashes data into state using SHA-512. </p> 204<dl class="section warning"><dt>Warning</dt><dd>The state buffer 'leftover' is left in memory after processing. If your application intends to have sensitive data in this buffer, remember to erase it after the data has been processed</dd></dl> 205<dl class="params"><dt>Parameters</dt><dd> 206 <table class="params"> 207 <tr><td class="paramdir">[in,out]</td><td class="paramname">s</td><td>The hash state. Must be non-null or behavior is undefined.</td></tr> 208 <tr><td class="paramdir">[in]</td><td class="paramname">data</td><td>The data to hash into s.</td></tr> 209 <tr><td class="paramdir">[in]</td><td class="paramname">data_length</td><td>The size of data in bytes. </td></tr> 210 </table> 211 </dd> 212</dl> 213 214</div> 215</div> 216</div><!-- contents --> 217</div><!-- doc-content --> 218<!-- HTML footer for doxygen 1.8.10--> 219<!-- start footer part --> 220<div id="nav-path" class="navpath"><!-- id is needed for treeview function! --> 221 <ul> 222 <li class="navelem"><a class="el" href="dir_12b90d9c027aaf878a834df729679a56.html">epid</a></li><li class="navelem"><a class="el" href="dir_512d3e62841a8535b716ec4cf8b9e950.html">member</a></li><li class="navelem"><a class="el" href="dir_ea12d375fc1eb79df248c0adf953af4f.html">tiny</a></li><li class="navelem"><a class="el" href="dir_5f2fc2cf41db41de2b55e03ffa7a1d16.html">math</a></li><li class="navelem"><a class="el" href="sha512_8h.html">sha512.h</a></li> 223 <li class="footer"> 224 © 2016-2017 Intel Corporation 225 </li> 226 </ul> 227</div> 228</body> 229</html> 230