include/u-boot/sha1.h

   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 */