mbx_sm4_gcm_get_tag_mb16¶
Computes the authentication tag.
Syntax¶
mbx_status16 mbx_sm4_gcm_get_tag_mb16(int8u* pa_out[SM4_LINES], const int tag_len[SM4_LINES], SM4_GCM_CTX_mb16* p_context);
Include Files¶
crypto_mb/sm4_gcm.h
Parameters¶
pa_out |
Array of pointers to the output data streams. |
tag_len |
Array of lengths of the authentication tag in bytes. |
p_context |
Pointer to the context to keep intermediate results between calls. |
Description¶
Computes the authentication tag value of length passed through the tag_len array and stores
the results into the memory buffers specified in the pa_out parameter.
Note
mbx_sm4_gcm_get_tag_mb16 has several call sequence restrictions. See SM4 GCM Algorithm Functions page for details.
Return Values¶
The mbx_sm4_gcm_get_tag_mb16() function returns 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.