Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | File List | Namespace Members | Class Members | File Members

PK_Signer Class Reference

#include <cryptlib.h>

Inheritance diagram for PK_Signer:

PK_SignatureScheme PrivateKeyAlgorithm AsymmetricAlgorithm Algorithm Clonable DL_SignatureSchemeBase< PK_Signer, DL_PrivateKey< T > > TF_SignatureSchemeBase< PK_Signer, TF_Base< RandomizedTrapdoorFunctionInverse, PK_SignatureMessageEncodingMethod > > DL_SignerBase< T > TF_SignerBase List of all members.

Detailed Description

interface for public-key signers

Definition at line 1254 of file cryptlib.h.

Public Member Functions

virtual PK_MessageAccumulatorNewSignatureAccumulator (RandomNumberGenerator &rng=NullRNG()) const =0
 create a new HashTransformation to accumulate the message to be signed

virtual void InputRecoverableMessage (PK_MessageAccumulator &messageAccumulator, const byte *recoverableMessage, unsigned int recoverableMessageLength) const =0
virtual unsigned int Sign (RandomNumberGenerator &rng, PK_MessageAccumulator *messageAccumulator, byte *signature) const
 sign and delete messageAccumulator (even in case of exception thrown)

virtual unsigned int SignAndRestart (RandomNumberGenerator &rng, PK_MessageAccumulator &messageAccumulator, byte *signature, bool restart=true) const =0
 sign and restart messageAccumulator

virtual unsigned int SignMessage (RandomNumberGenerator &rng, const byte *message, unsigned int messageLen, byte *signature) const
 sign a message

virtual unsigned int SignMessageWithRecovery (RandomNumberGenerator &rng, const byte *recoverableMessage, unsigned int recoverableMessageLength, const byte *nonrecoverableMessage, unsigned int nonrecoverableMessageLength, byte *signature) const
 sign a recoverable message

virtual unsigned int SignatureLength () const =0
 signature length if it only depends on the key, otherwise 0

virtual unsigned int MaxSignatureLength (unsigned int recoverablePartLength=0) const
 maximum signature length produced for a given length of recoverable message part

virtual unsigned int MaxRecoverableLength () const =0
 length of longest message that can be recovered, or 0 if this signature scheme does not support message recovery

virtual unsigned int MaxRecoverableLengthFromSignatureLength (unsigned int signatureLength) const =0
 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

virtual bool IsProbabilistic () const =0
 requires a random number generator to sign

virtual bool AllowNonrecoverablePart () const =0
 whether or not a non-recoverable message part can be signed

virtual bool SignatureUpfront () const
 if this function returns true, during verification you must input the signature before the message, otherwise you can input it at anytime */

virtual bool RecoverablePartFirst () const =0
 whether you must input the recoverable part before the non-recoverable part during signing

CryptoMaterialAccessMaterial ()
 returns a reference to the crypto material used by this object

const CryptoMaterialGetMaterial () const
 returns a const reference to the crypto material used by this object

virtual PrivateKeyAccessPrivateKey ()=0
virtual const PrivateKeyGetPrivateKey () const
void BERDecode (BufferedTransformation &bt)
 for backwards compatibility, calls AccessMaterial().Load(bt)

void DEREncode (BufferedTransformation &bt) const
 for backwards compatibility, calls GetMaterial().Save(bt)

virtual std::string AlgorithmName () const
 returns name of this algorithm, not universally implemented yet

virtual ClonableClone () const
 this is not implemented by most classes yet


Member Function Documentation

unsigned int PK_Signer::Sign RandomNumberGenerator rng,
PK_MessageAccumulator messageAccumulator,
byte *  signature
const [virtual]
 

sign and delete messageAccumulator (even in case of exception thrown)

Precondition:
size of signature == MaxSignatureLength()
Returns:
actual signature length

Definition at line 617 of file cryptlib.cpp.

References Sign(), and SignAndRestart().

Referenced by Sign().

virtual unsigned int PK_Signer::SignAndRestart RandomNumberGenerator rng,
PK_MessageAccumulator messageAccumulator,
byte *  signature,
bool  restart = true
const [pure virtual]
 

sign and restart messageAccumulator

Precondition:
size of signature == MaxSignatureLength()
Returns:
actual signature length

Implemented in TF_SignerBase, and DL_SignerBase< T >.

Referenced by Sign(), SignMessage(), and SignMessageWithRecovery().

unsigned int PK_Signer::SignMessage RandomNumberGenerator rng,
const byte *  message,
unsigned int  messageLen,
byte *  signature
const [virtual]
 

sign a message

Precondition:
size of signature == MaxSignatureLength()
Returns:
actual signature length

Definition at line 623 of file cryptlib.cpp.

References NewSignatureAccumulator(), SignAndRestart(), and SignMessage().

Referenced by SignMessage().

unsigned int PK_Signer::SignMessageWithRecovery RandomNumberGenerator rng,
const byte *  recoverableMessage,
unsigned int  recoverableMessageLength,
const byte *  nonrecoverableMessage,
unsigned int  nonrecoverableMessageLength,
byte *  signature
const [virtual]
 

sign a recoverable message

Precondition:
size of signature == MaxSignatureLength(recoverableMessageLength)
Returns:
actual signature length

Definition at line 630 of file cryptlib.cpp.

References NewSignatureAccumulator(), SignAndRestart(), and SignMessageWithRecovery().

Referenced by SignMessageWithRecovery().

virtual bool PK_SignatureScheme::IsProbabilistic  )  const [pure virtual, inherited]
 

requires a random number generator to sign

if this returns false, NullRNG() can be passed to functions that take RandomNumberGenerator &


The documentation for this class was generated from the following files:
Generated on Wed Jul 28 08:07:15 2004 for Crypto++ by doxygen 1.3.7