[people/ms/u-boot.git] / include / u-boot / sha1.h

/**
 * \file sha1.h
 * based from http://xyssl.org/code/source/sha1/
 *  FIPS-180-1 compliant SHA-1 implementation
 *
 *  Copyright (C) 2003-2006  Christophe Devine
 *
 * SPDX-License-Identifier:	LGPL-2.1
 */
/*
 *  The SHA-1 standard was published by NIST in 1993.
 *
 *  http://www.itl.nist.gov/fipspubs/fip180-1.htm
 */
#ifndef _SHA1_H
#define _SHA1_H

#ifdef __cplusplus
extern "C" {
#endif

#define SHA1_SUM_POS	-0x20
#define SHA1_SUM_LEN	20
#define SHA1_DER_LEN	15

extern const uint8_t sha1_der_prefix[];

/**
 * \brief	   SHA-1 context structure
 */
typedef struct
{
    unsigned long total[2];	/*!< number of bytes processed	*/
    unsigned long state[5];	/*!< intermediate digest state	*/
    unsigned char buffer[64];	/*!< data block being processed */
}
sha1_context;

/**
 * \brief	   SHA-1 context setup
 *
 * \param ctx	   SHA-1 context to be initialized
 */
void sha1_starts( sha1_context *ctx );

/**
 * \brief	   SHA-1 process buffer
 *
 * \param ctx	   SHA-1 context
 * \param input    buffer holding the  data
 * \param ilen	   length of the input data
 */
void sha1_update(sha1_context *ctx, const unsigned char *input,
		 unsigned int ilen);

/**
 * \brief	   SHA-1 final digest
 *
 * \param ctx	   SHA-1 context
 * \param output   SHA-1 checksum result
 */
void sha1_finish( sha1_context *ctx, unsigned char output[20] );

/**
 * \brief	   Output = SHA-1( input buffer )
 *
 * \param input    buffer holding the  data
 * \param ilen	   length of the input data
 * \param output   SHA-1 checksum result
 */
void sha1_csum(const unsigned char *input, unsigned int ilen,
		unsigned char *output);

/**
 * \brief	   Output = SHA-1( input buffer ), with watchdog triggering
 *
 * \param input    buffer holding the  data
 * \param ilen	   length of the input data
 * \param output   SHA-1 checksum result
 * \param chunk_sz watchdog triggering period (in bytes of input processed)
 */
void sha1_csum_wd(const unsigned char *input, unsigned int ilen,
		unsigned char *output, unsigned int chunk_sz);

/**
 * \brief	   Output = HMAC-SHA-1( input buffer, hmac key )
 *
 * \param key	   HMAC secret key
 * \param keylen   length of the HMAC key
 * \param input    buffer holding the  data
 * \param ilen	   length of the input data
 * \param output   HMAC-SHA-1 result
 */
void sha1_hmac(const unsigned char *key, int keylen,
		const unsigned char *input, unsigned int ilen,
		unsigned char *output);

/**
 * \brief	   Checkup routine
 *
 * \return	   0 if successful, or 1 if the test failed
 */
int sha1_self_test( void );

#ifdef __cplusplus
}
#endif

#endif /* sha1.h */
Commit	Line	Data
	1	/**
	2	* \file sha1.h
	3	* based from http://xyssl.org/code/source/sha1/
	4	* FIPS-180-1 compliant SHA-1 implementation
	5	*
	6	* Copyright (C) 2003-2006 Christophe Devine
	7	*
	8	* SPDX-License-Identifier: LGPL-2.1
	9	*/
	10	/*
	11	* The SHA-1 standard was published by NIST in 1993.
	12	*
	13	* http://www.itl.nist.gov/fipspubs/fip180-1.htm
	14	*/
	15	#ifndef _SHA1_H
	16	#define _SHA1_H
	17
	18	#ifdef __cplusplus
	19	extern "C" {
	20	#endif
	21
	22	#define SHA1_SUM_POS -0x20
	23	#define SHA1_SUM_LEN 20
	24	#define SHA1_DER_LEN 15
	25
	26	extern const uint8_t sha1_der_prefix[];
	27
	28	/**
	29	* \brief SHA-1 context structure
	30	*/
	31	typedef struct
	32	{
	33	unsigned long total[2]; /!< number of bytes processed /
	34	unsigned long state[5]; /!< intermediate digest state /
	35	unsigned char buffer[64]; /!< data block being processed /
	36	}
	37	sha1_context;
	38
	39	/**
	40	* \brief SHA-1 context setup
	41	*
	42	* \param ctx SHA-1 context to be initialized
	43	*/
	44	void sha1_starts( sha1_context *ctx );
	45
	46	/**
	47	* \brief SHA-1 process buffer
	48	*
	49	* \param ctx SHA-1 context
	50	* \param input buffer holding the data
	51	* \param ilen length of the input data
	52	*/
	53	void sha1_update(sha1_context ctx, const unsigned char input,
	54	unsigned int ilen);
	55
	56	/**
	57	* \brief SHA-1 final digest
	58	*
	59	* \param ctx SHA-1 context
	60	* \param output SHA-1 checksum result
	61	*/
	62	void sha1_finish( sha1_context *ctx, unsigned char output[20] );
	63
	64	/**
	65	* \brief Output = SHA-1( input buffer )
	66	*
	67	* \param input buffer holding the data
	68	* \param ilen length of the input data
	69	* \param output SHA-1 checksum result
	70	*/
	71	void sha1_csum(const unsigned char *input, unsigned int ilen,
	72	unsigned char *output);
	73
	74	/**
	75	* \brief Output = SHA-1( input buffer ), with watchdog triggering
	76	*
	77	* \param input buffer holding the data
	78	* \param ilen length of the input data
	79	* \param output SHA-1 checksum result
	80	* \param chunk_sz watchdog triggering period (in bytes of input processed)
	81	*/
	82	void sha1_csum_wd(const unsigned char *input, unsigned int ilen,
	83	unsigned char *output, unsigned int chunk_sz);
	84
	85	/**
	86	* \brief Output = HMAC-SHA-1( input buffer, hmac key )
	87	*
	88	* \param key HMAC secret key
	89	* \param keylen length of the HMAC key
	90	* \param input buffer holding the data
	91	* \param ilen length of the input data
	92	* \param output HMAC-SHA-1 result
	93	*/
	94	void sha1_hmac(const unsigned char *key, int keylen,
	95	const unsigned char *input, unsigned int ilen,
	96	unsigned char *output);
	97
	98	/**
	99	* \brief Checkup routine
	100	*
	101	* \return 0 if successful, or 1 if the test failed
	102	*/
	103	int sha1_self_test( void );
	104
	105	#ifdef __cplusplus
	106	}
	107	#endif
	108
	109	#endif /* sha1.h */