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.
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.
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]
22 * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
23 * Use is subject to license terms.
29 #include <sys/types.h> /* for uint_* */
35 #define SHA2_HMAC_MIN_KEY_LEN 1 /* SHA2-HMAC min key length in bytes */
36 #define SHA2_HMAC_MAX_KEY_LEN INT_MAX /* SHA2-HMAC max key length in bytes */
38 #define SHA256_DIGEST_LENGTH 32 /* SHA256 digest length in bytes */
39 #define SHA384_DIGEST_LENGTH 48 /* SHA384 digest length in bytes */
40 #define SHA512_DIGEST_LENGTH 64 /* SHA512 digest length in bytes */
42 #define SHA256_HMAC_BLOCK_SIZE 64 /* SHA256-HMAC block size */
43 #define SHA512_HMAC_BLOCK_SIZE 128 /* SHA512-HMAC block size */
47 #define SHA256_HMAC_GEN 2
50 #define SHA384_HMAC_GEN 5
53 #define SHA512_HMAC_GEN 8
57 * The contents of this structure are a private interface between the
58 * Init/Update/Final calls of the functions defined below.
59 * Callers must never attempt to read or write any of the fields
60 * in this structure directly.
63 uint32_t algotype
; /* Algorithm Type */
65 /* state (ABCDEFGH) */
67 uint32_t s32
[8]; /* for SHA256 */
68 uint64_t s64
[8]; /* for SHA384/512 */
72 uint32_t c32
[2]; /* for SHA256 , modulo 2^64 */
73 uint64_t c64
[2]; /* for SHA384/512, modulo 2^128 */
76 uint8_t buf8
[128]; /* undigested input */
77 uint32_t buf32
[32]; /* realigned input */
78 uint64_t buf64
[16]; /* realigned input */
82 typedef SHA2_CTX SHA256_CTX
;
83 typedef SHA2_CTX SHA384_CTX
;
84 typedef SHA2_CTX SHA512_CTX
;
86 extern void SHA2Init(uint64_t mech
, SHA2_CTX
*);
88 extern void SHA2Update(SHA2_CTX
*, const void *, size_t);
90 extern void SHA2Final(void *, SHA2_CTX
*);
92 extern void SHA256Init(SHA256_CTX
*);
94 extern void SHA256Update(SHA256_CTX
*, const void *, size_t);
96 extern void SHA256Final(void *, SHA256_CTX
*);
98 extern void SHA384Init(SHA384_CTX
*);
100 extern void SHA384Update(SHA384_CTX
*, const void *, size_t);
102 extern void SHA384Final(void *, SHA384_CTX
*);
104 extern void SHA512Init(SHA512_CTX
*);
106 extern void SHA512Update(SHA512_CTX
*, const void *, size_t);
108 extern void SHA512Final(void *, SHA512_CTX
*);
112 * The following types/functions are all private to the implementation
113 * of the SHA2 functions and must not be used by consumers of the interface
117 * List of support mechanisms in this module.
119 * It is important to note that in the module, division or modulus calculations
120 * are used on the enumerated type to determine which mechanism is being used;
121 * therefore, changing the order or additional mechanisms should be done
124 typedef enum sha2_mech_type
{
125 SHA256_MECH_INFO_TYPE
, /* SUN_CKM_SHA256 */
126 SHA256_HMAC_MECH_INFO_TYPE
, /* SUN_CKM_SHA256_HMAC */
127 SHA256_HMAC_GEN_MECH_INFO_TYPE
, /* SUN_CKM_SHA256_HMAC_GENERAL */
128 SHA384_MECH_INFO_TYPE
, /* SUN_CKM_SHA384 */
129 SHA384_HMAC_MECH_INFO_TYPE
, /* SUN_CKM_SHA384_HMAC */
130 SHA384_HMAC_GEN_MECH_INFO_TYPE
, /* SUN_CKM_SHA384_HMAC_GENERAL */
131 SHA512_MECH_INFO_TYPE
, /* SUN_CKM_SHA512 */
132 SHA512_HMAC_MECH_INFO_TYPE
, /* SUN_CKM_SHA512_HMAC */
133 SHA512_HMAC_GEN_MECH_INFO_TYPE
/* SUN_CKM_SHA512_HMAC_GENERAL */
136 #endif /* _SHA2_IMPL */
142 #endif /* _SYS_SHA2_H */