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