<!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 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 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="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 <<a class="el" href="cryptlib_8h_source.html">cryptlib.h</a>></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< PK_Signer, DL_PrivateKey< SCHEME_OPTIONS::Element > >" shape="rect" coords="0,280,771,304"/> <area href="class_d_l___signature_scheme_base.html" alt="DL_SignatureSchemeBase< PK_Signer, DL_PrivateKey< T > >" shape="rect" coords="781,280,1552,304"/> <area href="class_t_f___signature_scheme_base.html" alt="TF_SignatureSchemeBase< PK_Signer, TF_Base< RandomizedTrapdoorFunctionInverse, PK_SignatureMessageEncodingMethod > >" shape="rect" coords="1562,280,2333,304"/> <area href="class_d_l___signer_base.html" alt="DL_SignerBase< SCHEME_OPTIONS::Element >" shape="rect" coords="0,336,771,360"/> <area href="class_d_l___signer_base.html" title="_" alt="DL_SignerBase< T >" 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< DL_SignerBase< SCHEME_OPTIONS::Element >, SCHEME_OPTIONS::AlgorithmInfo >" shape="rect" coords="0,392,771,416"/> <area href="class_algorithm_impl.html" alt="AlgorithmImpl< TF_SignerBase, SCHEME_OPTIONS::AlgorithmInfo >" shape="rect" coords="1562,392,2333,416"/> <area href="class_d_l___object_impl_base.html" alt="DL_ObjectImplBase< DL_SignerBase< SCHEME_OPTIONS::Element >, SCHEME_OPTIONS, SCHEME_OPTIONS::PrivateKey >" shape="rect" coords="0,448,771,472"/> <area href="class_t_f___object_impl_base.html" alt="TF_ObjectImplBase< TF_SignerBase, SCHEME_OPTIONS, SCHEME_OPTIONS::PrivateKey >" shape="rect" coords="1562,448,2333,472"/> <area href="class_d_l___object_impl.html" alt="DL_ObjectImpl< DL_SignerBase< SCHEME_OPTIONS::Element >, SCHEME_OPTIONS, SCHEME_OPTIONS::PrivateKey >" shape="rect" coords="0,504,771,528"/> <area href="class_t_f___object_impl.html" alt="TF_ObjectImpl< TF_SignerBase, SCHEME_OPTIONS, SCHEME_OPTIONS::PrivateKey >" shape="rect" coords="1562,504,2333,528"/> <area href="class_d_l___signer_impl.html" title="_" alt="DL_SignerImpl< SCHEME_OPTIONS >" shape="rect" coords="0,560,771,584"/> <area href="class_t_f___signer_impl.html" title="_" alt="TF_SignerImpl< SCHEME_OPTIONS >" 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 &rng) const =0" --> virtual <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> * </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> &rng) const =0</td></tr> <tr><td class="mdescLeft"> </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 &messageAccumulator, const byte *recoverableMessage, size_t recoverableMessageLength) const =0" --> virtual void </td><td class="memItemRight" valign="bottom"><b>InputRecoverableMessage</b> (<a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &messageAccumulator, const byte *recoverableMessage, size_t recoverableMessageLength) const =0</td></tr> <tr><td class="memItemLeft" align="right" valign="top">virtual size_t </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> &rng, <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> *messageAccumulator, byte *signature) const </td></tr> <tr><td class="mdescLeft"> </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 </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> &rng, <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &messageAccumulator, byte *signature, bool restart=true) const =0</td></tr> <tr><td class="mdescLeft"> </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 </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> &rng, const byte *message, size_t messageLen, byte *signature) const </td></tr> <tr><td class="mdescLeft"> </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 </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> &rng, const byte *recoverableMessage, size_t recoverableMessageLength, const byte *nonrecoverableMessage, size_t nonrecoverableMessageLength, byte *signature) const </td></tr> <tr><td class="mdescLeft"> </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 </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"> </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 </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"> </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 </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"> </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 </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"> </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 </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"> </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 </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"> </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 </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"> </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 </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"> </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> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_private_key_algorithm.html#a48cf4528f16263f2200d5b908a0b8ffb">AccessMaterial</a> ()</td></tr> <tr><td class="mdescLeft"> </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> & </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"> </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> & </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> & </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 &bt)" --> void </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> &bt)</td></tr> <tr><td class="mdescLeft"> </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 &bt) const " --> void </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> &bt) const </td></tr> <tr><td class="mdescLeft"> </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 </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="PK_Signer::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> </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 &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> & </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> * </td> <td class="paramname"><em>messageAccumulator</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">byte * </td> <td class="paramname"><em>signature</em> </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 &rng, PK_MessageAccumulator &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> & </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> & </td> <td class="paramname"><em>messageAccumulator</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">byte * </td> <td class="paramname"><em>signature</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">bool </td> <td class="paramname"><em>restart</em> = <code>true</code> </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< T ></a>, and <a class="el" href="class_d_l___signer_base.html#a1c0d9588fc5a340a14342c474b2a52e2">DL_SignerBase< SCHEME_OPTIONS::Element ></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 &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> & </td> <td class="paramname"><em>rng</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const byte * </td> <td class="paramname"><em>message</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>messageLen</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">byte * </td> <td class="paramname"><em>signature</em> </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 &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> & </td> <td class="paramname"><em>rng</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const byte * </td> <td class="paramname"><em>recoverableMessage</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>recoverableMessageLength</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const byte * </td> <td class="paramname"><em>nonrecoverableMessage</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>nonrecoverableMessageLength</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">byte * </td> <td class="paramname"><em>signature</em> </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'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> & </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  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.4 </small></address> </body> </html>