Component : Software

Software implementation of the Random Number interface. More...

Collaboration diagram for Component : Software:

Modules
	Internals
	Software implementation of the RND Generator.

Data Structures
struct	phCryptoRng_Sw_DataParams_t
	Data structure for Random Number's Software layer implementation. More...

Functions
phStatus_t	phCryptoRng_Sw_Init (phCryptoRng_Sw_DataParams_t *pDataParams, uint16_t wSizeOfDataParams, void *pCryptoDataParams)
	Initialize the CryptoRng with software as sub-component. More...

Detailed Description

Software implementation of the Random Number interface.

The following standard is implemented:

• NIST Special Publication 800-90: CTR_DRBG

Architecture overview of the Software Component

• The AES 128 implementation of the Symmetric Crypto component is used to generate random numbers.
• This Symmetric Crypto instance has to be properly instantiated before generation of random numbers is possible.
• The Internal block implements all functions required by the NIST standard.
• According to the state of the library component, the seed function choses whether to use Instantiate or Re-Seed.
• Update is automatically called when random numbers are generated in order to be ready for retrieving the next chunk of random bytes.
• BlockCipherDf is used to derive the key and V-value for a given seed.

Function Documentation

phCryptoRng_Sw_Init()

phStatus_t phCryptoRng_Sw_Init	(	phCryptoRng_Sw_DataParams_t *	pDataParams,
		uint16_t	wSizeOfDataParams,
		void *	pCryptoDataParams
	)

Initialize the CryptoRng with software as sub-component.

For seeding, the following considerations have to be taken:

• Take a seed of at 32 bytes, which consists of
  • entropy input
  • nonce
  • personalization string.

Returns

Status code

Return values

PH_ERR_SUCCESS	Operation successful.
PH_ERR_INVALID_DATA_PARAMS	If the input size do not match the DataParams size of this component. If the DataParams are null.

Parameters

[in]	pDataParams	[In] Pointer to this layers parameter structure.
[in]	wSizeOfDataParams	[In] Specifies the size of the data parameter structure.
[in]	pCryptoDataParams	[In] Pointer to the parameter structure of the symmetric crypto layer.