Sophie

Sophie

distrib > Fedora > 14 > x86_64 > by-pkgid > 23e07fd43e778a61ff4b78161a3e2389 > files > 1108

cryptopp-doc-5.6.1-5.fc14.noarch.rpm

<!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++: PK_Signer Class 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.7.4 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td style="padding-left: 0.5em;">
   <div id="projectname">Crypto++</div>
  </td>
 </tr>
 </tbody>
</table>
</div>
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;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 id="navrow2" class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Class&#160;List</span></a></li>
      <li><a href="classes.html"><span>Class&#160;Index</span></a></li>
      <li><a href="hierarchy.html"><span>Class&#160;Hierarchy</span></a></li>
      <li><a href="functions.html"><span>Class&#160;Members</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#pub-methods">Public Member Functions</a>  </div>
  <div class="headertitle">
<div class="title">PK_Signer Class Reference</div>  </div>
</div>
<div class="contents">
<!-- doxytag: class="PK_Signer" --><!-- doxytag: inherits="PK_SignatureScheme,PrivateKeyAlgorithm" -->
<p>interface for public-key signers  
 <a href="class_p_k___signer.html#details">More...</a></p>

<p><code>#include &lt;<a class="el" href="cryptlib_8h_source.html">cryptlib.h</a>&gt;</code></p>
<div class="dynheader">
Inheritance diagram for PK_Signer:</div>
<div class="dyncontent">
 <div class="center">
  <img src="class_p_k___signer.png" usemap="#PK_Signer_map" alt=""/>
  <map id="PK_Signer_map" name="PK_Signer_map">
<area href="class_p_k___signature_scheme.html" title="interface for public-key signers and verifiers" alt="PK_SignatureScheme" shape="rect" coords="390,168,1161,192"/>
<area href="class_private_key_algorithm.html" title="interface for asymmetric algorithms using private keys" alt="PrivateKeyAlgorithm" shape="rect" coords="1171,168,1942,192"/>
<area href="class_asymmetric_algorithm.html" title="interface for asymmetric algorithms" alt="AsymmetricAlgorithm" shape="rect" coords="1171,112,1942,136"/>
<area href="class_algorithm.html" title="interface for all crypto algorithms" alt="Algorithm" shape="rect" coords="1171,56,1942,80"/>
<area href="class_clonable.html" title="interface for cloning objects, this is not implemented by most classes yet" alt="Clonable" shape="rect" coords="1171,0,1942,24"/>
<area href="class_d_l___signature_scheme_base.html" alt="DL_SignatureSchemeBase&lt; PK_Signer, DL_PrivateKey&lt; SCHEME_OPTIONS::Element &gt; &gt;" shape="rect" coords="0,280,771,304"/>
<area href="class_d_l___signature_scheme_base.html" alt="DL_SignatureSchemeBase&lt; PK_Signer, DL_PrivateKey&lt; T &gt; &gt;" shape="rect" coords="781,280,1552,304"/>
<area href="class_t_f___signature_scheme_base.html" alt="TF_SignatureSchemeBase&lt; PK_Signer, TF_Base&lt; RandomizedTrapdoorFunctionInverse, PK_SignatureMessageEncodingMethod &gt; &gt;" shape="rect" coords="1562,280,2333,304"/>
<area href="class_d_l___signer_base.html" alt="DL_SignerBase&lt; SCHEME_OPTIONS::Element &gt;" shape="rect" coords="0,336,771,360"/>
<area href="class_d_l___signer_base.html" title="_" alt="DL_SignerBase&lt; T &gt;" shape="rect" coords="781,336,1552,360"/>
<area href="class_t_f___signer_base.html" title="_" alt="TF_SignerBase" shape="rect" coords="1562,336,2333,360"/>
<area href="class_algorithm_impl.html" alt="AlgorithmImpl&lt; DL_SignerBase&lt; SCHEME_OPTIONS::Element &gt;, SCHEME_OPTIONS::AlgorithmInfo &gt;" shape="rect" coords="0,392,771,416"/>
<area href="class_algorithm_impl.html" alt="AlgorithmImpl&lt; TF_SignerBase, SCHEME_OPTIONS::AlgorithmInfo &gt;" shape="rect" coords="1562,392,2333,416"/>
<area href="class_d_l___object_impl_base.html" alt="DL_ObjectImplBase&lt; DL_SignerBase&lt; SCHEME_OPTIONS::Element &gt;, SCHEME_OPTIONS, SCHEME_OPTIONS::PrivateKey &gt;" shape="rect" coords="0,448,771,472"/>
<area href="class_t_f___object_impl_base.html" alt="TF_ObjectImplBase&lt; TF_SignerBase, SCHEME_OPTIONS, SCHEME_OPTIONS::PrivateKey &gt;" shape="rect" coords="1562,448,2333,472"/>
<area href="class_d_l___object_impl.html" alt="DL_ObjectImpl&lt; DL_SignerBase&lt; SCHEME_OPTIONS::Element &gt;, SCHEME_OPTIONS, SCHEME_OPTIONS::PrivateKey &gt;" shape="rect" coords="0,504,771,528"/>
<area href="class_t_f___object_impl.html" alt="TF_ObjectImpl&lt; TF_SignerBase, SCHEME_OPTIONS, SCHEME_OPTIONS::PrivateKey &gt;" shape="rect" coords="1562,504,2333,528"/>
<area href="class_d_l___signer_impl.html" title="_" alt="DL_SignerImpl&lt; SCHEME_OPTIONS &gt;" shape="rect" coords="0,560,771,584"/>
<area href="class_t_f___signer_impl.html" title="_" alt="TF_SignerImpl&lt; SCHEME_OPTIONS &gt;" shape="rect" coords="1562,560,2333,584"/>
</map>
 </div></div>

