sha2.h

   1 /*      $OpenBSD: sha2.h,v 1.8 2012/12/05 23:19:57 deraadt Exp $        */
   2
   3 /*
   4  * FILE:        sha2.h
   5  * AUTHOR:      Aaron D. Gifford <me@aarongifford.com>
   6  *
   7  * Copyright (c) 2000-2001, Aaron D. Gifford
   8  * All rights reserved.
   9  *
  10  * Redistribution and use in source and binary forms, with or without
  11  * modification, are permitted provided that the following conditions
  12  * are met:
  13  * 1. Redistributions of source code must retain the above copyright
  14  *    notice, this list of conditions and the following disclaimer.
  15  * 2. Redistributions in binary form must reproduce the above copyright
  16  *    notice, this list of conditions and the following disclaimer in the
  17  *    documentation and/or other materials provided with the distribution.
  18  * 3. Neither the name of the copyright holder nor the names of contributors
  19  *    may be used to endorse or promote products derived from this software
  20  *    without specific prior written permission.
  21  *
  22  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTOR(S) ``AS IS'' AND
  23  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  25  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTOR(S) BE LIABLE
  26  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  28  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  29  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  30  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  31  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  32  * SUCH DAMAGE.
  33  *
  34  * $From: sha2.h,v 1.1 2001/11/08 00:02:01 adg Exp adg $
  35  */
  36
  37 #ifndef _SHA2_H
  38 #define _SHA2_H
  39
  40 /* Additions for setup */
  41 #define u_int8_t        __UINT8_TYPE__
  42 #define u_int32_t       __UINT32_TYPE__
  43 #define u_int64_t       __UINT64_TYPE__
  44 #define SHA2_SMALL
  45 #define explicit_bzero(a,b)     (memset((a),0,(b)))
  46 #include <sys/cdefs.h>
  47 #include <sys/param.h>
  48 /* End additions for setup */
  49
  50 /*** SHA-256/384/512 Various Length Definitions ***********************/
  51 #define SHA256_BLOCK_LENGTH             64
  52 #define SHA256_DIGEST_LENGTH            32
  53 #define SHA256_DIGEST_STRING_LENGTH     (SHA256_DIGEST_LENGTH * 2 + 1)
  54 #define SHA384_BLOCK_LENGTH             128
  55 #define SHA384_DIGEST_LENGTH            48
  56 #define SHA384_DIGEST_STRING_LENGTH     (SHA384_DIGEST_LENGTH * 2 + 1)
  57 #define SHA512_BLOCK_LENGTH             128
  58 #define SHA512_DIGEST_LENGTH            64
  59 #define SHA512_DIGEST_STRING_LENGTH     (SHA512_DIGEST_LENGTH * 2 + 1)
  60
  61
  62 /*** SHA-256/384/512 Context Structure *******************************/
  63 typedef struct _SHA2_CTX {
  64         union {
  65                 u_int32_t       st32[8];
  66                 u_int64_t       st64[8];
  67         } state;
  68         u_int64_t       bitcount[2];
  69         u_int8_t        buffer[SHA512_BLOCK_LENGTH];
  70 } SHA2_CTX;
  71
  72 __BEGIN_DECLS
  73 void SHA256Init(SHA2_CTX *);
  74 void SHA256Transform(u_int32_t state[8], const u_int8_t [SHA256_BLOCK_LENGTH]);
  75 void SHA256Update(SHA2_CTX *, const u_int8_t *, size_t)
  76         __attribute__((__bounded__(__string__,2,3)));
  77 void SHA256Pad(SHA2_CTX *);
  78 void SHA256Final(u_int8_t [SHA256_DIGEST_LENGTH], SHA2_CTX *)
  79         __attribute__((__bounded__(__minbytes__,1,SHA256_DIGEST_LENGTH)));
  80 char *SHA256End(SHA2_CTX *, char *)
  81         __attribute__((__bounded__(__minbytes__,2,SHA256_DIGEST_STRING_LENGTH)));
  82 char *SHA256File(const char *, char *)
  83         __attribute__((__bounded__(__minbytes__,2,SHA256_DIGEST_STRING_LENGTH)));
  84 char *SHA256FileChunk(const char *, char *, off_t, off_t)
  85         __attribute__((__bounded__(__minbytes__,2,SHA256_DIGEST_STRING_LENGTH)));
  86 char *SHA256Data(const u_int8_t *, size_t, char *)
  87         __attribute__((__bounded__(__string__,1,2)))
  88         __attribute__((__bounded__(__minbytes__,3,SHA256_DIGEST_STRING_LENGTH)));
  89
  90 void SHA384Init(SHA2_CTX *);
  91 void SHA384Transform(u_int64_t state[8], const u_int8_t [SHA384_BLOCK_LENGTH]);
  92 void SHA384Update(SHA2_CTX *, const u_int8_t *, size_t)
  93         __attribute__((__bounded__(__string__,2,3)));
  94 void SHA384Pad(SHA2_CTX *);
  95 void SHA384Final(u_int8_t [SHA384_DIGEST_LENGTH], SHA2_CTX *)
  96         __attribute__((__bounded__(__minbytes__,1,SHA384_DIGEST_LENGTH)));
  97 char *SHA384End(SHA2_CTX *, char *)
  98         __attribute__((__bounded__(__minbytes__,2,SHA384_DIGEST_STRING_LENGTH)));
  99 char *SHA384File(const char *, char *)
 100         __attribute__((__bounded__(__minbytes__,2,SHA384_DIGEST_STRING_LENGTH)));
 101 char *SHA384FileChunk(const char *, char *, off_t, off_t)
 102         __attribute__((__bounded__(__minbytes__,2,SHA384_DIGEST_STRING_LENGTH)));
 103 char *SHA384Data(const u_int8_t *, size_t, char *)
 104         __attribute__((__bounded__(__string__,1,2)))
 105         __attribute__((__bounded__(__minbytes__,3,SHA384_DIGEST_STRING_LENGTH)));
 106
 107 void SHA512Init(SHA2_CTX *);
 108 void SHA512Transform(u_int64_t state[8], const u_int8_t [SHA512_BLOCK_LENGTH]);
 109 void SHA512Update(SHA2_CTX *, const u_int8_t *, size_t)
 110         __attribute__((__bounded__(__string__,2,3)));
 111 void SHA512Pad(SHA2_CTX *);
 112 void SHA512Final(u_int8_t [SHA512_DIGEST_LENGTH], SHA2_CTX *)
 113         __attribute__((__bounded__(__minbytes__,1,SHA512_DIGEST_LENGTH)));
 114 char *SHA512End(SHA2_CTX *, char *)
 115         __attribute__((__bounded__(__minbytes__,2,SHA512_DIGEST_STRING_LENGTH)));
 116 char *SHA512File(const char *, char *)
 117         __attribute__((__bounded__(__minbytes__,2,SHA512_DIGEST_STRING_LENGTH)));
 118 char *SHA512FileChunk(const char *, char *, off_t, off_t)
 119         __attribute__((__bounded__(__minbytes__,2,SHA512_DIGEST_STRING_LENGTH)));
 120 char *SHA512Data(const u_int8_t *, size_t, char *)
 121         __attribute__((__bounded__(__string__,1,2)))
 122         __attribute__((__bounded__(__minbytes__,3,SHA512_DIGEST_STRING_LENGTH)));
 123 __END_DECLS
 124
 125 #endif /* _SHA2_H */