1 /*	$MirOS: src/include/sha2.h,v 1.4 2014/03/05 20:12:51 tg Exp $ */
2 /*	$OpenBSD: sha2.h,v 1.6 2004/06/22 01:57:30 jfb Exp $	*/
3 
4 /*
5  * FILE:	sha2.h
6  * AUTHOR:	Aaron D. Gifford <me@aarongifford.com>
7  *
8  * Copyright © 2013
9  *	Thorsten “mirabilos” Glaser <tg@mirbsd.org>
10  * Copyright (c) 2000-2001, Aaron D. Gifford
11  * All rights reserved.
12  *
13  * Redistribution and use in source and binary forms, with or without
14  * modification, are permitted provided that the following conditions
15  * are met:
16  * 1. Redistributions of source code must retain the above copyright
17  *    notice, this list of conditions and the following disclaimer.
18  * 2. Redistributions in binary form must reproduce the above copyright
19  *    notice, this list of conditions and the following disclaimer in the
20  *    documentation and/or other materials provided with the distribution.
21  * 3. Neither the name of the copyright holder nor the names of contributors
22  *    may be used to endorse or promote products derived from this software
23  *    without specific prior written permission.
24  *
25  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTOR(S) ``AS IS'' AND
26  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTOR(S) BE LIABLE
29  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35  * SUCH DAMAGE.
36  *
37  * $From: sha2.h,v 1.1 2001/11/08 00:02:01 adg Exp adg $
38  */
39 
40 #ifndef _SHA2_H
41 #define _SHA2_H
42 
43 
44 /*** SHA-256/384/512 Various Length Definitions ***********************/
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 
55 
56 /*** SHA-256/384/512 Context Structures *******************************/
57 typedef struct _SHA256_CTX {
58 	u_int32_t	state[8];
59 	u_int64_t	bitcount;
60 	u_int8_t	buffer[SHA256_BLOCK_LENGTH];
61 } SHA256_CTX;
62 typedef struct _SHA512_CTX {
63 	u_int64_t	state[8];
64 	u_int64_t	bitcount[2];
65 	u_int8_t	buffer[SHA512_BLOCK_LENGTH];
66 } SHA512_CTX;
67 
68 typedef SHA512_CTX SHA384_CTX;
69 
70 #include <sys/cdefs.h>
71 
72 __BEGIN_DECLS
73 void SHA256_Init(SHA256_CTX *);
74 void SHA256_Transform(u_int32_t *, const u_int8_t *)
75 	__attribute__((__bounded__(__minbytes__, 1, 32)))
76 	__attribute__((__bounded__(__minbytes__, 2, SHA256_BLOCK_LENGTH)));
77 void SHA256_Update(SHA256_CTX *, const u_int8_t *, size_t)
78 	__attribute__((__bounded__(__string__, 2, 3)));
79 void SHA256_Pad(SHA256_CTX *);
80 void SHA256_Final(u_int8_t *, SHA256_CTX *)
81 	__attribute__((__bounded__(__minbytes__, 1, SHA256_DIGEST_LENGTH)));
82 char *SHA256_End(SHA256_CTX *, char *)
83 	__attribute__((__bounded__(__minbytes__, 2, SHA256_DIGEST_STRING_LENGTH)));
84 char *SHA256_File(const char *, char *)
85 	__attribute__((__bounded__(__minbytes__, 2, SHA256_DIGEST_STRING_LENGTH)));
86 char *SHA256_FileChunk(const char *, char *, off_t, off_t)
87 	__attribute__((__bounded__(__minbytes__, 2, SHA256_DIGEST_STRING_LENGTH)));
88 char *SHA256_Data(const u_int8_t *, size_t, char *)
89 	__attribute__((__bounded__(__string__, 1, 2)))
90 	__attribute__((__bounded__(__minbytes__, 3, SHA256_DIGEST_STRING_LENGTH)));
91 
92 void SHA384_Init(SHA384_CTX *);
93 void SHA384_Transform(u_int64_t *, const u_int8_t *)
94 	__attribute__((__bounded__(__minbytes__, 1, 64)))
95 	__attribute__((__bounded__(__minbytes__, 2, SHA384_BLOCK_LENGTH)));
96 void SHA384_Update(SHA384_CTX *, const u_int8_t *, size_t)
97 	__attribute__((__bounded__(__string__, 2, 3)));
98 void SHA384_Pad(SHA384_CTX *);
99 void SHA384_Final(u_int8_t *, SHA384_CTX *)
100 	__attribute__((__bounded__(__minbytes__, 1, SHA384_DIGEST_LENGTH)));
101 char *SHA384_End(SHA384_CTX *, char *)
102 	__attribute__((__bounded__(__minbytes__, 2, SHA384_DIGEST_STRING_LENGTH)));
103 char *SHA384_File(const char *, char *)
104 	__attribute__((__bounded__(__minbytes__, 2, SHA384_DIGEST_STRING_LENGTH)));
105 char *SHA384_FileChunk(const char *, char *, off_t, off_t)
106 	__attribute__((__bounded__(__minbytes__, 2, SHA384_DIGEST_STRING_LENGTH)));
107 char *SHA384_Data(const u_int8_t *, size_t, char *)
108 	__attribute__((__bounded__(__string__, 1, 2)))
109 	__attribute__((__bounded__(__minbytes__, 3, SHA384_DIGEST_STRING_LENGTH)));
110 
111 void SHA512_Init(SHA512_CTX *);
112 void SHA512_Transform(u_int64_t *, const u_int8_t *)
113 	__attribute__((__bounded__(__minbytes__, 1, 64)))
114 	__attribute__((__bounded__(__minbytes__, 2, SHA512_BLOCK_LENGTH)));
115 void SHA512_Update(SHA512_CTX *, const u_int8_t *, size_t)
116 	__attribute__((__bounded__(__string__, 2, 3)));
117 void SHA512_Pad(SHA512_CTX *);
118 void SHA512_Final(u_int8_t *, SHA512_CTX *)
119 	__attribute__((__bounded__(__minbytes__, 1, SHA512_DIGEST_LENGTH)));
120 char *SHA512_End(SHA512_CTX *, char *)
121 	__attribute__((__bounded__(__minbytes__, 2, SHA512_DIGEST_STRING_LENGTH)));
122 char *SHA512_File(const char *, char *)
123 	__attribute__((__bounded__(__minbytes__, 2, SHA512_DIGEST_STRING_LENGTH)));
124 char *SHA512_FileChunk(const char *, char *, off_t, off_t)
125 	__attribute__((__bounded__(__minbytes__, 2, SHA512_DIGEST_STRING_LENGTH)));
126 char *SHA512_Data(const u_int8_t *, size_t, char *)
127 	__attribute__((__bounded__(__string__, 1, 2)))
128 	__attribute__((__bounded__(__minbytes__, 3, SHA512_DIGEST_STRING_LENGTH)));
129 __END_DECLS
130 
131 #endif /* _SHA2_H */
132