<p><a href="class_p_k___signer-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aff85d006e814ccc8ac943b145a0bfaf9"></a><!-- doxytag: member="PK_Signer::NewSignatureAccumulator" ref="aff85d006e814ccc8ac943b145a0bfaf9" args="(RandomNumberGenerator &amp;rng) const =0" -->
virtual <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signer.html#aff85d006e814ccc8ac943b145a0bfaf9">NewSignatureAccumulator</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &amp;rng) const =0</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">create a new <a class="el" href="class_hash_transformation.html" title="interface for hash functions and data processing part of MACs">HashTransformation</a> to accumulate the message to be signed <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a9051dec5ad6586063f83d131edf86217"></a><!-- doxytag: member="PK_Signer::InputRecoverableMessage" ref="a9051dec5ad6586063f83d131edf86217" args="(PK_MessageAccumulator &amp;messageAccumulator, const byte *recoverableMessage, size_t recoverableMessageLength) const =0" -->
virtual void&#160;</td><td class="memItemRight" valign="bottom"><b>InputRecoverableMessage</b> (<a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &amp;messageAccumulator, const byte *recoverableMessage, size_t recoverableMessageLength) const =0</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signer.html#a28de428238711210d765b6389062e6e2">Sign</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &amp;rng, <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> *messageAccumulator, byte *signature) const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">sign and delete messageAccumulator (even in case of exception thrown)  <a href="#a28de428238711210d765b6389062e6e2"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signer.html#afbcf3f00d761f681839ae6264743dd34">SignAndRestart</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &amp;rng, <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &amp;messageAccumulator, byte *signature, bool restart=true) const =0</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">sign and restart messageAccumulator  <a href="#afbcf3f00d761f681839ae6264743dd34"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signer.html#a08920dfd51f5d0d8e5f77c8f20b56ce2">SignMessage</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &amp;rng, const byte *message, size_t messageLen, byte *signature) const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">sign a message  <a href="#a08920dfd51f5d0d8e5f77c8f20b56ce2"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signer.html#a76eb862d0cb8d80e0bee7ad52a0da707">SignMessageWithRecovery</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &amp;rng, const byte *recoverableMessage, size_t recoverableMessageLength, const byte *nonrecoverableMessage, size_t nonrecoverableMessageLength, byte *signature) const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">sign a recoverable message  <a href="#a76eb862d0cb8d80e0bee7ad52a0da707"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aab30ad8e2da2d706cf6c69bdac963afc"></a><!-- doxytag: member="PK_Signer::SignatureLength" ref="aab30ad8e2da2d706cf6c69bdac963afc" args="() const =0" -->
virtual size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#aab30ad8e2da2d706cf6c69bdac963afc">SignatureLength</a> () const =0</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">signature length if it only depends on the key, otherwise 0 <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af04668d211a923ba03f2721c220272e9"></a><!-- doxytag: member="PK_Signer::MaxSignatureLength" ref="af04668d211a923ba03f2721c220272e9" args="(size_t recoverablePartLength=0) const " -->
virtual size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#af04668d211a923ba03f2721c220272e9">MaxSignatureLength</a> (size_t recoverablePartLength=0) const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">maximum signature length produced for a given length of recoverable message part <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a1f6a62ce468f172636f117ee0693038f"></a><!-- doxytag: member="PK_Signer::MaxRecoverableLength" ref="a1f6a62ce468f172636f117ee0693038f" args="() const =0" -->
virtual size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#a1f6a62ce468f172636f117ee0693038f">MaxRecoverableLength</a> () const =0</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">length of longest message that can be recovered, or 0 if this signature scheme does not support message recovery <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a2f2a599ba385e63766d4a7f7ccf2a884"></a><!-- doxytag: member="PK_Signer::MaxRecoverableLengthFromSignatureLength" ref="a2f2a599ba385e63766d4a7f7ccf2a884" args="(size_t signatureLength) const =0" -->
virtual size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#a2f2a599ba385e63766d4a7f7ccf2a884">MaxRecoverableLengthFromSignatureLength</a> (size_t signatureLength) const =0</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">length of longest message that can be recovered from a signature of given length, or 0 if this signature scheme does not support message recovery <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#adeb758d5f8ae8fad137d11ad1c5c60c0">IsProbabilistic</a> () const =0</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">requires a random number generator to sign  <a href="#adeb758d5f8ae8fad137d11ad1c5c60c0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a00368da9563ce49efc42b5cd0d9c7738"></a><!-- doxytag: member="PK_Signer::AllowNonrecoverablePart" ref="a00368da9563ce49efc42b5cd0d9c7738" args="() const =0" -->
virtual bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#a00368da9563ce49efc42b5cd0d9c7738">AllowNonrecoverablePart</a> () const =0</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">whether or not a non-recoverable message part can be signed <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a780bca8d276b62bd28a54382f208ce36"></a><!-- doxytag: member="PK_Signer::SignatureUpfront" ref="a780bca8d276b62bd28a54382f208ce36" args="() const " -->
virtual bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#a780bca8d276b62bd28a54382f208ce36">SignatureUpfront</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">if this function returns true, during verification you must input the signature before the message, otherwise you can input it at anytime */ <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a168ca843d63ddababdf2cee3eaa02813"></a><!-- doxytag: member="PK_Signer::RecoverablePartFirst" ref="a168ca843d63ddababdf2cee3eaa02813" args="() const =0" -->
virtual bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#a168ca843d63ddababdf2cee3eaa02813">RecoverablePartFirst</a> () const =0</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">whether you must input the recoverable part before the non-recoverable part during signing <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a48cf4528f16263f2200d5b908a0b8ffb"></a><!-- doxytag: member="PK_Signer::AccessMaterial" ref="a48cf4528f16263f2200d5b908a0b8ffb" args="()" -->
<a class="el" href="class_crypto_material.html">CryptoMaterial</a> &amp;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_private_key_algorithm.html#a48cf4528f16263f2200d5b908a0b8ffb">AccessMaterial</a> ()</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">returns a reference to the crypto material used by this object <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a0199217f43af73a6ad78fe1303903fe3"></a><!-- doxytag: member="PK_Signer::GetMaterial" ref="a0199217f43af73a6ad78fe1303903fe3" args="() const " -->
const <a class="el" href="class_crypto_material.html">CryptoMaterial</a> &amp;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_private_key_algorithm.html#a0199217f43af73a6ad78fe1303903fe3">GetMaterial</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">returns a const reference to the crypto material used by this object <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ae2085815947c2ae7b3f9f614612e0c17"></a><!-- doxytag: member="PK_Signer::AccessPrivateKey" ref="ae2085815947c2ae7b3f9f614612e0c17" args="()=0" -->
virtual <a class="el" href="class_private_key.html">PrivateKey</a> &amp;&#160;</td><td class="memItemRight" valign="bottom"><b>AccessPrivateKey</b> ()=0</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a24edb4d57abc975e0e40ee02ce8f08fa"></a><!-- doxytag: member="PK_Signer::GetPrivateKey" ref="a24edb4d57abc975e0e40ee02ce8f08fa" args="() const " -->
virtual const <a class="el" href="class_private_key.html">PrivateKey</a> &amp;&#160;</td><td class="memItemRight" valign="bottom"><b>GetPrivateKey</b> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a522dbfcd5c1a46bf1be301cec26d6534"></a><!-- doxytag: member="PK_Signer::BERDecode" ref="a522dbfcd5c1a46bf1be301cec26d6534" args="(BufferedTransformation &amp;bt)" -->
void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_asymmetric_algorithm.html#a522dbfcd5c1a46bf1be301cec26d6534">BERDecode</a> (<a class="el" href="class_buffered_transformation.html">BufferedTransformation</a> &amp;bt)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">for backwards compatibility, calls <a class="el" href="class_asymmetric_algorithm.html#ad99d55413166b69a0a12e10d111926c8" title="returns a reference to the crypto material used by this object">AccessMaterial()</a>.Load(bt) <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a2d704079890783422b0a44653480ab83"></a><!-- doxytag: member="PK_Signer::DEREncode" ref="a2d704079890783422b0a44653480ab83" args="(BufferedTransformation &amp;bt) const " -->
void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_asymmetric_algorithm.html#a2d704079890783422b0a44653480ab83">DEREncode</a> (<a class="el" href="class_buffered_transformation.html">BufferedTransformation</a> &amp;bt) const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">for backwards compatibility, calls <a class="el" href="class_asymmetric_algorithm.html#adf9cc798c5a2d20ab3436dbad8e6df2d" title="returns a const reference to the crypto material used by this object">GetMaterial()</a>.Save(bt) <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="acd21c6715add4884fa043eaf51655039"></a><!-- doxytag: member="PK_Signer::AlgorithmName" ref="acd21c6715add4884fa043eaf51655039" args="() const " -->
virtual std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_algorithm.html#acd21c6715add4884fa043eaf51655039">AlgorithmName</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</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="PK_Signer::Clone" ref="a24b43349a71e1f98508eeb10b31a0a62" args="() const " -->
virtual <a class="el" href="class_clonable.html">Clonable</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_clonable.html#a24b43349a71e1f98508eeb10b31a0a62">Clone</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">this is not implemented by most classes yet <br/></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>interface for public-key signers </p>

