MCUX CLNS
MCUX Crypto Library Normal Secure
McuxClPkc_Functions_UPTRT

mcuxClPkc functions of PKC UPTR table setup More...

Macros

#define MCUXCLPKC_FP_GENERATEUPTRT(pUPTRT, pBaseBuffer, bufferSize, noOfBuffer)
 Helper macro to call #mcuxClPkc_GenerateUPTRT with flow protection. More...
 

Functions

 MCUX_CSSL_FP_PROTECTED_TYPE (mcuxClPkc_Status_t) mcuxClPkc_RandomizeUPTRT(mcuxClSession_Handle_t pSession
 Randomize UPTR table. More...
 

Variables

const uint8_t * pBaseBuffer
 
const uint8_t uint16_t bufferLength
 
const uint8_t uint16_t uint8_t noOfBuffer
 
uint16_t * pUPTRT
 

Detailed Description

mcuxClPkc functions of PKC UPTR table setup

Macro Definition Documentation

◆ MCUXCLPKC_FP_GENERATEUPTRT

#define MCUXCLPKC_FP_GENERATEUPTRT (   pUPTRT,
  pBaseBuffer,
  bufferSize,
  noOfBuffer 
)

Helper macro to call #mcuxClPkc_GenerateUPTRT with flow protection.

Function Documentation

◆ MCUX_CSSL_FP_PROTECTED_TYPE()

MCUX_CSSL_FP_PROTECTED_TYPE ( mcuxClPkc_Status_t  )

Randomize UPTR table.

Deprecated type for mcuxClSession protected status codes.

Deprecated type for RSA protected status codes.

Deprecated type for error codes used by code-flow protected PKC component functions.

Deprecated type for error codes used by code-flow protected mcuxClMemory component functions.

Deprecated type for error codes used by code-flow protected Math component functions.

Deprecated type for Key component error codes, returned by functions with code-flow protection.

Deprecated type for ELS driver protected status codes.

Deprecated type for mcuxClEcc component return codes.

Randomize UPTR table and operands in PKC workarea.

This function randomly permutes offsets stored in UPTR table. It randomizes the buffer allocation (physical address in PKC workarea). When calling this function, there shall be no on-going and pending PKC calculations using the specified UPTR table elements.

Parameters
[in]pSessionhandle for the current CL session.
[in,out]pUPTRTpointer to the first element to be randomized in UPTR table.
[in]noOfBuffernumber of elements to be randomized.
Parameter properties
pSession:
The session pointed to by pSession has to be initialized prior to a call to this function.
pUPTRT
this pointer shall be 2-byte aligned.
Attention
Only the buffer allocation will be randomized, existing operands stored in each buffer will not be moved accordingly.
This function uses PRNG. Caller needs to check if PRNG is ready.
Returns
A flow-protected status code (see Flow Protection API).
Return values
MCUXCLPKC_STATUS_OKif UPTR table is randomized successfully.
MCUXCLPKC_STATUS_NOKif the operation failed.
Attention
This function uses PRNG which has to be initialized prior to calling the function.

This function randomly permutes offsets stored in UPTR table, together with operands stored in each buffer in PKC workarea. It randomizes the buffer allocation (physical address in PKC workarea) and moves operands stored accordingly. When calling this function, there shall be no on-going and pending PKC calculations using the specified UPTR table elements.

Parameters
[in]pSessionhandle for the current CL session.
[in,out]pUPTRTpointer to the first element to be randomized in UPTR table.
[in]bufferLengthbyte length of each buffer in PKC workarea.
[in]noOfBuffernumber of elements to be randomized.
Parameter properties
pSession:
The session pointed to by pSession has to be initialized prior to a call to this function.
pUPTRT
this pointer shall be 2-byte aligned.
All offsets (pUPTRT[0~(noOfBuffer-1)]) shall be exactly a multiple of MCUXCLPKC_WORDSIZE.
bufferLength
this length shall be a multiple of MCUXCLPKC_WORDSIZE.
Attention
This function uses PRNG. Caller needs to check if PRNG is ready.
Returns
A flow-protected status code (see Flow Protection API).
Return values
MCUXCLPKC_STATUS_OKif UPTR table is randomized successfully.
MCUXCLPKC_STATUS_NOKif the operation failed.
Attention
This function uses PRNG which has to be initialized prior to calling the function.