Crypto++
8.6
Free C++ class library of cryptographic schemes
|
Interface for Discrete Log (DL) group parameters. More...
Public Types | |
typedef T | Element |
Public Member Functions | |
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) |
Sets the subgroup generator. More... | |
virtual Element | ExponentiateBase (const Integer &exponent) const |
Exponentiates the base. More... | |
virtual Element | ExponentiateElement (const Element &base, const Integer &exponent) const |
Exponentiates an element. More... | |
virtual const DL_GroupPrecomputation< Element > & | GetGroupPrecomputation () const =0 |
Retrieves the group precomputation. More... | |
virtual const DL_FixedBasePrecomputation< Element > & | GetBasePrecomputation () const =0 |
Retrieves the group precomputation. More... | |
virtual DL_FixedBasePrecomputation< Element > & | AccessBasePrecomputation ()=0 |
Retrieves the group precomputation. More... | |
virtual const Integer & | GetSubgroupOrder () const =0 |
Retrieves the subgroup order. More... | |
virtual Integer | GetMaxExponent () const =0 |
Retrieves the maximum exponent for the group. More... | |
virtual Integer | GetGroupOrder () const |
Retrieves the order of the group. More... | |
virtual Integer | GetCofactor () const |
Retrieves the cofactor. More... | |
virtual unsigned int | GetEncodedElementSize (bool reversible) const =0 |
Retrieves the encoded element's size. More... | |
virtual void | EncodeElement (bool reversible, const Element &element, byte *encoded) const =0 |
Encodes the element. More... | |
virtual Element | DecodeElement (const byte *encoded, bool checkForGroupMembership) const =0 |
Decodes the element. More... | |
virtual Integer | ConvertElementToInteger (const Element &element) const =0 |
Converts an element to an Integer. More... | |
virtual bool | ValidateGroup (RandomNumberGenerator &rng, unsigned int level) const =0 |
Check the group for errors. More... | |
virtual bool | ValidateElement (unsigned int level, const Element &element, const DL_FixedBasePrecomputation< Element > *precomp) const =0 |
Check the element for errors. More... | |
virtual bool | FastSubgroupCheckAvailable () const =0 |
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... | |
![]() | |
virtual void | GenerateRandom (RandomNumberGenerator &rng, const NameValuePairs ¶ms=g_nullNameValuePairs) |
Generate a random key or crypto parameters. More... | |
void | GenerateRandomWithKeySize (RandomNumberGenerator &rng, unsigned int keySize) |
Generate a random key or crypto parameters. More... | |
![]() | |
virtual void | AssignFrom (const NameValuePairs &source)=0 |
Assign values to this object. More... | |
virtual void | ThrowIfInvalid (RandomNumberGenerator &rng, unsigned int level) const |
Check this object for errors. More... | |
virtual void | Save (BufferedTransformation &bt) const |
Saves a key to a BufferedTransformation. More... | |
virtual void | Load (BufferedTransformation &bt) |
Loads a key from a BufferedTransformation. More... | |
void | DoQuickSanityCheck () const |
Perform a quick sanity check. More... | |
![]() | |
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... | |
CRYPTOPP_DLL bool | GetWord64Value (const char *name, word64 &value) const |
Get a named value with type word64. More... | |
CRYPTOPP_DLL word64 | GetWord64ValueWithDefault (const char *name, word64 defaultValue) const |
Get a named value with type word64, 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... | |
Additional Inherited Members | |
![]() | |
static CRYPTOPP_DLL void | ThrowIfTypeMismatch (const char *name, const std::type_info &stored, const std::type_info &retrieving) |
Ensures an expected name and type is present. More... | |
Interface for Discrete Log (DL) group parameters.
T | element in the group The element is usually an Integer, ECP::Point or EC2N::Point |
|
inlinevirtual |
Check this object for errors.
rng | a RandomNumberGenerator for objects which use randomized testing |
level | the level of thoroughness |
Implements CryptoMaterial.
|
inlinevirtual |
Get a named value.
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 |
Implements NameValuePairs.
|
inlinevirtual |
Determines whether the object supports precomputation.
Reimplemented from CryptoMaterial.
|
inlinevirtual |
Perform precomputation.
precomputationStorage | the suggested number of objects for the precompute table |
NotImplemented | The exact semantics of Precompute() varies, but it typically means calculate a table of n objects that can be used later to speed up computation. If a derived class does not override Precompute(), then the base class throws NotImplemented. |
Reimplemented from CryptoMaterial.
|
inlinevirtual |
Retrieve previously saved precomputation.
storedPrecomputation | BufferedTransformation with the saved precomputation |
NotImplemented |
Reimplemented from CryptoMaterial.
|
inlinevirtual |
Save precomputation for later use.
storedPrecomputation | BufferedTransformation to write the precomputation |
NotImplemented |
Reimplemented from CryptoMaterial.
|
inlinevirtual |
|
inlinevirtual |
|
inlinevirtual |
Exponentiates the base.
|
inlinevirtual |
Exponentiates an element.
base | the base elemenet |
exponent | the exponent to raise the base |
|
pure virtual |
Retrieves the group precomputation.
Implemented in DL_GroupParametersImpl< GROUP_PRECOMP, DL_FixedBasePrecomputationImpl< typename GROUP_PRECOMP::Element >, DL_GroupParameters_IntegerBased >, DL_GroupParametersImpl< EcPrecomputation< EC > >, DL_GroupParametersImpl< ModExpPrecomputation, DL_FixedBasePrecomputationImpl< typename GROUP_PRECOMP::Element >, DL_GroupParameters_IntegerBased >, and DL_GroupParametersImpl< DL_GroupPrecomputation_LUC, DL_BasePrecomputation_LUC, DL_GroupParameters_IntegerBased >.
|
pure virtual |
Retrieves the group precomputation.
Implemented in DL_GroupParametersImpl< GROUP_PRECOMP, DL_FixedBasePrecomputationImpl< typename GROUP_PRECOMP::Element >, DL_GroupParameters_IntegerBased >, DL_GroupParametersImpl< EcPrecomputation< EC > >, DL_GroupParametersImpl< ModExpPrecomputation, DL_FixedBasePrecomputationImpl< typename GROUP_PRECOMP::Element >, DL_GroupParameters_IntegerBased >, and DL_GroupParametersImpl< DL_GroupPrecomputation_LUC, DL_BasePrecomputation_LUC, DL_GroupParameters_IntegerBased >.
|
pure virtual |
Retrieves the group precomputation.
Implemented in DL_GroupParametersImpl< GROUP_PRECOMP, BASE_PRECOMP, BASE >, DL_GroupParametersImpl< GROUP_PRECOMP, DL_FixedBasePrecomputationImpl< typename GROUP_PRECOMP::Element >, DL_GroupParameters_IntegerBased >, DL_GroupParametersImpl< EcPrecomputation< EC > >, DL_GroupParametersImpl< ModExpPrecomputation, DL_FixedBasePrecomputationImpl< typename GROUP_PRECOMP::Element >, DL_GroupParameters_IntegerBased >, DL_GroupParametersImpl< DL_GroupPrecomputation_LUC, DL_BasePrecomputation_LUC, DL_GroupParameters_IntegerBased >, DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >, DL_GroupParameters_IntegerBasedImpl< DL_GroupPrecomputation_LUC, DL_BasePrecomputation_LUC >, DL_GroupParameters_IntegerBasedImpl< ModExpPrecomputation >, and DL_GroupParameters_EC< EC >.
|
pure virtual |
Retrieves the subgroup order.
|
pure virtual |
Retrieves the maximum exponent for the group.
|
inlinevirtual |
Retrieves the order of the group.
|
inlinevirtual |
Retrieves the cofactor.
|
pure virtual |
Retrieves the encoded element's size.
reversible | flag indicating the encoding format |
Implemented in DL_GroupParameters_IntegerBased, and DL_GroupParameters_EC< EC >.
|
pure virtual |
Encodes the element.
reversible | flag indicating the encoding format |
element | reference to the element to encode |
encoded | destination byte array for the encoded element EncodeElement() must be implemented in a derived class. |
COUNTOF(encoded) == GetEncodedElementSize()
Implemented in DL_GroupParameters_IntegerBased.
|
pure virtual |
Decodes the element.
encoded | byte array with the encoded element |
checkForGroupMembership | flag indicating if the element should be validated |
COUNTOF(encoded) == GetEncodedElementSize()
Implemented in DL_GroupParameters_IntegerBased, and DL_GroupParameters_EC< EC >.
|
pure virtual |
Converts an element to an Integer.
element | the element to convert to an Integer |
Implemented in DL_GroupParameters_IntegerBased.
|
pure virtual |
Check the group for errors.
rng | RandomNumberGenerator for objects which use randomized testing |
level | level of thoroughness |
Implemented in DL_GroupParameters_DSA, DL_GroupParameters_IntegerBased, and DL_GroupParameters_EC< EC >.
|
pure virtual |
Check the element for errors.
level | level of thoroughness |
element | element to check |
precomp | optional pointer to DL_FixedBasePrecomputation |
Implemented in DL_GroupParameters_IntegerBased.
|
pure virtual |
Determines if an element is an identity.
element | element to check |
Implemented in DL_GroupParameters_LUC, and DL_GroupParameters_GFP.
|
pure virtual |
Exponentiates a base to multiple exponents.
results | an array of Elements |
base | the base to raise to the exponents |
exponents | an array of exponents |
exponentsCount | the number of exponents in the array SimultaneousExponentiate() raises the base to each exponent in the exponents array and stores the result at the respective position in the results array. SimultaneousExponentiate() must be implemented in a derived class. |
COUNTOF(results) == exponentsCount
COUNTOF(exponents) == exponentsCount