<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.5"/> <title>PolarSSL v1.3.8: sha1.h Source File</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">PolarSSL v1.3.8 </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.5 --> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li><a href="annotated.html"><span>Data Structures</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="files.html"><span>File List</span></a></li> <li><a href="globals.html"><span>Globals</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="dir_6a9bbd12bf4e19a18c45e270f8fae3fd.html">include</a></li><li class="navelem"><a class="el" href="dir_04272d44da4745cf8b8bfc767d6c6523.html">polarssl</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="headertitle"> <div class="title">sha1.h</div> </div> </div><!--header--> <div class="contents"> <a href="sha1_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> </div> <div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="preprocessor">#ifndef POLARSSL_SHA1_H</span></div> <div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor"></span><span class="preprocessor">#define POLARSSL_SHA1_H</span></div> <div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor"></span></div> <div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#if !defined(POLARSSL_CONFIG_FILE)</span></div> <div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor"></span><span class="preprocessor">#include "<a class="code" href="config_8h.html">config.h</a>"</span></div> <div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#else</span></div> <div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor"></span><span class="preprocessor">#include POLARSSL_CONFIG_FILE</span></div> <div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor"></span><span class="preprocessor">#endif</span></div> <div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor"></span></div> <div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor">#include <string.h></span></div> <div class="line"><a name="l00037"></a><span class="lineno"> 37</span> </div> <div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="preprocessor">#if defined(_MSC_VER) && !defined(EFIX64) && !defined(EFI32)</span></div> <div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="preprocessor"></span><span class="preprocessor">#include <basetsd.h></span></div> <div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="keyword">typedef</span> UINT32 uint32_t;</div> <div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="preprocessor">#else</span></div> <div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="preprocessor"></span><span class="preprocessor">#include <inttypes.h></span></div> <div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="preprocessor">#endif</span></div> <div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="preprocessor"></span></div> <div class="line"><a name="l00045"></a><span class="lineno"><a class="line" href="sha1_8h.html#a71eaf8aa36e347940b9132e7882b9bf4"> 45</a></span> <span class="preprocessor">#define POLARSSL_ERR_SHA1_FILE_IO_ERROR -0x0076 </span></div> <div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="preprocessor">#if !defined(POLARSSL_SHA1_ALT)</span></div> <div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="preprocessor"></span><span class="comment">// Regular implementation</span></div> <div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">//</span></div> <div class="line"><a name="l00050"></a><span class="lineno"> 50</span> </div> <div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="preprocessor">#ifdef __cplusplus</span></div> <div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {</div> <div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="preprocessor">#endif</span></div> <div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="preprocessor"></span></div> <div class="line"><a name="l00058"></a><span class="lineno"><a class="line" href="structsha1__context.html"> 58</a></span> <span class="keyword">typedef</span> <span class="keyword">struct</span></div> <div class="line"><a name="l00059"></a><span class="lineno"> 59</span> {</div> <div class="line"><a name="l00060"></a><span class="lineno"><a class="line" href="structsha1__context.html#a62e957a1aefe086c089a26086e655b6e"> 60</a></span>  uint32_t total[2]; </div> <div class="line"><a name="l00061"></a><span class="lineno"><a class="line" href="structsha1__context.html#a0c8a65bd0bc19179c9b3507387104949"> 61</a></span>  uint32_t state[5]; </div> <div class="line"><a name="l00062"></a><span class="lineno"><a class="line" href="structsha1__context.html#a786ed7dca73e819d233363df0f571d00"> 62</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> buffer[64]; </div> <div class="line"><a name="l00064"></a><span class="lineno"><a class="line" href="structsha1__context.html#aa169dfe2b3ef47b79c50e4911e5b0b70"> 64</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> ipad[64]; </div> <div class="line"><a name="l00065"></a><span class="lineno"><a class="line" href="structsha1__context.html#ac35bcb6e11165314e623b506963681ed"> 65</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> opad[64]; </div> <div class="line"><a name="l00066"></a><span class="lineno"> 66</span> }</div> <div class="line"><a name="l00067"></a><span class="lineno"> 67</span> <a class="code" href="structsha1__context.html">sha1_context</a>;</div> <div class="line"><a name="l00068"></a><span class="lineno"> 68</span> </div> <div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="keywordtype">void</span> <a class="code" href="sha1_8h.html#a6a50e52c911aec6602113502a65eeb51">sha1_init</a>( <a class="code" href="structsha1__context.html">sha1_context</a> *ctx );</div> <div class="line"><a name="l00075"></a><span class="lineno"> 75</span> </div> <div class="line"><a name="l00081"></a><span class="lineno"> 81</span> <span class="keywordtype">void</span> <a class="code" href="sha1_8h.html#aa41c48833d13d4053cd32ff1e5b3ed02">sha1_free</a>( <a class="code" href="structsha1__context.html">sha1_context</a> *ctx );</div> <div class="line"><a name="l00082"></a><span class="lineno"> 82</span> </div> <div class="line"><a name="l00088"></a><span class="lineno"> 88</span> <span class="keywordtype">void</span> <a class="code" href="sha1_8h.html#a1055bb44108c1e8d9692f3e3b8acd568">sha1_starts</a>( <a class="code" href="structsha1__context.html">sha1_context</a> *ctx );</div> <div class="line"><a name="l00089"></a><span class="lineno"> 89</span> </div> <div class="line"><a name="l00097"></a><span class="lineno"> 97</span> <span class="keywordtype">void</span> <a class="code" href="sha1_8h.html#a3447dcf0d31e3f99c875b4f9773e221a">sha1_update</a>( <a class="code" href="structsha1__context.html">sha1_context</a> *ctx, <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *input, <span class="keywordtype">size_t</span> ilen );</div> <div class="line"><a name="l00098"></a><span class="lineno"> 98</span> </div> <div class="line"><a name="l00105"></a><span class="lineno"> 105</span> <span class="keywordtype">void</span> <a class="code" href="sha1_8h.html#a83ee41b9375fb1cfaa52a98b86b92c58">sha1_finish</a>( <a class="code" href="structsha1__context.html">sha1_context</a> *ctx, <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> output[20] );</div> <div class="line"><a name="l00106"></a><span class="lineno"> 106</span> </div> <div class="line"><a name="l00107"></a><span class="lineno"> 107</span> <span class="comment">/* Internal use */</span></div> <div class="line"><a name="l00108"></a><span class="lineno"> 108</span> <span class="keywordtype">void</span> <a class="code" href="sha1_8h.html#afb7bdd09cc2251b77dce37a60c1b2778">sha1_process</a>( <a class="code" href="structsha1__context.html">sha1_context</a> *ctx, <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> data[64] );</div> <div class="line"><a name="l00109"></a><span class="lineno"> 109</span> </div> <div class="line"><a name="l00110"></a><span class="lineno"> 110</span> <span class="preprocessor">#ifdef __cplusplus</span></div> <div class="line"><a name="l00111"></a><span class="lineno"> 111</span> <span class="preprocessor"></span>}</div> <div class="line"><a name="l00112"></a><span class="lineno"> 112</span> <span class="preprocessor">#endif</span></div> <div class="line"><a name="l00113"></a><span class="lineno"> 113</span> <span class="preprocessor"></span></div> <div class="line"><a name="l00114"></a><span class="lineno"> 114</span> <span class="preprocessor">#else </span><span class="comment">/* POLARSSL_SHA1_ALT */</span><span class="preprocessor"></span></div> <div class="line"><a name="l00115"></a><span class="lineno"> 115</span> <span class="preprocessor"></span><span class="preprocessor">#include "sha1_alt.h"</span></div> <div class="line"><a name="l00116"></a><span class="lineno"> 116</span> <span class="preprocessor">#endif </span><span class="comment">/* POLARSSL_SHA1_ALT */</span><span class="preprocessor"></span></div> <div class="line"><a name="l00117"></a><span class="lineno"> 117</span> <span class="preprocessor"></span></div> <div class="line"><a name="l00118"></a><span class="lineno"> 118</span> <span class="preprocessor">#ifdef __cplusplus</span></div> <div class="line"><a name="l00119"></a><span class="lineno"> 119</span> <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {</div> <div class="line"><a name="l00120"></a><span class="lineno"> 120</span> <span class="preprocessor">#endif</span></div> <div class="line"><a name="l00121"></a><span class="lineno"> 121</span> <span class="preprocessor"></span></div> <div class="line"><a name="l00129"></a><span class="lineno"> 129</span> <span class="keywordtype">void</span> <a class="code" href="sha1_8h.html#a0650fb3d7df7e2bb4b512804b914d5ee">sha1</a>( <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *input, <span class="keywordtype">size_t</span> ilen, <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> output[20] );</div> <div class="line"><a name="l00130"></a><span class="lineno"> 130</span> </div> <div class="line"><a name="l00139"></a><span class="lineno"> 139</span> <span class="keywordtype">int</span> <a class="code" href="sha1_8h.html#a2b0a100878886e9145a49172794f7d28">sha1_file</a>( <span class="keyword">const</span> <span class="keywordtype">char</span> *path, <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> output[20] );</div> <div class="line"><a name="l00140"></a><span class="lineno"> 140</span> </div> <div class="line"><a name="l00148"></a><span class="lineno"> 148</span> <span class="keywordtype">void</span> <a class="code" href="sha1_8h.html#a85ce4113c4cf8ed0bc15d747600f3615">sha1_hmac_starts</a>( <a class="code" href="structsha1__context.html">sha1_context</a> *ctx, <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *key,</div> <div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  <span class="keywordtype">size_t</span> keylen );</div> <div class="line"><a name="l00150"></a><span class="lineno"> 150</span> </div> <div class="line"><a name="l00158"></a><span class="lineno"> 158</span> <span class="keywordtype">void</span> <a class="code" href="sha1_8h.html#a4fbb8e5fa6cc2c64f74b3ea05e820fcc">sha1_hmac_update</a>( <a class="code" href="structsha1__context.html">sha1_context</a> *ctx, <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *input,</div> <div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="keywordtype">size_t</span> ilen );</div> <div class="line"><a name="l00160"></a><span class="lineno"> 160</span> </div> <div class="line"><a name="l00167"></a><span class="lineno"> 167</span> <span class="keywordtype">void</span> <a class="code" href="sha1_8h.html#a38679c6fef6af534896808974a98c884">sha1_hmac_finish</a>( <a class="code" href="structsha1__context.html">sha1_context</a> *ctx, <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> output[20] );</div> <div class="line"><a name="l00168"></a><span class="lineno"> 168</span> </div> <div class="line"><a name="l00174"></a><span class="lineno"> 174</span> <span class="keywordtype">void</span> <a class="code" href="sha1_8h.html#ae69d81f33e1ddb70e8e7b697d908cb74">sha1_hmac_reset</a>( <a class="code" href="structsha1__context.html">sha1_context</a> *ctx );</div> <div class="line"><a name="l00175"></a><span class="lineno"> 175</span> </div> <div class="line"><a name="l00185"></a><span class="lineno"> 185</span> <span class="keywordtype">void</span> <a class="code" href="sha1_8h.html#a17ef720021c40b248d3ea69fe7373983">sha1_hmac</a>( <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *key, <span class="keywordtype">size_t</span> keylen,</div> <div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *input, <span class="keywordtype">size_t</span> ilen,</div> <div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> output[20] );</div> <div class="line"><a name="l00188"></a><span class="lineno"> 188</span> </div> <div class="line"><a name="l00194"></a><span class="lineno"> 194</span> <span class="keywordtype">int</span> <a class="code" href="sha1_8h.html#a4f74b29e82caff3c6f73b4e13648effb">sha1_self_test</a>( <span class="keywordtype">int</span> verbose );</div> <div class="line"><a name="l00195"></a><span class="lineno"> 195</span> </div> <div class="line"><a name="l00196"></a><span class="lineno"> 196</span> <span class="preprocessor">#ifdef __cplusplus</span></div> <div class="line"><a name="l00197"></a><span class="lineno"> 197</span> <span class="preprocessor"></span>}</div> <div class="line"><a name="l00198"></a><span class="lineno"> 198</span> <span class="preprocessor">#endif</span></div> <div class="line"><a name="l00199"></a><span class="lineno"> 199</span> <span class="preprocessor"></span></div> <div class="line"><a name="l00200"></a><span class="lineno"> 200</span> <span class="preprocessor">#endif </span><span class="comment">/* sha1.h */</span><span class="preprocessor"></span></div> <div class="ttc" id="sha1_8h_html_a38679c6fef6af534896808974a98c884"><div class="ttname"><a href="sha1_8h.html#a38679c6fef6af534896808974a98c884">sha1_hmac_finish</a></div><div class="ttdeci">void sha1_hmac_finish(sha1_context *ctx, unsigned char output[20])</div><div class="ttdoc">SHA-1 HMAC final digest. </div></div> <div class="ttc" id="sha1_8h_html_a4f74b29e82caff3c6f73b4e13648effb"><div class="ttname"><a href="sha1_8h.html#a4f74b29e82caff3c6f73b4e13648effb">sha1_self_test</a></div><div class="ttdeci">int sha1_self_test(int verbose)</div><div class="ttdoc">Checkup routine. </div></div> <div class="ttc" id="structsha1__context_html"><div class="ttname"><a href="structsha1__context.html">sha1_context</a></div><div class="ttdoc">SHA-1 context structure. </div><div class="ttdef"><b>Definition:</b> <a href="sha1_8h_source.html#l00058">sha1.h:58</a></div></div> <div class="ttc" id="sha1_8h_html_a0650fb3d7df7e2bb4b512804b914d5ee"><div class="ttname"><a href="sha1_8h.html#a0650fb3d7df7e2bb4b512804b914d5ee">sha1</a></div><div class="ttdeci">void sha1(const unsigned char *input, size_t ilen, unsigned char output[20])</div><div class="ttdoc">Output = SHA-1( input buffer ) </div></div> <div class="ttc" id="sha1_8h_html_a83ee41b9375fb1cfaa52a98b86b92c58"><div class="ttname"><a href="sha1_8h.html#a83ee41b9375fb1cfaa52a98b86b92c58">sha1_finish</a></div><div class="ttdeci">void sha1_finish(sha1_context *ctx, unsigned char output[20])</div><div class="ttdoc">SHA-1 final digest. </div></div> <div class="ttc" id="sha1_8h_html_a17ef720021c40b248d3ea69fe7373983"><div class="ttname"><a href="sha1_8h.html#a17ef720021c40b248d3ea69fe7373983">sha1_hmac</a></div><div class="ttdeci">void sha1_hmac(const unsigned char *key, size_t keylen, const unsigned char *input, size_t ilen, unsigned char output[20])</div><div class="ttdoc">Output = HMAC-SHA-1( hmac key, input buffer ) </div></div> <div class="ttc" id="config_8h_html"><div class="ttname"><a href="config_8h.html">config.h</a></div><div class="ttdoc">Configuration options (set of defines) </div></div> <div class="ttc" id="sha1_8h_html_ae69d81f33e1ddb70e8e7b697d908cb74"><div class="ttname"><a href="sha1_8h.html#ae69d81f33e1ddb70e8e7b697d908cb74">sha1_hmac_reset</a></div><div class="ttdeci">void sha1_hmac_reset(sha1_context *ctx)</div><div class="ttdoc">SHA-1 HMAC context reset. </div></div> <div class="ttc" id="sha1_8h_html_a2b0a100878886e9145a49172794f7d28"><div class="ttname"><a href="sha1_8h.html#a2b0a100878886e9145a49172794f7d28">sha1_file</a></div><div class="ttdeci">int sha1_file(const char *path, unsigned char output[20])</div><div class="ttdoc">Output = SHA-1( file contents ) </div></div> <div class="ttc" id="sha1_8h_html_aa41c48833d13d4053cd32ff1e5b3ed02"><div class="ttname"><a href="sha1_8h.html#aa41c48833d13d4053cd32ff1e5b3ed02">sha1_free</a></div><div class="ttdeci">void sha1_free(sha1_context *ctx)</div><div class="ttdoc">Clear SHA-1 context. </div></div> <div class="ttc" id="sha1_8h_html_a85ce4113c4cf8ed0bc15d747600f3615"><div class="ttname"><a href="sha1_8h.html#a85ce4113c4cf8ed0bc15d747600f3615">sha1_hmac_starts</a></div><div class="ttdeci">void sha1_hmac_starts(sha1_context *ctx, const unsigned char *key, size_t keylen)</div><div class="ttdoc">SHA-1 HMAC context setup. </div></div> <div class="ttc" id="sha1_8h_html_a1055bb44108c1e8d9692f3e3b8acd568"><div class="ttname"><a href="sha1_8h.html#a1055bb44108c1e8d9692f3e3b8acd568">sha1_starts</a></div><div class="ttdeci">void sha1_starts(sha1_context *ctx)</div><div class="ttdoc">SHA-1 context setup. </div></div> <div class="ttc" id="sha1_8h_html_a6a50e52c911aec6602113502a65eeb51"><div class="ttname"><a href="sha1_8h.html#a6a50e52c911aec6602113502a65eeb51">sha1_init</a></div><div class="ttdeci">void sha1_init(sha1_context *ctx)</div><div class="ttdoc">Initialize SHA-1 context. </div></div> <div class="ttc" id="sha1_8h_html_a3447dcf0d31e3f99c875b4f9773e221a"><div class="ttname"><a href="sha1_8h.html#a3447dcf0d31e3f99c875b4f9773e221a">sha1_update</a></div><div class="ttdeci">void sha1_update(sha1_context *ctx, const unsigned char *input, size_t ilen)</div><div class="ttdoc">SHA-1 process buffer. </div></div> <div class="ttc" id="sha1_8h_html_afb7bdd09cc2251b77dce37a60c1b2778"><div class="ttname"><a href="sha1_8h.html#afb7bdd09cc2251b77dce37a60c1b2778">sha1_process</a></div><div class="ttdeci">void sha1_process(sha1_context *ctx, const unsigned char data[64])</div></div> <div class="ttc" id="sha1_8h_html_a4fbb8e5fa6cc2c64f74b3ea05e820fcc"><div class="ttname"><a href="sha1_8h.html#a4fbb8e5fa6cc2c64f74b3ea05e820fcc">sha1_hmac_update</a></div><div class="ttdeci">void sha1_hmac_update(sha1_context *ctx, const unsigned char *input, size_t ilen)</div><div class="ttdoc">SHA-1 HMAC process buffer. </div></div> </div><!-- fragment --></div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated on Thu Jul 31 2014 11:35:51 for PolarSSL v1.3.8 by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.5 </small></address> </body> </html>