Data integrity core functionality

Data integrity handling core functionality. More...

Macros
#define	MCUX_CSSL_DI_CHECK_PASSED
	Positive comparison result value.
#define	MCUX_CSSL_DI_CHECK_FAILED
	Negative comparison result value.
#define	MCUX_CSSL_DI_INIT(backupValue)
	Backup of the current data integrity value, that will be checked later on with MCUX_CSSL_SC_CHECK.
#define	MCUX_CSSL_DI_CHECK(reference)
	Comparison operation for the data integrity.
#define	MCUX_CSSL_DI_CHECK_EXIT(id, reference, fail)
	Comparison operation for the data integrity.
#define	MCUX_CSSL_DI_DONOTOPTIMIZE(val)
	Prevent compiler from pre-calculating the DI-protected variable value.

Detailed Description

Data integrity handling core functionality.

Macro Definition Documentation

MCUX_CSSL_DI_CHECK_PASSED

#define MCUX_CSSL_DI_CHECK_PASSED

Positive comparison result value.

MCUX_CSSL_DI_CHECK_FAILED

#define MCUX_CSSL_DI_CHECK_FAILED

Negative comparison result value.

MCUX_CSSL_DI_INIT

#define MCUX_CSSL_DI_INIT

(

backupValue

)

Backup of the current data integrity value, that will be checked later on with MCUX_CSSL_SC_CHECK.

Note that in case the Security Counter back-end requires allocation, it is expected that this will be handled by the Flow Protection mechanism before the initialization of the Data Integrity.

Parameters

backupValue

Fresh variable name to store the current DI value.

MCUX_CSSL_DI_CHECK

#define MCUX_CSSL_DI_CHECK

(

reference

)

Comparison operation for the data integrity.

Parameters

reference

Reference initial value to compare the data integrity value against.

Returns

Either MCUX_CSSL_DI_CHECK_PASSED, if the value matches, or MCUX_CSSL_DI_CHECK_FAILED if the value is different.

MCUX_CSSL_DI_CHECK_EXIT

#define MCUX_CSSL_DI_CHECK_EXIT	(		id,
			reference,
			fail )

Comparison operation for the data integrity.

It compares the data integrity value to reference initial value, and exits with the given fault status code if the comparison fails. The reference value shall be the initial value that was backed up with MCUX_CSSL_DI_INIT. If the comparison succeeds, the normal execution will continue.

Parameters

id	Identifier of the function from which we will exit.
reference	Reference initial value to compare the data integrity value against.
fail	Result that should be returned if the data integrity check failed.

MCUX_CSSL_DI_DONOTOPTIMIZE

#define MCUX_CSSL_DI_DONOTOPTIMIZE

(

val

)

Prevent compiler from pre-calculating the DI-protected variable value.

Parameters

value

Variable that is protected with Data Integrity.