<p>Definition at line <a class="el" href="cryptlib_8h_source.html#l01347">1347</a> of file <a class="el" href="cryptlib_8h_source.html">cryptlib.h</a>.</p>
</div><hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a28de428238711210d765b6389062e6e2"></a><!-- doxytag: member="PK_Signer::Sign" ref="a28de428238711210d765b6389062e6e2" args="(RandomNumberGenerator &amp;rng, PK_MessageAccumulator *messageAccumulator, byte *signature) const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">size_t PK_Signer::Sign </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &amp;&#160;</td>
          <td class="paramname"><em>rng</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> *&#160;</td>
          <td class="paramname"><em>messageAccumulator</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">byte *&#160;</td>
          <td class="paramname"><em>signature</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td> const<code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>sign and delete messageAccumulator (even in case of exception thrown) </p>
<dl class="pre"><dt><b>Precondition:</b></dt><dd>size of signature == <a class="el" href="class_p_k___signature_scheme.html#af04668d211a923ba03f2721c220272e9" title="maximum signature length produced for a given length of recoverable message part">MaxSignatureLength()</a> </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>actual signature length </dd></dl>

<p>Definition at line <a class="el" href="cryptlib_8cpp_source.html#l00756">756</a> of file <a class="el" href="cryptlib_8cpp_source.html">cryptlib.cpp</a>.</p>

