<!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"/>
<title>Crypto++: TruncatedHashTemplate< T > Class Template Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>TruncatedHashTemplate< T > Class Template Reference</h1><!-- doxytag: class="TruncatedHashTemplate" --><!-- doxytag: inherits="HashTransformation" -->
<p>construct new HashModule with smaller <a class="el" href="class_truncated_hash_template.html#a031c1782432ae1e0f7bff2bb2ae382a5" title="size of the hash/digest/MAC returned by Final()">DigestSize()</a> from existing one
<a href="#_details">More...</a></p>
<p><code>#include <<a class="el" href="trunhash_8h_source.html">trunhash.h</a>></code></p>
<div class="dynheader">
Inheritance diagram for TruncatedHashTemplate< T >:</div>
<div class="dynsection">
<div class="center">
<img src="class_truncated_hash_template.gif" usemap="#TruncatedHashTemplate< T >_map" alt=""/>
<map id="TruncatedHashTemplate< T >_map" name="TruncatedHashTemplate< T >_map">
<area href="class_hash_transformation.html" alt="HashTransformation" shape="rect" coords="0,112,179,136"/>
<area href="class_algorithm.html" alt="Algorithm" shape="rect" coords="0,56,179,80"/>
<area href="class_clonable.html" alt="Clonable" shape="rect" coords="0,0,179,24"/>
</map>
</div>
</div>
<p><a href="class_truncated_hash_template-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ab1cc7657479c262a5ecb5f5d4af8917b"></a><!-- doxytag: member="TruncatedHashTemplate::TruncatedHashTemplate" ref="ab1cc7657479c262a5ecb5f5d4af8917b" args="(T hm, unsigned int digestSize)" -->
</td><td class="memItemRight" valign="bottom"><b>TruncatedHashTemplate</b> (T hm, unsigned int digestSize)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a03c5bc7da3eebba8f5850d21ad0fe879"></a><!-- doxytag: member="TruncatedHashTemplate::TruncatedHashTemplate" ref="a03c5bc7da3eebba8f5850d21ad0fe879" args="(const byte *key, size_t keyLength, unsigned int digestSize)" -->
</td><td class="memItemRight" valign="bottom"><b>TruncatedHashTemplate</b> (const byte *key, size_t keyLength, unsigned int digestSize)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a58cf3e759c44b8901b1f7b2aaece2aac"></a><!-- doxytag: member="TruncatedHashTemplate::TruncatedHashTemplate" ref="a58cf3e759c44b8901b1f7b2aaece2aac" args="(size_t digestSize)" -->
</td><td class="memItemRight" valign="bottom"><b>TruncatedHashTemplate</b> (size_t digestSize)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a01af99665c10d2980a4e23555067cb5d"></a><!-- doxytag: member="TruncatedHashTemplate::Restart" ref="a01af99665c10d2980a4e23555067cb5d" args="()" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_truncated_hash_template.html#a01af99665c10d2980a4e23555067cb5d">Restart</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">discard the current state, and restart with a new message <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3261842338107f4f641e493b0ceb037f"></a><!-- doxytag: member="TruncatedHashTemplate::Update" ref="a3261842338107f4f641e493b0ceb037f" args="(const byte *input, size_t length)" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_truncated_hash_template.html#a3261842338107f4f641e493b0ceb037f">Update</a> (const byte *input, size_t length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">process more input <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a031c1782432ae1e0f7bff2bb2ae382a5"></a><!-- doxytag: member="TruncatedHashTemplate::DigestSize" ref="a031c1782432ae1e0f7bff2bb2ae382a5" args="() const " -->
unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="class_truncated_hash_template.html#a031c1782432ae1e0f7bff2bb2ae382a5">DigestSize</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">size of the hash/digest/MAC returned by <a class="el" href="class_hash_transformation.html#aa0b8c7a110d8968268fd02ec32b9a8e8" title="compute hash for current message, then restart for a new message">Final()</a> <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a8d35821fad737aaa41c6ad0a01e56510"></a><!-- doxytag: member="TruncatedHashTemplate::TruncatedFinal" ref="a8d35821fad737aaa41c6ad0a01e56510" args="(byte *digest, size_t digestSize)" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_truncated_hash_template.html#a8d35821fad737aaa41c6ad0a01e56510">TruncatedFinal</a> (byte *digest, size_t digestSize)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">truncated version of <a class="el" href="class_hash_transformation.html#aa0b8c7a110d8968268fd02ec32b9a8e8" title="compute hash for current message, then restart for a new message">Final()</a> <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aeeae8ba7cae1d365551f156a5ff87c6d"></a><!-- doxytag: member="TruncatedHashTemplate::TruncatedVerify" ref="aeeae8ba7cae1d365551f156a5ff87c6d" args="(const byte *digest, size_t digestLength)" -->
bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_truncated_hash_template.html#aeeae8ba7cae1d365551f156a5ff87c6d">TruncatedVerify</a> (const byte *digest, size_t digestLength)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">truncated version of <a class="el" href="class_hash_transformation.html#a16c4aecd047015d513feef4ed5b929ba" title="verify that digest is a valid digest for the current message, then reinitialize the...">Verify()</a> <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_hash_transformation.html">HashTransformation</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_hash_transformation.html#a39b0a4c4cdc11fda358f9975b5e4137e">Ref</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return a reference to this object, <a href="#a39b0a4c4cdc11fda358f9975b5e4137e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a9fc0b332ef36900ca6ea5d949e95aba1"></a><!-- doxytag: member="TruncatedHashTemplate::CreateUpdateSpace" ref="a9fc0b332ef36900ca6ea5d949e95aba1" args="(size_t &size)" -->
virtual byte * </td><td class="memItemRight" valign="bottom"><a class="el" href="class_hash_transformation.html#a9fc0b332ef36900ca6ea5d949e95aba1">CreateUpdateSpace</a> (size_t &size)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">request space to write input into <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_hash_transformation.html#aa0b8c7a110d8968268fd02ec32b9a8e8">Final</a> (byte *digest)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">compute hash for current message, then restart for a new message <a href="#aa0b8c7a110d8968268fd02ec32b9a8e8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a5e847d65a38ec354de1b28cc4bc66a81"></a><!-- doxytag: member="TruncatedHashTemplate::TagSize" ref="a5e847d65a38ec354de1b28cc4bc66a81" args="() const " -->
unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="class_hash_transformation.html#a5e847d65a38ec354de1b28cc4bc66a81">TagSize</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">same as <a class="el" href="class_hash_transformation.html#a9f42cc280bac76b884ad12615c0dabb5" title="size of the hash/digest/MAC returned by Final()">DigestSize()</a> <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ab5507c62376f6bea41d53ae9544d0ff0"></a><!-- doxytag: member="TruncatedHashTemplate::BlockSize" ref="ab5507c62376f6bea41d53ae9544d0ff0" args="() const " -->
virtual unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="class_hash_transformation.html#ab5507c62376f6bea41d53ae9544d0ff0">BlockSize</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">block size of underlying compression function, or 0 if not block based <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a981fce3f7d06c1f4ab2da853a1cf429d"></a><!-- doxytag: member="TruncatedHashTemplate::OptimalBlockSize" ref="a981fce3f7d06c1f4ab2da853a1cf429d" args="() const " -->
virtual unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="class_hash_transformation.html#a981fce3f7d06c1f4ab2da853a1cf429d">OptimalBlockSize</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">input to <a class="el" href="class_hash_transformation.html#aafabefaf445b65d3ba0d8e1c0294afe5" title="process more input">Update()</a> should have length a multiple of this for optimal speed <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ad44c14bc654ba3be366da88e0a27f169"></a><!-- doxytag: member="TruncatedHashTemplate::OptimalDataAlignment" ref="ad44c14bc654ba3be366da88e0a27f169" args="() const " -->
virtual unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="class_hash_transformation.html#ad44c14bc654ba3be366da88e0a27f169">OptimalDataAlignment</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">returns how input should be aligned for optimal performance <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af8124c4fca23b74bbdc43660bdae692c"></a><!-- doxytag: member="TruncatedHashTemplate::CalculateDigest" ref="af8124c4fca23b74bbdc43660bdae692c" args="(byte *digest, const byte *input, size_t length)" -->
virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_hash_transformation.html#af8124c4fca23b74bbdc43660bdae692c">CalculateDigest</a> (byte *digest, const byte *input, size_t length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">use this if your input is in one piece and you don't want to call <a class="el" href="class_hash_transformation.html#aafabefaf445b65d3ba0d8e1c0294afe5" title="process more input">Update()</a> and <a class="el" href="class_hash_transformation.html#aa0b8c7a110d8968268fd02ec32b9a8e8" title="compute hash for current message, then restart for a new message">Final()</a> separately <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_hash_transformation.html#a16c4aecd047015d513feef4ed5b929ba">Verify</a> (const byte *digest)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">verify that digest is a valid digest for the current message, then reinitialize the object <a href="#a16c4aecd047015d513feef4ed5b929ba"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="acad96df68e70d922683e5063057130b2"></a><!-- doxytag: member="TruncatedHashTemplate::VerifyDigest" ref="acad96df68e70d922683e5063057130b2" args="(const byte *digest, const byte *input, size_t length)" -->
virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_hash_transformation.html#acad96df68e70d922683e5063057130b2">VerifyDigest</a> (const byte *digest, const byte *input, size_t length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">use this if your input is in one piece and you don't want to call <a class="el" href="class_hash_transformation.html#aafabefaf445b65d3ba0d8e1c0294afe5" title="process more input">Update()</a> and <a class="el" href="class_hash_transformation.html#a16c4aecd047015d513feef4ed5b929ba" title="verify that digest is a valid digest for the current message, then reinitialize the...">Verify()</a> separately <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a0b6917657eaec935750fd83e28270d76"></a><!-- doxytag: member="TruncatedHashTemplate::CalculateTruncatedDigest" ref="a0b6917657eaec935750fd83e28270d76" args="(byte *digest, size_t digestSize, const byte *input, size_t length)" -->
virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_hash_transformation.html#a0b6917657eaec935750fd83e28270d76">CalculateTruncatedDigest</a> (byte *digest, size_t digestSize, const byte *input, size_t length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">truncated version of <a class="el" href="class_hash_transformation.html#af8124c4fca23b74bbdc43660bdae692c" title="use this if your input is in one piece and you don't want to call Update() and...">CalculateDigest()</a> <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7958e99717019e8b9f91672bdfe9e086"></a><!-- doxytag: member="TruncatedHashTemplate::VerifyTruncatedDigest" ref="a7958e99717019e8b9f91672bdfe9e086" args="(const byte *digest, size_t digestLength, const byte *input, size_t length)" -->
virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_hash_transformation.html#a7958e99717019e8b9f91672bdfe9e086">VerifyTruncatedDigest</a> (const byte *digest, size_t digestLength, const byte *input, size_t length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">truncated version of <a class="el" href="class_hash_transformation.html#acad96df68e70d922683e5063057130b2" title="use this if your input is in one piece and you don't want to call Update() and...">VerifyDigest()</a> <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="acd21c6715add4884fa043eaf51655039"></a><!-- doxytag: member="TruncatedHashTemplate::AlgorithmName" ref="acd21c6715add4884fa043eaf51655039" args="() const " -->
virtual std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="class_algorithm.html#acd21c6715add4884fa043eaf51655039">AlgorithmName</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">returns name of this algorithm, not universally implemented yet <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a24b43349a71e1f98508eeb10b31a0a62"></a><!-- doxytag: member="TruncatedHashTemplate::Clone" ref="a24b43349a71e1f98508eeb10b31a0a62" args="() const " -->
virtual <a class="el" href="class_clonable.html">Clonable</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="class_clonable.html#a24b43349a71e1f98508eeb10b31a0a62">Clone</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">this is not implemented by most classes yet <br/></td></tr>
<tr><td colspan="2"><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a584846215692150d99d63f8b7ccd58d8"></a><!-- doxytag: member="TruncatedHashTemplate::ThrowIfInvalidTruncatedSize" ref="a584846215692150d99d63f8b7ccd58d8" args="(size_t size) const " -->
void </td><td class="memItemRight" valign="bottom"><b>ThrowIfInvalidTruncatedSize</b> (size_t size) const </td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<h3>template<class T><br/>
class TruncatedHashTemplate< T ></h3>
<p>construct new HashModule with smaller <a class="el" href="class_truncated_hash_template.html#a031c1782432ae1e0f7bff2bb2ae382a5" title="size of the hash/digest/MAC returned by Final()">DigestSize()</a> from existing one </p>
<p>Definition at line <a class="el" href="trunhash_8h_source.html#l00019">19</a> of file <a class="el" href="trunhash_8h_source.html">trunhash.h</a>.</p>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a39b0a4c4cdc11fda358f9975b5e4137e"></a><!-- doxytag: member="TruncatedHashTemplate::Ref" ref="a39b0a4c4cdc11fda358f9975b5e4137e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="class_hash_transformation.html">HashTransformation</a>& HashTransformation::Ref </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [inline, inherited]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return a reference to this object, </p>
<p>This function is useful for passing a temporary <a class="el" href="class_hash_transformation.html" title="interface for hash functions and data processing part of MACs">HashTransformation</a> object to a function that takes a non-const reference. </p>
<p>Definition at line <a class="el" href="cryptlib_8h_source.html#l00546">546</a> of file <a class="el" href="cryptlib_8h_source.html">cryptlib.h</a>.</p>
</div>
</div>
<a class="anchor" id="aa0b8c7a110d8968268fd02ec32b9a8e8"></a><!-- doxytag: member="TruncatedHashTemplate::Final" ref="aa0b8c7a110d8968268fd02ec32b9a8e8" args="(byte *digest)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void HashTransformation::Final </td>
<td>(</td>
<td class="paramtype">byte * </td>
<td class="paramname"> <em>digest</em></td>
<td> ) </td>
<td><code> [inline, virtual, inherited]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>compute hash for current message, then restart for a new message </p>
<dl class="pre"><dt><b>Precondition:</b></dt><dd>size of digest == <a class="el" href="class_hash_transformation.html#a9f42cc280bac76b884ad12615c0dabb5" title="size of the hash/digest/MAC returned by Final()">DigestSize()</a>. </dd></dl>
<p>Definition at line <a class="el" href="cryptlib_8h_source.html#l00556">556</a> of file <a class="el" href="cryptlib_8h_source.html">cryptlib.h</a>.</p>
<p>Referenced by <a class="el" href="pwdbased_8h_source.html#l00085">PKCS5_PBKDF2_HMAC< T >::DeriveKey()</a>, <a class="el" href="randpool_8cpp_source.html#l00026">RandomPool::IncorporateEntropy()</a>, and <a class="el" href="hmac_8cpp_source.html#l00067">HMAC_Base::TruncatedFinal()</a>.</p>
</div>
</div>
<a class="anchor" id="a16c4aecd047015d513feef4ed5b929ba"></a><!-- doxytag: member="TruncatedHashTemplate::Verify" ref="a16c4aecd047015d513feef4ed5b929ba" args="(const byte *digest)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual bool HashTransformation::Verify </td>
<td>(</td>
<td class="paramtype">const byte * </td>
<td class="paramname"> <em>digest</em></td>
<td> ) </td>
<td><code> [inline, virtual, inherited]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>verify that digest is a valid digest for the current message, then reinitialize the object </p>
<p>Default implementation is to call <a class="el" href="class_hash_transformation.html#aa0b8c7a110d8968268fd02ec32b9a8e8" title="compute hash for current message, then restart for a new message">Final()</a> and do a bitwise comparison between its output and digest. </p>
<p>Definition at line <a class="el" href="cryptlib_8h_source.html#l00586">586</a> of file <a class="el" href="cryptlib_8h_source.html">cryptlib.h</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="trunhash_8h_source.html">trunhash.h</a></li>
</ul>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on 9 Dec 2009 for Crypto++ by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>
distrib
>
Fedora
>
13
>
i386
>
media
>
os
>
by-pkgid
>
07dfcfe50d66c9a48a3c5e6c1693f12a
>
files
>
1532
