src/Resource/sha2.h File Reference

This file contains methods required to calculate SHA-256 hashes. More...

Go to the source code of this file.

Classes
struct	sha2_context
Functions
void	sha2_starts (sha2_context *ctx, int is224)
void	sha2_update (sha2_context *ctx, unsigned char *input, int ilen)
void	sha2_finish (sha2_context *ctx, unsigned char *output)
void	sha2 (unsigned char *input, int ilen, unsigned char *output, int is224)
int	sha2_file (char *path, unsigned char *output, int is224)
void	sha2_hmac_starts (sha2_context *ctx, int is224, unsigned char *key, int keylen)
void	sha2_hmac_update (sha2_context *ctx, unsigned char *input, int ilen)
void	sha2_hmac_finish (sha2_context *ctx, unsigned char *output)
void	sha2_hmac (unsigned char *key, int keylen, unsigned char *input, int ilen, unsigned char *output, int is224)
int	sha2_self_test (int verbose)

---

Detailed Description

This file contains methods required to calculate SHA-256 hashes.

Definition in file sha2.h.

---

Function Documentation

void sha2	(	unsigned char *	input,
		int	ilen,
		unsigned char *	output,
		int	is224
	)

Output = SHA-256( input buffer )

Parameters:

	input	buffer holding the data
	ilen	length of the input data
	output	SHA-224/256 checksum result
	is224	0 = use SHA256, 1 = use SHA224

int sha2_file	(	char *	path,
		unsigned char *	output,
		int	is224
	)

Output = SHA-256( file contents )

Parameters:

	path	input file name
	output	SHA-224/256 checksum result
	is224	0 = use SHA256, 1 = use SHA224

Returns:

0 if successful, 1 if fopen failed, or 2 if fread failed

void sha2_finish	(	sha2_context *	ctx,
		unsigned char *	output
	)

SHA-256 final digest

Parameters:

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

void sha2_hmac	(	unsigned char *	key,
		int	keylen,
		unsigned char *	input,
		int	ilen,
		unsigned char *	output,
		int	is224
	)

Output = HMAC-SHA-256( hmac key, input buffer )

Parameters:

	key	HMAC secret key
	keylen	length of the HMAC key
	input	buffer holding the data
	ilen	length of the input data
	output	HMAC-SHA-224/256 result
	is224	0 = use SHA256, 1 = use SHA224

void sha2_hmac_finish	(	sha2_context *	ctx,
		unsigned char *	output
	)

SHA-256 HMAC final digest

Parameters:

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

void sha2_hmac_starts	(	sha2_context *	ctx,
		int	is224,
		unsigned char *	key,
		int	keylen
	)

SHA-256 HMAC context setup

Parameters:

	ctx	HMAC context to be initialized
	is224	0 = use SHA256, 1 = use SHA224
	key	HMAC secret key
	keylen	length of the HMAC key

void sha2_hmac_update	(	sha2_context *	ctx,
		unsigned char *	input,
		int	ilen
	)

SHA-256 HMAC process buffer

Parameters:

	ctx	HMAC context
	input	buffer holding the data
	ilen	length of the input data

int sha2_self_test

(

int

verbose

)

Checkup routine

Returns:

0 if successful, or 1 if the test failed

void sha2_starts	(	sha2_context *	ctx,
		int	is224
	)

SHA-256 context setup

Parameters:

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

void sha2_update	(	sha2_context *	ctx,
		unsigned char *	input,
		int	ilen
	)

SHA-256 process buffer

Parameters:

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

---