Developer Reference

Contents

mbx_sm4_set_key_mb16

Initializes multi buffer key schedule to provide all necessary key material for both encryption and decryption operations.

Syntax

mbx_status16 mbx_sm4_set_key_mb16(mbx_sm4_key_schedule*
key_sched
, const sm4_key*
pa_key
[SM4_LINES]);
Include Files
crypto_mb/sm4.h
Parameters
key_sched
Pointer to key schedule being initialized.
pa_key
Array of pointers to the SM4 secret keys.
Description
Sets up
mbx_sm4_key_schedule
key schedule pointed by
key_sched
using user-supplied secret keys passed through
pa_key
with all necessary key material for both encryption and decryption operations.
Return Values
The
mbx_sm4_set_key_mb16()
function returns the status that indicates whether the operation completed successfully or not. The status value of 0 indicates that the key schedule was successfully initialized. In case of 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 the mbx_status16, which can be analyzed separately with
MBX_GET_STS()
call. The low part includes first eight statuses, while the high part includes remaining 8 statuses for each operation.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.