xref: /illumos-gate/usr/src/uts/common/sys/sha2.h (revision 45818ee1)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 /*
22  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
23  * Use is subject to license terms.
24  */
25 /* Copyright 2013 Saso Kiselkov.  All rights reserved. */
26 
27 #ifndef _SYS_SHA2_H
28 #define	_SYS_SHA2_H
29 
30 #include <sys/types.h>		/* for uint_* */
31 
32 #ifdef	__cplusplus
33 extern "C" {
34 #endif
35 
36 #define	SHA2_HMAC_MIN_KEY_LEN	1	/* SHA2-HMAC min key length in bytes */
37 #define	SHA2_HMAC_MAX_KEY_LEN	INT_MAX	/* SHA2-HMAC max key length in bytes */
38 
39 #define	SHA256_DIGEST_LENGTH	32	/* SHA256 digest length in bytes */
40 #define	SHA384_DIGEST_LENGTH	48	/* SHA384 digest length in bytes */
41 #define	SHA512_DIGEST_LENGTH	64	/* SHA512 digest length in bytes */
42 
43 /* Truncated versions of SHA-512 according to FIPS-180-4, section 5.3.6 */
44 #define	SHA512_224_DIGEST_LENGTH	28	/* SHA512/224 digest length */
45 #define	SHA512_256_DIGEST_LENGTH	32	/* SHA512/256 digest length */
46 
47 #define	SHA256_HMAC_BLOCK_SIZE	64	/* SHA256-HMAC block size */
48 #define	SHA512_HMAC_BLOCK_SIZE	128	/* SHA512-HMAC block size */
49 
50 #define	SHA256			0
51 #define	SHA256_HMAC		1
52 #define	SHA256_HMAC_GEN		2
53 #define	SHA384			3
54 #define	SHA384_HMAC		4
55 #define	SHA384_HMAC_GEN		5
56 #define	SHA512			6
57 #define	SHA512_HMAC		7
58 #define	SHA512_HMAC_GEN		8
59 #define	SHA512_224		9
60 #define	SHA512_256		10
61 
62 /*
63  * SHA2 context.
64  * The contents of this structure are a private interface between the
65  * Init/Update/Final calls of the functions defined below.
66  * Callers must never attempt to read or write any of the fields
67  * in this structure directly.
68  */
69 typedef struct 	{
70 	uint32_t algotype;		/* Algorithm Type */
71 
72 	/* state (ABCDEFGH) */
73 	union {
74 		uint32_t s32[8];	/* for SHA256 */
75 		uint64_t s64[8];	/* for SHA384/512 */
76 	} state;
77 	/* number of bits */
78 	union {
79 		uint32_t c32[2];	/* for SHA256 , modulo 2^64 */
80 		uint64_t c64[2];	/* for SHA384/512, modulo 2^128 */
81 	} count;
82 	union {
83 		uint8_t		buf8[128];	/* undigested input */
84 		uint32_t	buf32[32];	/* realigned input */
85 		uint64_t	buf64[16];	/* realigned input */
86 	} buf_un;
87 } SHA2_CTX;
88 
89 typedef SHA2_CTX SHA256_CTX;
90 typedef SHA2_CTX SHA384_CTX;
91 typedef SHA2_CTX SHA512_CTX;
92 
93 extern void SHA2Init(uint64_t mech, SHA2_CTX *);
94 
95 extern void SHA2Update(SHA2_CTX *, const void *, size_t);
96 
97 extern void SHA2Final(void *, SHA2_CTX *);
98 
99 extern void SHA256Init(SHA256_CTX *);
100 
101 extern void SHA256Update(SHA256_CTX *, const void *, size_t);
102 
103 extern void SHA256Final(void *, SHA256_CTX *);
104 
105 extern void SHA384Init(SHA384_CTX *);
106 
107 extern void SHA384Update(SHA384_CTX *, const void *, size_t);
108 
109 extern void SHA384Final(void *, SHA384_CTX *);
110 
111 extern void SHA512Init(SHA512_CTX *);
112 
113 extern void SHA512Update(SHA512_CTX *, const void *, size_t);
114 
115 extern void SHA512Final(void *, SHA512_CTX *);
116 
117 #ifdef _SHA2_IMPL
118 /*
119  * The following types/functions are all private to the implementation
120  * of the SHA2 functions and must not be used by consumers of the interface
121  */
122 
123 /*
124  * List of support mechanisms in this module.
125  *
126  * It is important to note that in the module, division or modulus calculations
127  * are used on the enumerated type to determine which mechanism is being used;
128  * therefore, changing the order or additional mechanisms should be done
129  * carefully
130  */
131 typedef enum sha2_mech_type {
132 	SHA256_MECH_INFO_TYPE,		/* SUN_CKM_SHA256 */
133 	SHA256_HMAC_MECH_INFO_TYPE,	/* SUN_CKM_SHA256_HMAC */
134 	SHA256_HMAC_GEN_MECH_INFO_TYPE,	/* SUN_CKM_SHA256_HMAC_GENERAL */
135 	SHA384_MECH_INFO_TYPE,		/* SUN_CKM_SHA384 */
136 	SHA384_HMAC_MECH_INFO_TYPE,	/* SUN_CKM_SHA384_HMAC */
137 	SHA384_HMAC_GEN_MECH_INFO_TYPE,	/* SUN_CKM_SHA384_HMAC_GENERAL */
138 	SHA512_MECH_INFO_TYPE,		/* SUN_CKM_SHA512 */
139 	SHA512_HMAC_MECH_INFO_TYPE,	/* SUN_CKM_SHA512_HMAC */
140 	SHA512_HMAC_GEN_MECH_INFO_TYPE,	/* SUN_CKM_SHA512_HMAC_GENERAL */
141 	SHA512_224_MECH_INFO_TYPE,	/* SUN_CKM_SHA512_224 */
142 	SHA512_256_MECH_INFO_TYPE	/* SUN_CKM_SHA512_256 */
143 } sha2_mech_type_t;
144 
145 #endif /* _SHA2_IMPL */
146 
147 #ifdef	__cplusplus
148 }
149 #endif
150 
151 #endif /* _SYS_SHA2_H */
152