<p>References <a class="el" href="class_p_k___signer.html#afbcf3f00d761f681839ae6264743dd34">SignAndRestart()</a>.</p>

<p>Referenced by <a class="el" href="filters_8cpp_source.html#l00924">SignerFilter::Put2()</a>.</p>

</div>
</div>
<a class="anchor" id="afbcf3f00d761f681839ae6264743dd34"></a><!-- doxytag: member="PK_Signer::SignAndRestart" ref="afbcf3f00d761f681839ae6264743dd34" args="(RandomNumberGenerator &amp;rng, PK_MessageAccumulator &amp;messageAccumulator, byte *signature, bool restart=true) const =0" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual size_t PK_Signer::SignAndRestart </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &amp;&#160;</td>
          <td class="paramname"><em>rng</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &amp;&#160;</td>
          <td class="paramname"><em>messageAccumulator</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">byte *&#160;</td>
          <td class="paramname"><em>signature</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&#160;</td>
          <td class="paramname"><em>restart</em> = <code>true</code>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td> const<code> [pure virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>sign and restart messageAccumulator </p>
<dl class="pre"><dt><b>Precondition:</b></dt><dd>size of signature == <a class="el" href="class_p_k___signature_scheme.html#af04668d211a923ba03f2721c220272e9" title="maximum signature length produced for a given length of recoverable message part">MaxSignatureLength()</a> </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>actual signature length </dd></dl>

<p>Implemented in <a class="el" href="class_t_f___signer_base.html#a31c080b001c73b07ee26730383250fd7">TF_SignerBase</a>, <a class="el" href="class_d_l___signer_base.html#a1c0d9588fc5a340a14342c474b2a52e2">DL_SignerBase&lt; T &gt;</a>, and <a class="el" href="class_d_l___signer_base.html#a1c0d9588fc5a340a14342c474b2a52e2">DL_SignerBase&lt; SCHEME_OPTIONS::Element &gt;</a>.</p>

<p>Referenced by <a class="el" href="cryptlib_8cpp_source.html#l00756">Sign()</a>, <a class="el" href="cryptlib_8cpp_source.html#l00762">SignMessage()</a>, and <a class="el" href="cryptlib_8cpp_source.html#l00769">SignMessageWithRecovery()</a>.</p>

</div>
</div>
<a class="anchor" id="a08920dfd51f5d0d8e5f77c8f20b56ce2"></a><!-- doxytag: member="PK_Signer::SignMessage" ref="a08920dfd51f5d0d8e5f77c8f20b56ce2" args="(RandomNumberGenerator &amp;rng, const byte *message, size_t messageLen, byte *signature) const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">size_t PK_Signer::SignMessage </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &amp;&#160;</td>
          <td class="paramname"><em>rng</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const byte *&#160;</td>
          <td class="paramname"><em>message</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t&#160;</td>
          <td class="paramname"><em>messageLen</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">byte *&#160;</td>
          <td class="paramname"><em>signature</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td> const<code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>sign a message </p>
<dl class="pre"><dt><b>Precondition:</b></dt><dd>size of signature == <a class="el" href="class_p_k___signature_scheme.html#af04668d211a923ba03f2721c220272e9" title="maximum signature length produced for a given length of recoverable message part">MaxSignatureLength()</a> </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>actual signature length </dd></dl>

<p>Definition at line <a class="el" href="cryptlib_8cpp_source.html#l00762">762</a> of file <a class="el" href="cryptlib_8cpp_source.html">cryptlib.cpp</a>.</p>

<p>References <a class="el" href="class_p_k___signer.html#aff85d006e814ccc8ac943b145a0bfaf9">NewSignatureAccumulator()</a>, and <a class="el" href="class_p_k___signer.html#afbcf3f00d761f681839ae6264743dd34">SignAndRestart()</a>.</p>

</div>
</div>
<a class="anchor" id="a76eb862d0cb8d80e0bee7ad52a0da707"></a><!-- doxytag: member="PK_Signer::SignMessageWithRecovery" ref="a76eb862d0cb8d80e0bee7ad52a0da707" args="(RandomNumberGenerator &amp;rng, const byte *recoverableMessage, size_t recoverableMessageLength, const byte *nonrecoverableMessage, size_t nonrecoverableMessageLength, byte *signature) const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">size_t PK_Signer::SignMessageWithRecovery </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &amp;&#160;</td>
          <td class="paramname"><em>rng</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const byte *&#160;</td>
          <td class="paramname"><em>recoverableMessage</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t&#160;</td>
          <td class="paramname"><em>recoverableMessageLength</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const byte *&#160;</td>
          <td class="paramname"><em>nonrecoverableMessage</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t&#160;</td>
          <td class="paramname"><em>nonrecoverableMessageLength</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">byte *&#160;</td>
          <td class="paramname"><em>signature</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td> const<code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>sign a recoverable message </p>
<dl class="pre"><dt><b>Precondition:</b></dt><dd>size of signature == MaxSignatureLength(recoverableMessageLength) </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>actual signature length </dd></dl>

<p>Definition at line <a class="el" href="cryptlib_8cpp_source.html#l00769">769</a> of file <a class="el" href="cryptlib_8cpp_source.html">cryptlib.cpp</a>.</p>

<p>References <a class="el" href="class_p_k___signer.html#aff85d006e814ccc8ac943b145a0bfaf9">NewSignatureAccumulator()</a>, and <a class="el" href="class_p_k___signer.html#afbcf3f00d761f681839ae6264743dd34">SignAndRestart()</a>.</p>

</div>
</div>
<a class="anchor" id="adeb758d5f8ae8fad137d11ad1c5c60c0"></a><!-- doxytag: member="PK_Signer::IsProbabilistic" ref="adeb758d5f8ae8fad137d11ad1c5c60c0" args="() const =0" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual bool PK_SignatureScheme::IsProbabilistic </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [pure virtual, inherited]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>requires a random number generator to sign </p>
<p>if this returns false, <a class="el" href="cryptlib_8h.html#a1e53479a6d427158247ac1ece3161a6d" title="returns a reference that can be passed to functions that ask for a RNG but doesn&#39;t actually use it...">NullRNG()</a> can be passed to functions that take <a class="el" href="class_random_number_generator.html" title="interface for random number generators">RandomNumberGenerator</a> &amp; </p>

</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="cryptlib_8h_source.html">cryptlib.h</a></li>
<li><a class="el" href="cryptlib_8cpp_source.html">cryptlib.cpp</a></li>
</ul>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Sun Oct 16 2011 for Crypto++ by&#160;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.4 </small></address>
</body>
</html>