ucw/sha1.h

   1 /*
   2  *      SHA-1 Hash Function (FIPS 180-1, RFC 3174)
   3  *
   4  *      (c) 2008--2009 Martin Mares <mj@ucw.cz>
   5  *
   6  *      Based on the code from libgcrypt-1.2.3, which was:
   7  *
   8  *      Copyright (C) 1998, 2001, 2002, 2003 Free Software Foundation, Inc.
   9  *
  10  *      This software may be freely distributed and used according to the terms
  11  *      of the GNU Lesser General Public License.
  12  */
  13
  14 #ifndef _UCW_SHA1_H
  15 #define _UCW_SHA1_H
  16
  17 #ifdef CONFIG_UCW_CLEAN_ABI
  18 #define sha1_final ucw_sha1_final
  19 #define sha1_hash_buffer ucw_sha1_hash_buffer
  20 #define sha1_hmac ucw_sha1_hmac
  21 #define sha1_hmac_final ucw_sha1_hmac_final
  22 #define sha1_hmac_init ucw_sha1_hmac_init
  23 #define sha1_hmac_update ucw_sha1_hmac_update
  24 #define sha1_init ucw_sha1_init
  25 #define sha1_update ucw_sha1_update
  26 #endif
  27
  28 /**
  29  * Internal SHA1 state.
  30  * You should use it just as an opaque handle only.
  31  */
  32 typedef struct {
  33   u32 h0,h1,h2,h3,h4;
  34   u32 nblocks;
  35   byte buf[64];
  36   int count;
  37 } sha1_context;
  38
  39 void sha1_init(sha1_context *hd); /** Initialize new algorithm run in the @hd context. **/
  40 /**
  41  * Push another @inlen bytes of data pointed to by @inbuf onto the
  42  * SHA1 hash currently in @hd. You can call this any times you want on
  43  * the same hash (and you do not need to reinitialize it by
  44  * @sha1_init()). It has the same effect as concatenating all the data
  45  * together and passing them at once.
  46  */
  47 void sha1_update(sha1_context *hd, const byte *inbuf, uns inlen);
  48 /**
  49  * No more @sha1_update() calls will be done. This terminates the hash
  50  * and returns a pointer to it.
  51  *
  52  * Note that the pointer points into data in the @hd context. If it ceases
  53  * to exist, the pointer becomes invalid.
  54  *
  55  * To convert the hash to its usual hexadecimal representation, see
  56  * <<string:mem_to_hex()>>.
  57  */
  58 byte *sha1_final(sha1_context *hd);
  59
  60 /**
  61  * A convenience one-shot function for SHA1 hash.
  62  * It is equivalent to this snippet of code:
  63  *
  64  *  sha1_context hd;
  65  *  sha1_init(&hd);
  66  *  sha1_update(&hd, buffer, length);
  67  *  memcpy(outbuf, sha1_final(&hd), SHA1_SIZE);
  68  */
  69 void sha1_hash_buffer(byte *outbuf, const byte *buffer, uns length);
  70
  71 /**
  72  * SHA1 HMAC message authentication. If you provide @key and @data,
  73  * the result will be stored in @outbuf.
  74  */
  75 void sha1_hmac(byte *outbuf, const byte *key, uns keylen, const byte *data, uns datalen);
  76
  77 /**
  78  * The HMAC also exists in a stream version in a way analogous to the
  79  * plain SHA1. Pass this as a context.
  80  */
  81 typedef struct {
  82   sha1_context ictx;
  83   sha1_context octx;
  84 } sha1_hmac_context;
  85
  86 void sha1_hmac_init(sha1_hmac_context *hd, const byte *key, uns keylen);        /** Initialize HMAC with context @hd and the given key. See sha1_init(). */
  87 void sha1_hmac_update(sha1_hmac_context *hd, const byte *data, uns datalen);    /** Hash another @datalen bytes of data. See sha1_update(). */
  88 byte *sha1_hmac_final(sha1_hmac_context *hd);                                   /** Terminate the HMAC and return a pointer to the allocated hash. See sha1_final(). */
  89
  90 #define SHA1_SIZE 20 /** Size of the SHA1 hash in its binary representation **/
  91 #define SHA1_HEX_SIZE 41 /** Buffer length for a string containing SHA1 in hexadecimal format. **/
  92 #define SHA1_BLOCK_SIZE 64 /** SHA1 splits input to blocks of this size. **/
  93
  94 #endif