<!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.14"/> <meta name="viewport" content="width=device-width, initial-scale=1"/> <title>Crypto++: PK_Verifier Class Reference</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 id="projectalign" style="padding-left: 0.5em;"> <div id="projectname">Crypto++  <span id="projectnumber">7.0</span> </div> <div id="projectbrief">Free C++ class library of cryptographic schemes</div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.14 --> <script type="text/javascript" src="menudata.js"></script> <script type="text/javascript" src="menu.js"></script> <script type="text/javascript"> /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ $(function() { initMenu('',false,false,'search.php','Search'); }); /* @license-end */</script> <div id="main-nav"></div> </div><!-- top --> <div class="header"> <div class="summary"> <a href="#pub-methods">Public Member Functions</a> | <a href="class_p_k___verifier-members.html">List of all members</a> </div> <div class="headertitle"> <div class="title">PK_Verifier Class Reference<span class="mlabels"><span class="mlabel">abstract</span></span></div> </div> </div><!--header--> <div class="contents"> <p>Interface for public-key signature verifiers. <a href="class_p_k___verifier.html#details">More...</a></p> <div id="dynsection-0" onclick="return toggleVisibility(this)" class="dynheader closed" style="cursor:pointer;"> <img id="dynsection-0-trigger" src="closed.png" alt="+"/> Inheritance diagram for PK_Verifier:</div> <div id="dynsection-0-summary" class="dynsummary" style="display:block;"> </div> <div id="dynsection-0-content" class="dyncontent" style="display:none;"> <div class="center"> <img src="class_p_k___verifier.png" usemap="#PK_5FVerifier_map" alt=""/> <map id="PK_5FVerifier_map" name="PK_5FVerifier_map"> <area href="class_p_k___signature_scheme.html" title="Interface for public-key signers and verifiers. " alt="PK_SignatureScheme" shape="rect" coords="375,168,1115,192"/> <area href="class_public_key_algorithm.html" title="Interface for asymmetric algorithms using public keys. " alt="PublicKeyAlgorithm" shape="rect" coords="1125,168,1865,192"/> <area href="class_asymmetric_algorithm.html" title="Interface for asymmetric algorithms. " alt="AsymmetricAlgorithm" shape="rect" coords="1125,112,1865,136"/> <area href="class_algorithm.html" title="Interface for all crypto algorithms. " alt="Algorithm" shape="rect" coords="1125,56,1865,80"/> <area href="class_clonable.html" title="Interface for cloning objects. " alt="Clonable" shape="rect" coords="1125,0,1865,24"/> <area href="class_d_l___signature_scheme_base.html" alt="DL_SignatureSchemeBase< PK_Verifier, DL_PublicKey< SCHEME_OPTIONS::Element > >" shape="rect" coords="0,280,740,304"/> <area href="class_d_l___signature_scheme_base.html" alt="DL_SignatureSchemeBase< PK_Verifier, DL_PublicKey< T > >" shape="rect" coords="750,280,1490,304"/> <area href="class_t_f___signature_scheme_base.html" alt="TF_SignatureSchemeBase< PK_Verifier, TF_Base< TrapdoorFunction, PK_SignatureMessageEncodingMethod > >" shape="rect" coords="1500,280,2240,304"/> <area href="class_d_l___verifier_base.html" alt="DL_VerifierBase< SCHEME_OPTIONS::Element >" shape="rect" coords="0,336,740,360"/> <area href="class_d_l___verifier_base.html" title="Discret Log (DL) Verifier base class. " alt="DL_VerifierBase< T >" shape="rect" coords="750,336,1490,360"/> <area href="class_t_f___verifier_base.html" title="Trapdoor Function (TF) Verifier base class. " alt="TF_VerifierBase" shape="rect" coords="1500,336,2240,360"/> <area href="class_algorithm_impl.html" alt="AlgorithmImpl< DL_VerifierBase< SCHEME_OPTIONS::Element >, SCHEME_OPTIONS::AlgorithmInfo >" shape="rect" coords="0,392,740,416"/> <area href="class_algorithm_impl.html" alt="AlgorithmImpl< TF_VerifierBase, SCHEME_OPTIONS::AlgorithmInfo >" shape="rect" coords="1500,392,2240,416"/> <area href="class_d_l___object_impl_base.html" alt="DL_ObjectImplBase< DL_VerifierBase< SCHEME_OPTIONS::Element >, SCHEME_OPTIONS, SCHEME_OPTIONS::PublicKey >" shape="rect" coords="0,448,740,472"/> <area href="class_t_f___object_impl_base.html" alt="TF_ObjectImplBase< TF_VerifierBase, SCHEME_OPTIONS, SCHEME_OPTIONS::PublicKey >" shape="rect" coords="1500,448,2240,472"/> <area href="class_d_l___object_impl.html" alt="DL_ObjectImpl< DL_VerifierBase< SCHEME_OPTIONS::Element >, SCHEME_OPTIONS, SCHEME_OPTIONS::PublicKey >" shape="rect" coords="0,504,740,528"/> <area href="class_t_f___object_impl.html" alt="TF_ObjectImpl< TF_VerifierBase, SCHEME_OPTIONS, SCHEME_OPTIONS::PublicKey >" shape="rect" coords="1500,504,2240,528"/> <area href="class_d_l___verifier_impl.html" title="Discrete Log (DL) verifier implementation. " alt="DL_VerifierImpl< SCHEME_OPTIONS >" shape="rect" coords="0,560,740,584"/> <area href="class_t_f___verifier_impl.html" title="Trapdoor Function (TF) encryptor options. " alt="TF_VerifierImpl< SCHEME_OPTIONS >" shape="rect" coords="1500,560,2240,584"/> </map> </div></div> <table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a> Public Member Functions</h2></td></tr> <tr class="memitem:acd874268dab653dde01409fc9dfd2069"><td class="memItemLeft" align="right" valign="top">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___verifier.html#acd874268dab653dde01409fc9dfd2069">NewVerificationAccumulator</a> () const =0</td></tr> <tr class="memdesc:acd874268dab653dde01409fc9dfd2069"><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 verified. <a href="#acd874268dab653dde01409fc9dfd2069">More...</a><br /></td></tr> <tr class="separator:acd874268dab653dde01409fc9dfd2069"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a515aa448e7fc3a5c6e422e65500ab507"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#a515aa448e7fc3a5c6e422e65500ab507">InputSignature</a> (<a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &messageAccumulator, const byte *signature, size_t signatureLength) const =0</td></tr> <tr class="memdesc:a515aa448e7fc3a5c6e422e65500ab507"><td class="mdescLeft"> </td><td class="mdescRight">Input signature into a message accumulator. <a href="#a515aa448e7fc3a5c6e422e65500ab507">More...</a><br /></td></tr> <tr class="separator:a515aa448e7fc3a5c6e422e65500ab507"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a447ba2b73d8fa9e37b1995f3710032b8"><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#a447ba2b73d8fa9e37b1995f3710032b8">Verify</a> (<a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> *messageAccumulator) const</td></tr> <tr class="memdesc:a447ba2b73d8fa9e37b1995f3710032b8"><td class="mdescLeft"> </td><td class="mdescRight">Check whether messageAccumulator contains a valid signature and message. <a href="#a447ba2b73d8fa9e37b1995f3710032b8">More...</a><br /></td></tr> <tr class="separator:a447ba2b73d8fa9e37b1995f3710032b8"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a36e176dc8a0d3f924938cb2b07021f28"><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#a36e176dc8a0d3f924938cb2b07021f28">VerifyAndRestart</a> (<a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &messageAccumulator) const =0</td></tr> <tr class="memdesc:a36e176dc8a0d3f924938cb2b07021f28"><td class="mdescLeft"> </td><td class="mdescRight">Check whether messageAccumulator contains a valid signature and message, and restart messageAccumulator. <a href="#a36e176dc8a0d3f924938cb2b07021f28">More...</a><br /></td></tr> <tr class="separator:a36e176dc8a0d3f924938cb2b07021f28"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a52cb11a1490a8011e41d02db5c983a8c"><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#a52cb11a1490a8011e41d02db5c983a8c">VerifyMessage</a> (const byte *message, size_t messageLen, const byte *signature, size_t signatureLen) const</td></tr> <tr class="memdesc:a52cb11a1490a8011e41d02db5c983a8c"><td class="mdescLeft"> </td><td class="mdescRight">Check whether input signature is a valid signature for input message. <a href="#a52cb11a1490a8011e41d02db5c983a8c">More...</a><br /></td></tr> <tr class="separator:a52cb11a1490a8011e41d02db5c983a8c"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a0efd89d12cbe8befd4931be837c099df"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="struct_decoding_result.html">DecodingResult</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#a0efd89d12cbe8befd4931be837c099df">Recover</a> (byte *recoveredMessage, <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> *messageAccumulator) const</td></tr> <tr class="memdesc:a0efd89d12cbe8befd4931be837c099df"><td class="mdescLeft"> </td><td class="mdescRight">Recover a message from its signature. <a href="#a0efd89d12cbe8befd4931be837c099df">More...</a><br /></td></tr> <tr class="separator:a0efd89d12cbe8befd4931be837c099df"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a6612ff44a274594890419ae75d260cce"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="struct_decoding_result.html">DecodingResult</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#a6612ff44a274594890419ae75d260cce">RecoverAndRestart</a> (byte *recoveredMessage, <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &messageAccumulator) const =0</td></tr> <tr class="memdesc:a6612ff44a274594890419ae75d260cce"><td class="mdescLeft"> </td><td class="mdescRight">Recover a message from its signature. <a href="#a6612ff44a274594890419ae75d260cce">More...</a><br /></td></tr> <tr class="separator:a6612ff44a274594890419ae75d260cce"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a05d969651d86a63d5002057113e0cab7"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="struct_decoding_result.html">DecodingResult</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#a05d969651d86a63d5002057113e0cab7">RecoverMessage</a> (byte *recoveredMessage, const byte *nonrecoverableMessage, size_t nonrecoverableMessageLength, const byte *signature, size_t signatureLength) const</td></tr> <tr class="memdesc:a05d969651d86a63d5002057113e0cab7"><td class="mdescLeft"> </td><td class="mdescRight">Recover a message from its signature. <a href="#a05d969651d86a63d5002057113e0cab7">More...</a><br /></td></tr> <tr class="separator:a05d969651d86a63d5002057113e0cab7"><td class="memSeparator" colspan="2"> </td></tr> <tr class="inherit_header pub_methods_class_p_k___signature_scheme"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_class_p_k___signature_scheme')"><img src="closed.png" alt="-"/> Public Member Functions inherited from <a class="el" href="class_p_k___signature_scheme.html">PK_SignatureScheme</a></td></tr> <tr class="memitem:aab30ad8e2da2d706cf6c69bdac963afc inherit pub_methods_class_p_k___signature_scheme"><td class="memItemLeft" align="right" valign="top">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 class="memdesc:aab30ad8e2da2d706cf6c69bdac963afc inherit pub_methods_class_p_k___signature_scheme"><td class="mdescLeft"> </td><td class="mdescRight">Provides the signature length if it only depends on the key. <a href="class_p_k___signature_scheme.html#aab30ad8e2da2d706cf6c69bdac963afc">More...</a><br /></td></tr> <tr class="separator:aab30ad8e2da2d706cf6c69bdac963afc inherit pub_methods_class_p_k___signature_scheme"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a665909c10f27db81343a01c814488652 inherit pub_methods_class_p_k___signature_scheme"><td class="memItemLeft" align="right" valign="top">virtual size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#a665909c10f27db81343a01c814488652">MaxSignatureLength</a> (size_t recoverablePartLength=0) const</td></tr> <tr class="memdesc:a665909c10f27db81343a01c814488652 inherit pub_methods_class_p_k___signature_scheme"><td class="mdescLeft"> </td><td class="mdescRight">Provides the maximum signature length produced given the length of the recoverable message part. <a href="class_p_k___signature_scheme.html#a665909c10f27db81343a01c814488652">More...</a><br /></td></tr> <tr class="separator:a665909c10f27db81343a01c814488652 inherit pub_methods_class_p_k___signature_scheme"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a1f6a62ce468f172636f117ee0693038f inherit pub_methods_class_p_k___signature_scheme"><td class="memItemLeft" align="right" valign="top">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 class="memdesc:a1f6a62ce468f172636f117ee0693038f inherit pub_methods_class_p_k___signature_scheme"><td class="mdescLeft"> </td><td class="mdescRight">Provides the length of longest message that can be recovered. <a href="class_p_k___signature_scheme.html#a1f6a62ce468f172636f117ee0693038f">More...</a><br /></td></tr> <tr class="separator:a1f6a62ce468f172636f117ee0693038f inherit pub_methods_class_p_k___signature_scheme"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a2f2a599ba385e63766d4a7f7ccf2a884 inherit pub_methods_class_p_k___signature_scheme"><td class="memItemLeft" align="right" valign="top">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 class="memdesc:a2f2a599ba385e63766d4a7f7ccf2a884 inherit pub_methods_class_p_k___signature_scheme"><td class="mdescLeft"> </td><td class="mdescRight">Provides the length of longest message that can be recovered from a signature of given length. <a href="class_p_k___signature_scheme.html#a2f2a599ba385e63766d4a7f7ccf2a884">More...</a><br /></td></tr> <tr class="separator:a2f2a599ba385e63766d4a7f7ccf2a884 inherit pub_methods_class_p_k___signature_scheme"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:adeb758d5f8ae8fad137d11ad1c5c60c0 inherit pub_methods_class_p_k___signature_scheme"><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 class="memdesc:adeb758d5f8ae8fad137d11ad1c5c60c0 inherit pub_methods_class_p_k___signature_scheme"><td class="mdescLeft"> </td><td class="mdescRight">Determines whether a signature scheme requires a random number generator. <a href="class_p_k___signature_scheme.html#adeb758d5f8ae8fad137d11ad1c5c60c0">More...</a><br /></td></tr> <tr class="separator:adeb758d5f8ae8fad137d11ad1c5c60c0 inherit pub_methods_class_p_k___signature_scheme"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a00368da9563ce49efc42b5cd0d9c7738 inherit pub_methods_class_p_k___signature_scheme"><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#a00368da9563ce49efc42b5cd0d9c7738">AllowNonrecoverablePart</a> () const =0</td></tr> <tr class="memdesc:a00368da9563ce49efc42b5cd0d9c7738 inherit pub_methods_class_p_k___signature_scheme"><td class="mdescLeft"> </td><td class="mdescRight">Determines whether the non-recoverable message part can be signed. <a href="class_p_k___signature_scheme.html#a00368da9563ce49efc42b5cd0d9c7738">More...</a><br /></td></tr> <tr class="separator:a00368da9563ce49efc42b5cd0d9c7738 inherit pub_methods_class_p_k___signature_scheme"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a8f62890f0485b9ca58528047871f8894 inherit pub_methods_class_p_k___signature_scheme"><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#a8f62890f0485b9ca58528047871f8894">SignatureUpfront</a> () const</td></tr> <tr class="memdesc:a8f62890f0485b9ca58528047871f8894 inherit pub_methods_class_p_k___signature_scheme"><td class="mdescLeft"> </td><td class="mdescRight">Determines whether the signature must be input before the message. <a href="class_p_k___signature_scheme.html#a8f62890f0485b9ca58528047871f8894">More...</a><br /></td></tr> <tr class="separator:a8f62890f0485b9ca58528047871f8894 inherit pub_methods_class_p_k___signature_scheme"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a168ca843d63ddababdf2cee3eaa02813 inherit pub_methods_class_p_k___signature_scheme"><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#a168ca843d63ddababdf2cee3eaa02813">RecoverablePartFirst</a> () const =0</td></tr> <tr class="memdesc:a168ca843d63ddababdf2cee3eaa02813 inherit pub_methods_class_p_k___signature_scheme"><td class="mdescLeft"> </td><td class="mdescRight">Determines whether the recoverable part must be input before the non-recoverable part. <a href="class_p_k___signature_scheme.html#a168ca843d63ddababdf2cee3eaa02813">More...</a><br /></td></tr> <tr class="separator:a168ca843d63ddababdf2cee3eaa02813 inherit pub_methods_class_p_k___signature_scheme"><td class="memSeparator" colspan="2"> </td></tr> <tr class="inherit_header pub_methods_class_public_key_algorithm"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_class_public_key_algorithm')"><img src="closed.png" alt="-"/> Public Member Functions inherited from <a class="el" href="class_public_key_algorithm.html">PublicKeyAlgorithm</a></td></tr> <tr class="memitem:a74b77db3086e07caf5506fda9ec204e7 inherit pub_methods_class_public_key_algorithm"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_crypto_material.html">CryptoMaterial</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_public_key_algorithm.html#a74b77db3086e07caf5506fda9ec204e7">AccessMaterial</a> ()</td></tr> <tr class="memdesc:a74b77db3086e07caf5506fda9ec204e7 inherit pub_methods_class_public_key_algorithm"><td class="mdescLeft"> </td><td class="mdescRight">Retrieves a reference to a Public Key. <a href="class_public_key_algorithm.html#a74b77db3086e07caf5506fda9ec204e7">More...</a><br /></td></tr> <tr class="separator:a74b77db3086e07caf5506fda9ec204e7 inherit pub_methods_class_public_key_algorithm"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a8c2bb02751348ff151ad9d4756cafd74 inherit pub_methods_class_public_key_algorithm"><td class="memItemLeft" align="right" valign="top">const <a class="el" href="class_crypto_material.html">CryptoMaterial</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_public_key_algorithm.html#a8c2bb02751348ff151ad9d4756cafd74">GetMaterial</a> () const</td></tr> <tr class="memdesc:a8c2bb02751348ff151ad9d4756cafd74 inherit pub_methods_class_public_key_algorithm"><td class="mdescLeft"> </td><td class="mdescRight">Retrieves a reference to a Public Key. <a href="class_public_key_algorithm.html#a8c2bb02751348ff151ad9d4756cafd74">More...</a><br /></td></tr> <tr class="separator:a8c2bb02751348ff151ad9d4756cafd74 inherit pub_methods_class_public_key_algorithm"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a47cd0fed475280962ab6337c6c57c882 inherit pub_methods_class_public_key_algorithm"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="class_public_key.html">PublicKey</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_public_key_algorithm.html#a47cd0fed475280962ab6337c6c57c882">AccessPublicKey</a> ()=0</td></tr> <tr class="memdesc:a47cd0fed475280962ab6337c6c57c882 inherit pub_methods_class_public_key_algorithm"><td class="mdescLeft"> </td><td class="mdescRight">Retrieves a reference to a Public Key. <a href="class_public_key_algorithm.html#a47cd0fed475280962ab6337c6c57c882">More...</a><br /></td></tr> <tr class="separator:a47cd0fed475280962ab6337c6c57c882 inherit pub_methods_class_public_key_algorithm"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a49b6c27bffc8cc588e0db37071fde9f5 inherit pub_methods_class_public_key_algorithm"><td class="memItemLeft" align="right" valign="top">virtual const <a class="el" href="class_public_key.html">PublicKey</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_public_key_algorithm.html#a49b6c27bffc8cc588e0db37071fde9f5">GetPublicKey</a> () const</td></tr> <tr class="memdesc:a49b6c27bffc8cc588e0db37071fde9f5 inherit pub_methods_class_public_key_algorithm"><td class="mdescLeft"> </td><td class="mdescRight">Retrieves a reference to a Public Key. <a href="class_public_key_algorithm.html#a49b6c27bffc8cc588e0db37071fde9f5">More...</a><br /></td></tr> <tr class="separator:a49b6c27bffc8cc588e0db37071fde9f5 inherit pub_methods_class_public_key_algorithm"><td class="memSeparator" colspan="2"> </td></tr> <tr class="inherit_header pub_methods_class_algorithm"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_class_algorithm')"><img src="closed.png" alt="-"/> Public Member Functions inherited from <a class="el" href="class_algorithm.html">Algorithm</a></td></tr> <tr class="memitem:a1c77f5117ca2cd881baf26a364cfc606 inherit pub_methods_class_algorithm"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_algorithm.html#a1c77f5117ca2cd881baf26a364cfc606">Algorithm</a> (bool checkSelfTestStatus=true)</td></tr> <tr class="memdesc:a1c77f5117ca2cd881baf26a364cfc606 inherit pub_methods_class_algorithm"><td class="mdescLeft"> </td><td class="mdescRight">Interface for all crypto algorithms. <a href="class_algorithm.html#a1c77f5117ca2cd881baf26a364cfc606">More...</a><br /></td></tr> <tr class="separator:a1c77f5117ca2cd881baf26a364cfc606 inherit pub_methods_class_algorithm"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a4f31510a192d1121856efe8ad0a9b844 inherit pub_methods_class_algorithm"><td class="memItemLeft" align="right" valign="top">virtual std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="class_algorithm.html#a4f31510a192d1121856efe8ad0a9b844">AlgorithmName</a> () const</td></tr> <tr class="memdesc:a4f31510a192d1121856efe8ad0a9b844 inherit pub_methods_class_algorithm"><td class="mdescLeft"> </td><td class="mdescRight">Provides the name of this algorithm. <a href="class_algorithm.html#a4f31510a192d1121856efe8ad0a9b844">More...</a><br /></td></tr> <tr class="separator:a4f31510a192d1121856efe8ad0a9b844 inherit pub_methods_class_algorithm"><td class="memSeparator" colspan="2"> </td></tr> <tr class="inherit_header pub_methods_class_clonable"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_class_clonable')"><img src="closed.png" alt="-"/> Public Member Functions inherited from <a class="el" href="class_clonable.html">Clonable</a></td></tr> <tr class="memitem:ad0016ba2d505c23aa85aad49e6c19bb7 inherit pub_methods_class_clonable"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="class_clonable.html">Clonable</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="class_clonable.html#ad0016ba2d505c23aa85aad49e6c19bb7">Clone</a> () const</td></tr> <tr class="memdesc:ad0016ba2d505c23aa85aad49e6c19bb7 inherit pub_methods_class_clonable"><td class="mdescLeft"> </td><td class="mdescRight">Copies this object. <a href="class_clonable.html#ad0016ba2d505c23aa85aad49e6c19bb7">More...</a><br /></td></tr> <tr class="separator:ad0016ba2d505c23aa85aad49e6c19bb7 inherit pub_methods_class_clonable"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <div class="textblock"><p>Interface for public-key signature verifiers. </p> <p>The Recover* functions throw <a class="el" href="class_not_implemented.html" title="A method was called which was not implemented. ">NotImplemented</a> if the signature scheme does not support message recovery.</p> <p>The Verify* functions throw <a class="el" href="class_invalid_data_format.html" title="Input data was received that did not conform to expected format. ">InvalidDataFormat</a> if the scheme does support message recovery and the signature contains a non-empty recoverable message part. The Recover* functions should be used in that case. </p> <p class="definition">Definition at line <a class="el" href="cryptlib_8h_source.html#l02769">2769</a> of file <a class="el" href="cryptlib_8h_source.html">cryptlib.h</a>.</p> </div><h2 class="groupheader">Member Function Documentation</h2> <a id="acd874268dab653dde01409fc9dfd2069"></a> <h2 class="memtitle"><span class="permalink"><a href="#acd874268dab653dde01409fc9dfd2069">◆ </a></span>NewVerificationAccumulator()</h2> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a>* PK_Verifier::NewVerificationAccumulator </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>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 verified. </p> <dl class="section return"><dt>Returns</dt><dd>a pointer to a <a class="el" href="class_p_k___message_accumulator.html" title="Interface for accumulating messages to be signed or verified. ">PK_MessageAccumulator</a></dd></dl> <p><a class="el" href="class_p_k___verifier.html#acd874268dab653dde01409fc9dfd2069" title="Create a new HashTransformation to accumulate the message to be verified. ">NewVerificationAccumulator()</a> can be used with all verification methods. <a class="el" href="class_p_k___verifier.html#a447ba2b73d8fa9e37b1995f3710032b8" title="Check whether messageAccumulator contains a valid signature and message. ">Verify()</a> will autimatically delete the accumulator pointer. The caller is responsible for deletion if a method is called that takes a reference. </p> <p>Implemented in <a class="el" href="class_d_l___verifier_impl.html#a992ada613b42788059a9e38757f7e5e3">DL_VerifierImpl< SCHEME_OPTIONS ></a>.</p> </div> </div> <a id="a515aa448e7fc3a5c6e422e65500ab507"></a> <h2 class="memtitle"><span class="permalink"><a href="#a515aa448e7fc3a5c6e422e65500ab507">◆ </a></span>InputSignature()</h2> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual void PK_Verifier::InputSignature </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">const byte * </td> <td class="paramname"><em>signature</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>signatureLength</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Input signature into a message accumulator. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">messageAccumulator</td><td>a pointer to a <a class="el" href="class_p_k___message_accumulator.html" title="Interface for accumulating messages to be signed or verified. ">PK_MessageAccumulator</a> derived class </td></tr> <tr><td class="paramname">signature</td><td>the signature on the message </td></tr> <tr><td class="paramname">signatureLength</td><td>the size of the signature </td></tr> </table> </dd> </dl> <p>Implemented in <a class="el" href="class_d_l___verifier_base.html#a2c79cf3c476d9c5ab0ba3ccd78661e30">DL_VerifierBase< T ></a>, <a class="el" href="class_d_l___verifier_base.html#a2c79cf3c476d9c5ab0ba3ccd78661e30">DL_VerifierBase< SCHEME_OPTIONS::Element ></a>, and <a class="el" href="class_t_f___verifier_base.html#a3aef5cd6fad386f2e37ea7f5f96760fc">TF_VerifierBase</a>.</p> </div> </div> <a id="a447ba2b73d8fa9e37b1995f3710032b8"></a> <h2 class="memtitle"><span class="permalink"><a href="#a447ba2b73d8fa9e37b1995f3710032b8">◆ </a></span>Verify()</h2> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">bool PK_Verifier::Verify </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><td>)</td> <td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">virtual</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Check whether messageAccumulator contains a valid signature and message. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">messageAccumulator</td><td>a pointer to a <a class="el" href="class_p_k___message_accumulator.html" title="Interface for accumulating messages to be signed or verified. ">PK_MessageAccumulator</a> derived class </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>true if the signature is valid, false otherwise</dd></dl> <p><a class="el" href="class_p_k___verifier.html#a447ba2b73d8fa9e37b1995f3710032b8" title="Check whether messageAccumulator contains a valid signature and message. ">Verify()</a> deletes the messageAccumulator, even if an exception is thrown. </p> <p class="definition">Definition at line <a class="el" href="cryptlib_8cpp_source.html#l00937">937</a> of file <a class="el" href="cryptlib_8cpp_source.html">cryptlib.cpp</a>.</p> </div> </div> <a id="a36e176dc8a0d3f924938cb2b07021f28"></a> <h2 class="memtitle"><span class="permalink"><a href="#a36e176dc8a0d3f924938cb2b07021f28">◆ </a></span>VerifyAndRestart()</h2> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual bool PK_Verifier::VerifyAndRestart </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><td>)</td> <td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Check whether messageAccumulator contains a valid signature and message, and restart messageAccumulator. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">messageAccumulator</td><td>a reference to a <a class="el" href="class_p_k___message_accumulator.html" title="Interface for accumulating messages to be signed or verified. ">PK_MessageAccumulator</a> derived class </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>true if the signature is valid, false otherwise</dd></dl> <p><a class="el" href="class_p_k___verifier.html#a36e176dc8a0d3f924938cb2b07021f28" title="Check whether messageAccumulator contains a valid signature and message, and restart messageAccumulat...">VerifyAndRestart()</a> restarts the messageAccumulator </p> <p>Implemented in <a class="el" href="class_d_l___verifier_base.html#a9aba1bfd8698167cfc2532acd82f4d4d">DL_VerifierBase< T ></a>, <a class="el" href="class_d_l___verifier_base.html#a9aba1bfd8698167cfc2532acd82f4d4d">DL_VerifierBase< SCHEME_OPTIONS::Element ></a>, and <a class="el" href="class_t_f___verifier_base.html#a4b2939810bf9ddc7bf77562c3a1fd27c">TF_VerifierBase</a>.</p> </div> </div> <a id="a52cb11a1490a8011e41d02db5c983a8c"></a> <h2 class="memtitle"><span class="permalink"><a href="#a52cb11a1490a8011e41d02db5c983a8c">◆ </a></span>VerifyMessage()</h2> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">bool PK_Verifier::VerifyMessage </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">const byte * </td> <td class="paramname"><em>signature</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>signatureLen</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">virtual</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Check whether input signature is a valid signature for input message. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">message</td><td>a pointer to the message to be verified </td></tr> <tr><td class="paramname">messageLen</td><td>the size of the message </td></tr> <tr><td class="paramname">signature</td><td>a pointer to the signature over the message </td></tr> <tr><td class="paramname">signatureLen</td><td>the size of the signature </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>true if the signature is valid, false otherwise </dd></dl> <p class="definition">Definition at line <a class="el" href="cryptlib_8cpp_source.html#l00943">943</a> of file <a class="el" href="cryptlib_8cpp_source.html">cryptlib.cpp</a>.</p> </div> </div> <a id="a0efd89d12cbe8befd4931be837c099df"></a> <h2 class="memtitle"><span class="permalink"><a href="#a0efd89d12cbe8befd4931be837c099df">◆ </a></span>Recover()</h2> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname"><a class="el" href="struct_decoding_result.html">DecodingResult</a> PK_Verifier::Recover </td> <td>(</td> <td class="paramtype">byte * </td> <td class="paramname"><em>recoveredMessage</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></td> <td>)</td> <td></td><td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">virtual</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Recover a message from its signature. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">recoveredMessage</td><td>a pointer to the recoverable message part to be verified </td></tr> <tr><td class="paramname">messageAccumulator</td><td>a pointer to a <a class="el" href="class_p_k___message_accumulator.html" title="Interface for accumulating messages to be signed or verified. ">PK_MessageAccumulator</a> derived class </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the result of the verification operation</dd></dl> <p><a class="el" href="class_p_k___verifier.html#a0efd89d12cbe8befd4931be837c099df" title="Recover a message from its signature. ">Recover()</a> deletes the messageAccumulator, even if an exception is thrown. </p><dl class="section pre"><dt>Precondition</dt><dd><code><a class="el" href="misc_8h.html#a2d7e4464ea73d6393ebe78f952253426" title="Counts elements in an array. ">COUNTOF(recoveredMessage)</a> == MaxRecoverableLengthFromSignatureLength(signatureLength)</code> </dd></dl> <p class="definition">Definition at line <a class="el" href="cryptlib_8cpp_source.html#l00951">951</a> of file <a class="el" href="cryptlib_8cpp_source.html">cryptlib.cpp</a>.</p> </div> </div> <a id="a6612ff44a274594890419ae75d260cce"></a> <h2 class="memtitle"><span class="permalink"><a href="#a6612ff44a274594890419ae75d260cce">◆ </a></span>RecoverAndRestart()</h2> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual <a class="el" href="struct_decoding_result.html">DecodingResult</a> PK_Verifier::RecoverAndRestart </td> <td>(</td> <td class="paramtype">byte * </td> <td class="paramname"><em>recoveredMessage</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></td> <td>)</td> <td></td><td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Recover a message from its signature. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">recoveredMessage</td><td>a pointer to the recoverable message part to be verified </td></tr> <tr><td class="paramname">messageAccumulator</td><td>a pointer to a <a class="el" href="class_p_k___message_accumulator.html" title="Interface for accumulating messages to be signed or verified. ">PK_MessageAccumulator</a> derived class </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the result of the verification operation</dd></dl> <p><a class="el" href="class_p_k___verifier.html#a6612ff44a274594890419ae75d260cce" title="Recover a message from its signature. ">RecoverAndRestart()</a> restarts the messageAccumulator </p><dl class="section pre"><dt>Precondition</dt><dd><code><a class="el" href="misc_8h.html#a2d7e4464ea73d6393ebe78f952253426" title="Counts elements in an array. ">COUNTOF(recoveredMessage)</a> == MaxRecoverableLengthFromSignatureLength(signatureLength)</code> </dd></dl> <p>Implemented in <a class="el" href="class_d_l___verifier_base.html#a09864bb54172b0f48bcab6e5860277fb">DL_VerifierBase< T ></a>, <a class="el" href="class_d_l___verifier_base.html#a09864bb54172b0f48bcab6e5860277fb">DL_VerifierBase< SCHEME_OPTIONS::Element ></a>, and <a class="el" href="class_t_f___verifier_base.html#afff8535e4229e7e27e0824ce68e7e723">TF_VerifierBase</a>.</p> </div> </div> <a id="a05d969651d86a63d5002057113e0cab7"></a> <h2 class="memtitle"><span class="permalink"><a href="#a05d969651d86a63d5002057113e0cab7">◆ </a></span>RecoverMessage()</h2> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname"><a class="el" href="struct_decoding_result.html">DecodingResult</a> PK_Verifier::RecoverMessage </td> <td>(</td> <td class="paramtype">byte * </td> <td class="paramname"><em>recoveredMessage</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">const byte * </td> <td class="paramname"><em>signature</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>signatureLength</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">virtual</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Recover a message from its signature. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">recoveredMessage</td><td>a pointer for the recovered message </td></tr> <tr><td class="paramname">nonrecoverableMessage</td><td>a pointer to the non-recoverable message part to be signed </td></tr> <tr><td class="paramname">nonrecoverableMessageLength</td><td>the size of the non-recoverable message part </td></tr> <tr><td class="paramname">signature</td><td>the signature on the message </td></tr> <tr><td class="paramname">signatureLength</td><td>the size of the signature </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the result of the verification operation </dd></dl> <dl class="section pre"><dt>Precondition</dt><dd><code><a class="el" href="misc_8h.html#a2d7e4464ea73d6393ebe78f952253426" title="Counts elements in an array. ">COUNTOF(recoveredMessage)</a> == MaxRecoverableLengthFromSignatureLength(signatureLength)</code> </dd></dl> <p class="definition">Definition at line <a class="el" href="cryptlib_8cpp_source.html#l00957">957</a> of file <a class="el" href="cryptlib_8cpp_source.html">cryptlib.cpp</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><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated on Sun Sep 16 2018 07:58:49 for Crypto++ by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.14 </small></address> </body> </html>