CDSAParameters Class Reference

#include <asymmetrickeys.h>

class CDSAParameters : public CBase

Inherits from

CDSAParameters
- CBase

Protected Attributes
RInteger	iG
RInteger	iP
RInteger	iQ

Public Member Functions
virtual	~CDSAParameters(void)
IMPORT_C const TInteger &	G(void)
TBool	GeneratePrimesL(const TDesC8 &, TUint &, RInteger &, TUint, RInteger &, TBool)
IMPORT_C CDSAParameters *	NewL(RInteger &, RInteger &, RInteger &)
IMPORT_C const TInteger &	P(void)
IMPORT_C const TInteger &	Q(void)
IMPORT_C TBool	ValidPrimeLength(TUint)
IMPORT_C TBool	ValidatePrimesL(const CDSAPrimeCertificate &)

Protected Member Functions
	CDSAParameters(RInteger &, RInteger &, RInteger &)
	CDSAParameters(void)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Detailed Description

Concrete class representing the parameters common to both a DSA public and private key.

See FIPS 186-2, Digital Signature Standard

Member Attribute Documentation

iG

RInteger

[protected]

The DSA parameter, g (the base)

g = h^((p-1)/q) mod p,

where h is any integer less than p-1 such that g > 1

iP

RInteger

[protected]

The DSA parameter, p (the prime).

A prime modulus whose length is between KMinPrimeLength and KMaxPrimeLength bits, and is a multiple of KPrimeLengthMultiple.

iQ

RInteger

[protected]

The DSA parameter, q (the subprime)

This is a 160-bit prime divisor of p-1.

Constructor & Destructor Documentation

CDSAParameters ( RInteger &, RInteger &, RInteger & )

IMPORT_C	CDSAParameters	(	RInteger &	aP,
			RInteger &	aQ,
			RInteger &	aG
		)	[protected]

Constructor

Parameters
aP	The DSA parameter, p (the prime)
aQ	The DSA parameter, g (the subprime)
aG	The DSA parameter, g (the base)

CDSAParameters ( void )

IMPORT_C

CDSAParameters

(

void

)

[protected]

Default constructor

~CDSAParameters ( void )

IMPORT_C

~CDSAParameters

(

void

)

[virtual]

Destructor

Member Function Documentation

G ( void )

IMPORT_C const TInteger &

(

void

)

const

Gets the DSA parameter, g (the base)

Return Value: The DSA parameter, g

GeneratePrimesL ( const TDesC8 &, TUint &, RInteger &, TUint, RInteger &, TBool )

TBool	GeneratePrimesL	(	const TDesC8 &	aSeed,
			TUint &	aCounter,
			RInteger &	aP,
			TUint	aL,
			RInteger &	aQ,
			TBool	aUseInputCounter = EFalse
		)	[static]

NewL ( RInteger &, RInteger &, RInteger & )

IMPORT_C CDSAParameters *	NewL	(	RInteger &	aP,
			RInteger &	aQ,
			RInteger &	aG
		)	[static]

Creates a new DSA parameters object from a specified prime, subprime, and base.

Parameters
aP	The DSA parameter, p (the prime)
aQ	The DSA parameter, g (the subprime)
aG	The DSA parameter, g (the base)

Return Value: A pointer to a new CDSAParameters object

P ( void )

IMPORT_C const TInteger &

(

void

)

const

Gets the DSA parameter, p (the prime)

Return Value: The DSA parameter, p

Q ( void )

IMPORT_C const TInteger &

(

void

)

const

Gets the DSA parameter, q (the subprime)

Return Value: The DSA parameter, q

ValidPrimeLength ( TUint )

IMPORT_C TBool

ValidPrimeLength

(

TUint

aPrimeBits

)

[static]

Whether or not the prime is of a valid length

It is valid if the length of the prime modulus is between KMinPrimeLength and KMaxPrimeLength bits, and the prime is a multiple of KPrimeLengthMultiple.

Parameters
aPrimeBits	The prime modulus

Return Value: ETrue, if within the constraints; EFalse, otherwise.

ValidatePrimesL ( const CDSAPrimeCertificate & )

IMPORT_C TBool

ValidatePrimesL

(

const CDSAPrimeCertificate &

aCert

)

const

Validates the primes regenerated from a DSA prime certificate

Parameters
aCert	The DSA prime certificate that contains the seed and counter value from a DSA key generation process

Return Value: Whether or not the primes are valid