mcuxCsslMemory_Clear Function Definitions

mcuxCsslMemory_Clear Function Definitions More...

Functions
mcuxCsslMemory_Status_t	mcuxCsslMemory_Clear (mcuxCsslParamIntegrity_Checksum_t chk, void *pDst, uint32_t dstLength, uint32_t length)
	Clear length bytes of data at pDst.

Detailed Description

mcuxCsslMemory_Clear Function Definitions

Function Documentation

mcuxCsslMemory_Clear()

mcuxCsslMemory_Status_t mcuxCsslMemory_Clear	(	mcuxCsslParamIntegrity_Checksum_t	chk,
		void *	pDst,
		uint32_t	dstLength,
		uint32_t	length )

Clear length bytes of data at pDst.

The implementation is secure in the following aspects: Parameter integrity protection: the function returns immediately in case of an incorrect parameter checksum. Code flow protection: the function call is protected. Buffer overflow protection: no data is written to pDst beyond dstLength bytes. If length > dstLength we return MCUXCSSLMEMORY_STATUS_INVALID_PARAMETER.

Parameters

[in]	chk	The parameter checksum, generated with #MCUX_CSSL_PI_PROTECT.
[in]	pDst	The destination pointer to buffer to be cleared. Must not be NULL.
[in]	dstLength	The size of the destination data buffer in bytes.
[in]	length	The number of bytes to clear.

Returns

A status code encapsulated in a flow-protection type.

Return values

MCUXCSSLMEMORY_STATUS_OK	If the contents in buffer at pDst is cleared.
MCUXCSSLMEMORY_STATUS_INVALID_PARAMETER	If one of the parameters is invalid.
MCUXCSSLMEMORY_STATUS_FAULT	If a fault was detected, included invalid checksum chk.

Examples

mcuxCsslMemory_Clear_example.c.