Cryptographic message hashing SHA-2.

Parent topic: SX_symcrypt_API

SXSYMCRYPT_SHA2_API_FILE Macro

C

#define SXSYMCRYPT_SHA2_API_FILE

@file

@copyright Copyright (c) 2019-2020 Silex Insight. All Rights reserved.

Hash algorithm SHA-2 224

SXHASHALG_SHA2_224 Macro

C

#define SXHASHALG_SHA2_224 ((const struct sxhashalg )((uint32_t )(API_TABLE_BASE_ADDRESS + ATO_SXHASHALG_SHA2_224)))

Has only 32 bit capacity against length extension attacks.

Hash algorithm SHA-2 256

SXHASHALG_SHA2_256 Macro

C

#define SXHASHALG_SHA2_256 ((const struct sxhashalg )((uint32_t )(API_TABLE_BASE_ADDRESS + ATO_SXHASHALG_SHA2_256)))

Has no resistance against length extension attacks.

Hash algorithm SHA-2 384

SXHASHALG_SHA2_384 Macro

C

#define SXHASHALG_SHA2_384 ((const struct sxhashalg )((uint32_t )(API_TABLE_BASE_ADDRESS + ATO_SXHASHALG_SHA2_384)))

Has 128 bit capacity against length extension attacks.

Hash algorithm SHA-2 512

SXHASHALG_SHA2_512 Macro

C

#define SXHASHALG_SHA2_512 ((const struct sxhashalg )((uint32_t )(API_TABLE_BASE_ADDRESS + ATO_SXHASHALG_SHA2_512)))

Has no resistance against length extension attacks.

Prepares a SHA256 hash operation context

SX_HASH_CREATE_SHA256 Macro

C

typedef int (FUNC_SX_HASH_CREATE_SHA256)(struct sxhash c, size_t csz);
#define SX_HASH_CREATE_SHA256 ((FUNC_SX_HASH_CREATE_SHA256)((uint32_t )(API_TABLE_BASE_ADDRESS + ATO_SX_HASH_CREATE_SHA256)))

This function initializes the user allocated object \p c with a new hash operation context and reserves the HW resource.

After successful execution of this function, the context \p c can be passed to any of the hashing functions.

Parameters

c hash operation context

Parameters

csz size of the hash operation context @return ::SX_OK @return ::SX_ERR_INCOMPATIBLE_HW @return ::SX_ERR_RETRY | Param | Description | |:----- |:----------- |

| @remark | SHA256 digest size is 32 bytes

Prepares a SHA384 hash operation context

SX_HASH_CREATE_SHA384 Macro

C

typedef int (FUNC_SX_HASH_CREATE_SHA384)(struct sxhash c, size_t csz);
#define SX_HASH_CREATE_SHA384 ((FUNC_SX_HASH_CREATE_SHA384)((uint32_t )(API_TABLE_BASE_ADDRESS + ATO_SX_HASH_CREATE_SHA384)))

This function initializes the user allocated object \p c with a new hash operation context and reserves the HW resource.

After successful execution of this function, the context \p c can be passed to any of the hashing functions.

Parameters

c hash operation context

Parameters

csz size of the hash operation context @return ::SX_OK @return ::SX_ERR_INCOMPATIBLE_HW @return ::SX_ERR_RETRY | Param | Description | |:----- |:----------- |

| @remark | SHA384 digest size is 48 bytes

Prepares a SHA512 hash operation context

SX_HASH_CREATE_SHA512 Macro

C

typedef int (FUNC_SX_HASH_CREATE_SHA512)(struct sxhash c, size_t csz);
#define SX_HASH_CREATE_SHA512 ((FUNC_SX_HASH_CREATE_SHA512)((uint32_t )(API_TABLE_BASE_ADDRESS + ATO_SX_HASH_CREATE_SHA512)))

This function initializes the user allocated object \p c with a new hash operation context and reserves the HW resource.

After successful execution of this function, the context \p c can be passed to any of the hashing functions.

Parameters

c hash operation context

Parameters

csz size of the hash operation context @return ::SX_OK @return ::SX_ERR_INCOMPATIBLE_HW @return ::SX_ERR_RETRY | Param | Description | |:----- |:----------- |

| @remark | SHA512 digest size is 64 bytes

Prepares a SHA224 hash operation context

This function initializes the user allocated object \p c with a new hash operation context and reserves the HW resource.

After successful execution of this function, the context \p c can be passed to any of the hashing functions.

Parameters

c hash operation context

Parameters

csz size of the hash operation context @return ::SX_OK @return ::SX_ERR_INCOMPATIBLE_HW @return ::SX_ERR_RETRY | Param | Description | |:----- |:----------- |

| @remark | SHA224 digest size is 28 bytes