Integer-based GroupParameters default implementation. More...

#include <gfpcrypt.h>

Inheritance diagram for DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >:

Collaboration diagram for DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >:

Public Types
typedef GROUP_PRECOMP::Element	Element

Public Types inherited from DL_GroupParametersImpl< GROUP_PRECOMP, BASE_PRECOMP, DL_GroupParameters_IntegerBased >
typedef GROUP_PRECOMP	GroupPrecomputation

typedef GROUP_PRECOMP::Element	Element

typedef BASE_PRECOMP	BasePrecomputation

Public Types inherited from DL_GroupParameters< Integer >
typedef Integer	Element

Public Member Functions
virtual	~DL_GroupParameters_IntegerBasedImpl ()

bool	GetVoidValue (const char name, const std::type_info &valueType, void pValue) const
	Get a named value. More...

void	AssignFrom (const NameValuePairs &source)
	Assign values to this object. More...

const DL_FixedBasePrecomputation< Element > &	GetBasePrecomputation () const
	Retrieves the group precomputation. More...

DL_FixedBasePrecomputation< Element > &	AccessBasePrecomputation ()
	Retrieves the group precomputation. More...

const Integer &	GetModulus () const

const Integer &	GetGenerator () const

void	SetModulusAndSubgroupGenerator (const Integer &p, const Integer &g)

bool	operator== (const DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP > &rhs) const

bool	operator!= (const DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP > &rhs) const

Public Member Functions inherited from DL_GroupParametersImpl< GROUP_PRECOMP, BASE_PRECOMP, DL_GroupParameters_IntegerBased >
virtual	~DL_GroupParametersImpl ()

const DL_GroupPrecomputation< Element > &	GetGroupPrecomputation () const
	Retrieves the group precomputation. More...

const DL_FixedBasePrecomputation< Element > &	GetBasePrecomputation () const
	Retrieves the group precomputation. More...

DL_FixedBasePrecomputation< Element > &	AccessBasePrecomputation ()
	Retrieves the group precomputation. More...

Public Member Functions inherited from DL_GroupParameters_IntegerBased
virtual	~DL_GroupParameters_IntegerBased ()

void	Initialize (const DL_GroupParameters_IntegerBased &params)
	Initialize a group parameters over integers. More...

void	Initialize (RandomNumberGenerator &rng, unsigned int pbits)
	Create a group parameters over integers. More...

void	Initialize (const Integer &p, const Integer &g)
	Initialize a group parameters over integers. More...

void	Initialize (const Integer &p, const Integer &q, const Integer &g)
	Initialize a group parameters over integers. More...

void	BERDecode (BufferedTransformation &bt)
	Decode this object from a BufferedTransformation. More...

void	DEREncode (BufferedTransformation &bt) const
	Encode this object into a BufferedTransformation. More...

void	GenerateRandom (RandomNumberGenerator &rng, const NameValuePairs &alg)

const Integer &	GetSubgroupOrder () const
	Retrieves the subgroup order. More...

Integer	GetGroupOrder () const
	Retrieves the order of the group. More...

bool	ValidateGroup (RandomNumberGenerator &rng, unsigned int level) const
	Check the group for errors. More...

bool	ValidateElement (unsigned int level, const Integer &element, const DL_FixedBasePrecomputation< Integer > *precomp) const
	Check the element for errors. More...

bool	FastSubgroupCheckAvailable () const

void	EncodeElement (bool reversible, const Element &element, byte *encoded) const
	Encodes the element. More...

unsigned int	GetEncodedElementSize (bool reversible) const
	Retrieves the encoded element's size. More...

Integer	DecodeElement (const byte *encoded, bool checkForGroupMembership) const
	Decodes the element. More...

Integer	ConvertElementToInteger (const Element &element) const
	Converts an element to an Integer. More...

Integer	GetMaxExponent () const
	Retrieves the maximum exponent for the group. More...

OID	GetAlgorithmID () const

void	SetSubgroupOrder (const Integer &q)

Public Member Functions inherited from ASN1CryptoMaterial< DL_GroupParameters< Integer > >
void	Save (BufferedTransformation &bt) const
	DER encode ASN.1 object. More...

