SHA-224 and SHA-256 cryptographic hash function

Detailed Description

CRYPTO hardware accelerated SHA-224 and SHA-256 cryptographic hash function.

Collaboration diagram for SHA-224 and SHA-256 cryptographic hash function:

Data Structures
struct	mbedtls_sha256_context
	SHA-256 context structure. More...

Macros
#define	MBEDTLS_ERR_SHA256_BAD_INPUT   -0x5100
	Bad input parameters to function. More...

Functions
void	mbedtls_sha256_init (mbedtls_sha256_context *ctx)
	Initialize SHA-256 context. More...
void	mbedtls_sha256_free (mbedtls_sha256_context *ctx)
	Clear SHA-256 context. More...
void	mbedtls_sha256_clone (mbedtls_sha256_context *dst, const mbedtls_sha256_context *src)
	Clone (the state of) a SHA-256 context. More...
int	mbedtls_sha256_starts (mbedtls_sha256_context *ctx, int is224)
	SHA-256 context setup. More...
void	mbedtls_sha256_update (mbedtls_sha256_context *ctx, const unsigned char *input, size_t ilen)
	SHA-256 process buffer. More...
void	mbedtls_sha256_finish (mbedtls_sha256_context *ctx, unsigned char output[32])
	SHA-256 final digest. More...
void	mbedtls_sha256_process (mbedtls_sha256_context *ctx, const unsigned char data[64])
int	mbedtls_sha256 (const unsigned char *input, size_t ilen, unsigned char output[32], int is224)
	Output = SHA-256( input buffer ) More...
int	mbedtls_sha256_self_test (int verbose, int device_instance)
	Checkup routine. More...

Macro Definition Documentation

#define MBEDTLS_ERR_SHA256_BAD_INPUT   -0x5100

Bad input parameters to function.

Definition at line 49 of file sha256_alt.h.

Function Documentation

int mbedtls_sha256	(	const unsigned char *	input,
		size_t	ilen,
		unsigned char	output[32],
		int	is224
	)

Output = SHA-256( input buffer )

Parameters

input	Buffer holding the data. The input buffer needs to be big enough to hold the padding (MD-strenghtening) at the end, after the message of 'ilen' length. This function will perform MD-strengthening and append to the end of the input buffer.
ilen	length of the input data
output	SHA-224/256 checksum result
is224	0 = use SHA256, 1 = use SHA224

void mbedtls_sha256_clone	(	mbedtls_sha256_context *	dst,
		const mbedtls_sha256_context *	src
	)

Clone (the state of) a SHA-256 context.

Parameters

dst	The destination context
src	The context to be cloned

void mbedtls_sha256_finish	(	mbedtls_sha256_context *	ctx,
		unsigned char	output[32]
	)

SHA-256 final digest.

Parameters

ctx	SHA-256 context
output	SHA-224/256 checksum result

void mbedtls_sha256_free

(

mbedtls_sha256_context *

ctx

)

Clear SHA-256 context.

Parameters

ctx	SHA-256 context to be cleared

void mbedtls_sha256_init

(

mbedtls_sha256_context *

ctx

)

Initialize SHA-256 context.

Parameters

ctx	SHA-256 context to be initialized

void mbedtls_sha256_process	(	mbedtls_sha256_context *	ctx,
		const unsigned char	data[64]
	)

int mbedtls_sha256_self_test	(	int	verbose,
		int	device_instance
	)

Checkup routine.

Returns

0 if successful, or 1 if the test failed

int mbedtls_sha256_starts	(	mbedtls_sha256_context *	ctx,
		int	is224
	)

SHA-256 context setup.

Parameters

ctx	context to be initialized
is224	0 = use SHA256, 1 = use SHA224

void mbedtls_sha256_update	(	mbedtls_sha256_context *	ctx,
		const unsigned char *	input,
		size_t	ilen
	)

SHA-256 process buffer.

Parameters

ctx	SHA-256 context
input	buffer holding the data
ilen	length of the input data