1/* $OpenBSD: sha2.h,v 1.10 2016/09/03 17:00:29 tedu 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
41/*** SHA-256/384/512 Various Length Definitions ***********************/
42#define SHA224_BLOCK_LENGTH 64
43#define SHA224_DIGEST_LENGTH 28
44#define SHA224_DIGEST_STRING_LENGTH (SHA224_DIGEST_LENGTH * 2 + 1)
45#define SHA256_BLOCK_LENGTH 64
46#define SHA256_DIGEST_LENGTH 32
47#define SHA256_DIGEST_STRING_LENGTH (SHA256_DIGEST_LENGTH * 2 + 1)
48#define SHA384_BLOCK_LENGTH 128
49#define SHA384_DIGEST_LENGTH 48
50#define SHA384_DIGEST_STRING_LENGTH (SHA384_DIGEST_LENGTH * 2 + 1)
51#define SHA512_BLOCK_LENGTH 128
52#define SHA512_DIGEST_LENGTH 64
53#define SHA512_DIGEST_STRING_LENGTH (SHA512_DIGEST_LENGTH * 2 + 1)
54#define SHA512_256_BLOCK_LENGTH 128
55#define SHA512_256_DIGEST_LENGTH 32
56#define SHA512_256_DIGEST_STRING_LENGTH (SHA512_256_DIGEST_LENGTH * 2 + 1)
57
58
59/*** SHA-224/256/384/512 Context Structure *******************************/
60typedef struct _SHA2_CTX {
61 union {
62 u_int32_t st32[8];
63 u_int64_t st64[8];
64 } state;
65 u_int64_t bitcount[2];
66 u_int8_t buffer[SHA512_BLOCK_LENGTH];
67} SHA2_CTX;
68
69__BEGIN_DECLS
70void SHA224Init(SHA2_CTX *);
71void SHA224Transform(u_int32_t state[8], const u_int8_t [SHA224_BLOCK_LENGTH]);
72void SHA224Update(SHA2_CTX *, const u_int8_t *, size_t)
73 __attribute__((__bounded__(__string__,2,3)));
74void SHA224Pad(SHA2_CTX *);
75void SHA224Final(u_int8_t [SHA224_DIGEST_LENGTH], SHA2_CTX *)
76 __attribute__((__bounded__(__minbytes__,1,SHA224_DIGEST_LENGTH)));
77char *SHA224End(SHA2_CTX *, char *)
78 __attribute__((__bounded__(__minbytes__,2,SHA224_DIGEST_STRING_LENGTH)));
79char *SHA224File(const char *, char *)
80 __attribute__((__bounded__(__minbytes__,2,SHA224_DIGEST_STRING_LENGTH)));
81char *SHA224FileChunk(const char *, char *, off_t, off_t)
82 __attribute__((__bounded__(__minbytes__,2,SHA224_DIGEST_STRING_LENGTH)));
83char *SHA224Data(const u_int8_t *, size_t, char *)
84 __attribute__((__bounded__(__string__,1,2)))
85 __attribute__((__bounded__(__minbytes__,3,SHA224_DIGEST_STRING_LENGTH)));
86
87void SHA256Init(SHA2_CTX *);
88void SHA256Transform(u_int32_t state[8], const u_int8_t [SHA256_BLOCK_LENGTH]);
89void SHA256Update(SHA2_CTX *, const u_int8_t *, size_t)
90 __attribute__((__bounded__(__string__,2,3)));
91void SHA256Pad(SHA2_CTX *);
92void SHA256Final(u_int8_t [SHA256_DIGEST_LENGTH], SHA2_CTX *)
93 __attribute__((__bounded__(__minbytes__,1,SHA256_DIGEST_LENGTH)));
94char *SHA256End(SHA2_CTX *, char *)
95 __attribute__((__bounded__(__minbytes__,2,SHA256_DIGEST_STRING_LENGTH)));
96char *SHA256File(const char *, char *)
97 __attribute__((__bounded__(__minbytes__,2,SHA256_DIGEST_STRING_LENGTH)));
98char *SHA256FileChunk(const char *, char *, off_t, off_t)
99 __attribute__((__bounded__(__minbytes__,2,SHA256_DIGEST_STRING_LENGTH)));
100char *SHA256Data(const u_int8_t *, size_t, char *)
101 __attribute__((__bounded__(__string__,1,2)))
102 __attribute__((__bounded__(__minbytes__,3,SHA256_DIGEST_STRING_LENGTH)));
103
104void SHA384Init(SHA2_CTX *);
105void SHA384Transform(u_int64_t state[8], const u_int8_t [SHA384_BLOCK_LENGTH]);
106void SHA384Update(SHA2_CTX *, const u_int8_t *, size_t)
107 __attribute__((__bounded__(__string__,2,3)));
108void SHA384Pad(SHA2_CTX *);
109void SHA384Final(u_int8_t [SHA384_DIGEST_LENGTH], SHA2_CTX *)
110 __attribute__((__bounded__(__minbytes__,1,SHA384_DIGEST_LENGTH)));
111char *SHA384End(SHA2_CTX *, char *)
112 __attribute__((__bounded__(__minbytes__,2,SHA384_DIGEST_STRING_LENGTH)));
113char *SHA384File(const char *, char *)
114 __attribute__((__bounded__(__minbytes__,2,SHA384_DIGEST_STRING_LENGTH)));
115char *SHA384FileChunk(const char *, char *, off_t, off_t)
116 __attribute__((__bounded__(__minbytes__,2,SHA384_DIGEST_STRING_LENGTH)));
117char *SHA384Data(const u_int8_t *, size_t, char *)
118 __attribute__((__bounded__(__string__,1,2)))
119 __attribute__((__bounded__(__minbytes__,3,SHA384_DIGEST_STRING_LENGTH)));
120
121void SHA512Init(SHA2_CTX *);
122void SHA512Transform(u_int64_t state[8], const u_int8_t [SHA512_BLOCK_LENGTH]);
123void SHA512Update(SHA2_CTX *, const u_int8_t *, size_t)
124 __attribute__((__bounded__(__string__,2,3)));
125void SHA512Pad(SHA2_CTX *);
126void SHA512Final(u_int8_t [SHA512_DIGEST_LENGTH], SHA2_CTX *)
127 __attribute__((__bounded__(__minbytes__,1,SHA512_DIGEST_LENGTH)));
128char *SHA512End(SHA2_CTX *, char *)
129 __attribute__((__bounded__(__minbytes__,2,SHA512_DIGEST_STRING_LENGTH)));
130char *SHA512File(const char *, char *)
131 __attribute__((__bounded__(__minbytes__,2,SHA512_DIGEST_STRING_LENGTH)));
132char *SHA512FileChunk(const char *, char *, off_t, off_t)
133 __attribute__((__bounded__(__minbytes__,2,SHA512_DIGEST_STRING_LENGTH)));
134char *SHA512Data(const u_int8_t *, size_t, char *)
135 __attribute__((__bounded__(__string__,1,2)))
136 __attribute__((__bounded__(__minbytes__,3,SHA512_DIGEST_STRING_LENGTH)));
137
138void SHA512_256Init(SHA2_CTX *);
139void SHA512_256Transform(u_int64_t state[8], const u_int8_t [SHA512_256_BLOCK_LENGTH]);
140void SHA512_256Update(SHA2_CTX *, const u_int8_t *, size_t)
141 __attribute__((__bounded__(__string__,2,3)));
142void SHA512_256Pad(SHA2_CTX *);
143void SHA512_256Final(u_int8_t [SHA512_256_DIGEST_LENGTH], SHA2_CTX *)
144 __attribute__((__bounded__(__minbytes__,1,SHA512_256_DIGEST_LENGTH)));
145char *SHA512_256End(SHA2_CTX *, char *)
146 __attribute__((__bounded__(__minbytes__,2,SHA512_256_DIGEST_STRING_LENGTH)));
147char *SHA512_256File(const char *, char *)
148 __attribute__((__bounded__(__minbytes__,2,SHA512_256_DIGEST_STRING_LENGTH)));
149char *SHA512_256FileChunk(const char *, char *, off_t, off_t)
150 __attribute__((__bounded__(__minbytes__,2,SHA512_256_DIGEST_STRING_LENGTH)));
151char *SHA512_256Data(const u_int8_t *, size_t, char *)
152 __attribute__((__bounded__(__string__,1,2)))
153 __attribute__((__bounded__(__minbytes__,3,SHA512_256_DIGEST_STRING_LENGTH)));
154__END_DECLS
155
156#endif /* _SHA2_H */