void	Load (BufferedTransformation &bt)
	BER decode ASN.1 object. More...

Public Member Functions inherited from ASN1Object
virtual	~ASN1Object ()

virtual void	BEREncode (BufferedTransformation &bt) const
	Encode this object into a BufferedTransformation. More...

Public Member Functions inherited from DL_GroupParameters< Integer >
virtual	~DL_GroupParameters ()

	DL_GroupParameters ()

bool	Validate (RandomNumberGenerator &rng, unsigned int level) const
	Check this object for errors. More...

bool	GetVoidValue (const char name, const std::type_info &valueType, void pValue) const
	Get a named value. More...

bool	SupportsPrecomputation () const
	Determines whether the object supports precomputation. More...

void	Precompute (unsigned int precomputationStorage=16)
	Perform precomputation. More...

void	LoadPrecomputation (BufferedTransformation &storedPrecomputation)
	Retrieve previously saved precomputation. More...

void	SavePrecomputation (BufferedTransformation &storedPrecomputation) const
	Save precomputation for later use. More...

virtual const Element &	GetSubgroupGenerator () const
	Retrieves the subgroup generator. More...

virtual void	SetSubgroupGenerator (const Element &base)
	Set the subgroup generator. More...

virtual Element	ExponentiateBase (const Integer &exponent) const
	Retrieves the subgroup generator. More...

virtual Element	ExponentiateElement (const Element &base, const Integer &exponent) const
	Exponentiates an element. More...

virtual Integer	GetCofactor () const
	Retrieves the cofactor. More...

virtual bool	IsIdentity (const Element &element) const =0
	Determines if an element is an identity. More...

virtual void	SimultaneousExponentiate (Element results, const Element &base, const Integer exponents, unsigned int exponentsCount) const =0
	Exponentiates a base to multiple exponents. More...

Public Member Functions inherited from GeneratableCryptoMaterial
virtual	~GeneratableCryptoMaterial ()

void	GenerateRandomWithKeySize (RandomNumberGenerator &rng, unsigned int keySize)
	Generate a random key or crypto parameters. More...

Public Member Functions inherited from CryptoMaterial
virtual	~CryptoMaterial ()

virtual void	ThrowIfInvalid (RandomNumberGenerator &rng, unsigned int level) const
	Check this object for errors. More...

void	DoQuickSanityCheck () const
	Perform a quick sanity check. More...

Public Member Functions inherited from NameValuePairs
virtual	~NameValuePairs ()

template<class T >
bool	GetThisObject (T &object) const
	Get a copy of this object or subobject. More...

template<class T >
bool	GetThisPointer (T *&ptr) const
	Get a pointer to this object. More...

template<class T >
bool	GetValue (const char *name, T &value) const
	Get a named value. More...

template<class T >
T	GetValueWithDefault (const char *name, T defaultValue) const
	Get a named value. More...

CRYPTOPP_DLL std::string	GetValueNames () const
	Get a list of value names that can be retrieved. More...

CRYPTOPP_DLL bool	GetIntValue (const char *name, int &value) const
	Get a named value with type int. More...

CRYPTOPP_DLL int	GetIntValueWithDefault (const char *name, int defaultValue) const
	Get a named value with type int, with default. More...

template<class T >
void	GetRequiredParameter (const char className, const char name, T &value) const
	Retrieves a required name/value pair. More...

CRYPTOPP_DLL void	GetRequiredIntParameter (const char className, const char name, int &value) const
	Retrieves a required name/value pair. More...

Private Types
typedef DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >	ThisClass

Additional Inherited Members
Static Public Member Functions inherited from DL_GroupParameters_IntegerBased
static std::string CRYPTOPP_API	StaticAlgorithmNamePrefix ()

Static Public Member Functions inherited from NameValuePairs
static CRYPTOPP_DLL void CRYPTOPP_API	ThrowIfTypeMismatch (const char *name, const std::type_info &stored, const std::type_info &retrieving)
	Ensures an expected name and type is present. More...

Protected Member Functions inherited from DL_GroupParameters_IntegerBased
Integer	ComputeGroupOrder (const Integer &modulus) const

virtual int	GetFieldType () const =0

virtual unsigned int	GetDefaultSubgroupOrderSize (unsigned int modulusSize) const

