mbx_sm4_ccm_encrypt/decrypt_mb16

Encrypts plaintext (ccm_encrypt) and decrypts ciphertext (ccm_decrypt).

Syntax

mbx_status16 mbx_sm4_ccm_encrypt_mb16(int8u* pa_out[SM4_LINES], const int8u* const pa_in[SM4_LINES], const int in_len[SM4_LINES], SM4_CCM_CTX_mb16* p_context);

mbx_status16 mbx_sm4_ccm_decrypt_mb16(int8u* pa_out[SM4_LINES], const int8u* const pa_in[SM4_LINES], const int in_len[SM4_LINES], SM4_CCM_CTX_mb16* p_context);

Include Files

crypto_mb/sm4_ccm.h

Parameters

pa_out	Array of pointers to the output data streams.
pa_in	Array of pointers to the input data streams.
in_len	Array of lengths of the input data in bytes.
p_context	Pointer to the context to keep intermediate results between calls.

Description

These functions encrypt/decrypt the input data streams passed by pa_in of a variable length (up to 2^32 -1 bytes) passed through the in_len array according to the CCM cipher scheme and store the results into the memory buffers specified in the pa_out parameter. The unctions also update the context with an intermediate hash value.

Note

These functions have several call sequence restrictions. See SM4 CCM Algorithm Functions for details.

Return Values

The mbx_sm4_ccm_encrypt_mb16/mbx_sm4_ccm_decrypt_mb16() functions return the status that indicates whether the operation is completed successfully or not. The status value of 0 indicates that the key schedule is successfully initialized. In case of a non-zero status value, MBX_GET_HIGH_PART_STS16() and MBX_GET_LOW_PART_STS16() can help to get the low and high parts of mbx_status16, which can be analyzed separately with the MBX_GET_STS() call. The low part includes the first eight statuses, while the high part includes the remaining eight statuses for each operation.