Protected Member Functions inherited from DL_GroupParameters< Integer >
void	ParametersChanged ()

Protected Attributes inherited from DL_GroupParametersImpl< GROUP_PRECOMP, BASE_PRECOMP, DL_GroupParameters_IntegerBased >
GROUP_PRECOMP	m_groupPrecomputation

BASE_PRECOMP	m_gpc

Detailed Description

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>
class DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >

Integer-based GroupParameters default implementation.

Template Parameters

GROUP_PRECOMP	group parameters precomputation specialization
BASE_PRECOMP	base class precomputation specialization

Definition at line 120 of file gfpcrypt.h.

Member Typedef Documentation

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>

typedef GROUP_PRECOMP::Element DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >::Element

Definition at line 125 of file gfpcrypt.h.

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>

typedef DL_GroupParameters_IntegerBasedImpl<GROUP_PRECOMP, BASE_PRECOMP> DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >::ThisClass

private

Definition at line 122 of file gfpcrypt.h.

Constructor & Destructor Documentation

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>

virtual DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >::~DL_GroupParameters_IntegerBasedImpl ( )

inlinevirtual

Definition at line 127 of file gfpcrypt.h.

Member Function Documentation

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>

DL_FixedBasePrecomputation<Element>& DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >::AccessBasePrecomputation ( )

inlinevirtual

Retrieves the group precomputation.

Returns: a non-const reference to the group precomputation using a fixed base

Implements DL_GroupParameters< Integer >.

Definition at line 138 of file gfpcrypt.h.

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>

void DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >::AssignFrom ( const NameValuePairs & source )

inlinevirtual

Assign values to this object.

This function can be used to create a public key from a private key.

Reimplemented from DL_GroupParameters_IntegerBased.

Definition at line 133 of file gfpcrypt.h.

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>

const DL_FixedBasePrecomputation<Element>& DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >::GetBasePrecomputation ( ) const

inlinevirtual

Retrieves the group precomputation.

Returns: a const reference to the group precomputation using a fixed base

Implements DL_GroupParameters< Integer >.

Definition at line 137 of file gfpcrypt.h.

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>

const Integer& DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >::GetGenerator ( ) const

inline

Definition at line 142 of file gfpcrypt.h.

Here is the caller graph for this function:

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>

const Integer& DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >::GetModulus ( ) const

inlinevirtual

Implements DL_GroupParameters_IntegerBased.

Definition at line 141 of file gfpcrypt.h.

Here is the caller graph for this function:

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>

bool DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >::GetVoidValue	(	const char *	name,
		const std::type_info &	valueType,
		void *	pValue
	)		const

inlinevirtual

Get a named value.

Parameters

name	the name of the object or value to retrieve
valueType	reference to a variable that receives the value
pValue	void pointer to a variable that receives the value

Returns: true if the value was retrieved, false otherwise

GetVoidValue() retrieves the value of name if it exists.

Note: GetVoidValue() is an internal function and should be implemented by derived classes. Users should use one of the other functions instead.

See also: GetValue(), GetValueWithDefault(), GetIntValue(), GetIntValueWithDefault(), GetRequiredParameter() and GetRequiredIntParameter()

Reimplemented from DL_GroupParameters_IntegerBased.

Definition at line 130 of file gfpcrypt.h.

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>

bool DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >::operator!= ( const DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP > & rhs ) const

inline

Definition at line 150 of file gfpcrypt.h.

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>

bool DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >::operator== ( const DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP > & rhs ) const

inline

Definition at line 148 of file gfpcrypt.h.

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>

void DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >::SetModulusAndSubgroupGenerator	(	const Integer &	p,
		const Integer &	g
	)

inlinevirtual

Implements DL_GroupParameters_IntegerBased.

Definition at line 144 of file gfpcrypt.h.

The documentation for this class was generated from the following file:

src/cryptopp/gfpcrypt.h

Public Types

Public Member Functions

Private Types

Additional Inherited Members

Detailed Description

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>> class DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

template<class GROUP_PRECOMP, class BASE_PRECOMP = DL_FixedBasePrecomputationImpl<typename GROUP_PRECOMP::Element>>
class DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >