summaryrefslogtreecommitdiffstats
path: root/src/crypto/isa-l/isa-l_crypto/mh_sha256/mh_sha256_internal.h
blob: 8051e3f36ee2760c3c0b07dc4a9b26adfd6473f9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
/**********************************************************************
  Copyright(c) 2011-2017 Intel Corporation All rights reserved.

  Redistribution and use in source and binary forms, with or without
  modification, are permitted provided that the following conditions
  are met:
    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in
      the documentation and/or other materials provided with the
      distribution.
    * Neither the name of Intel Corporation nor the names of its
      contributors may be used to endorse or promote products derived
      from this software without specific prior written permission.

  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
**********************************************************************/

#ifndef _MH_SHA256_INTERNAL_H_
#define _MH_SHA256_INTERNAL_H_

/**
 *  @file mh_sha256_internal.h
 *  @brief mh_sha256 internal function prototypes and macros
 *
 *  Interface for mh_sha256 internal functions
 *
 */
#include <stdint.h>
#include "mh_sha256.h"
#include "endian_helper.h"

#ifdef __cplusplus
 extern "C" {
#endif

#ifdef _MSC_VER
# define inline __inline
#endif

 // 64byte pointer align
#define ALIGN_64(pointer) ( ((uint64_t)(pointer) + 0x3F)&(~0x3F) )

 /*******************************************************************
  *mh_sha256 constants and macros
  ******************************************************************/
 /* mh_sha256 constants */
#define MH_SHA256_H0 0x6a09e667UL
#define MH_SHA256_H1 0xbb67ae85UL
#define MH_SHA256_H2 0x3c6ef372UL
#define MH_SHA256_H3 0xa54ff53aUL
#define MH_SHA256_H4 0x510e527fUL
#define MH_SHA256_H5 0x9b05688cUL
#define MH_SHA256_H6 0x1f83d9abUL
#define MH_SHA256_H7 0x5be0cd19UL

 /* mh_sha256 macros */
#define ror32(x, r) (((x)>>(r)) ^ ((x)<<(32-(r))))

#define S0(w) (ror32(w,7) ^ ror32(w,18) ^ (w >> 3))
#define S1(w) (ror32(w,17) ^ ror32(w,19) ^ (w >> 10))

#define s0(a) (ror32(a,2) ^ ror32(a,13) ^ ror32(a,22))
#define s1(e) (ror32(e,6) ^ ror32(e,11) ^ ror32(e,25))
#define maj(a,b,c) ((a & b) ^ (a & c) ^ (b & c))
#define ch(e,f,g) ((e & f) ^ (g & ~e))

 /*******************************************************************
  * SHA256 API internal function prototypes
  ******************************************************************/

 /**
  * @brief Performs complete SHA256 algorithm.
  *
  * @param input  Pointer to buffer containing the input message.
  * @param digest Pointer to digest to update.
  * @param len	  Length of buffer.
  * @returns None
  */
 void sha256_for_mh_sha256(const uint8_t * input_data, uint32_t * digest, const uint32_t len);

 /**
  * @brief Calculate sha256 digest of blocks which size is SHA256_BLOCK_SIZE
  *
  * @param data   Pointer to data buffer containing the input message.
  * @param digest Pointer to sha256 digest.
  * @returns None
  */
 void sha256_single_for_mh_sha256(const uint8_t * data, uint32_t digest[]);

 /*******************************************************************
  * mh_sha256 API internal function prototypes
  * Multiple versions of Update and Finalize functions are supplied which use
  * multiple versions of block and tail process subfunctions.
  ******************************************************************/

 /**
  * @brief  Tail process for multi-hash sha256.
  *
  * Calculate the remainder of input data which is less than MH_SHA256_BLOCK_SIZE.
  * It will output the final SHA256 digest based on mh_sha256_segs_digests.
  *
  * This function determines what instruction sets are enabled and selects the
  * appropriate version at runtime.
  *
  * @param  partial_buffer Pointer to the start addr of remainder
  * @param  total_len The total length of all sections of input data.
  * @param  mh_sha256_segs_digests The digests of all 16 segments .
  * @param  frame_buffer Pointer to buffer which is a temp working area
  * @returns none
  *
  */
 void mh_sha256_tail(uint8_t *partial_buffer, uint32_t total_len,
			 uint32_t (*mh_sha256_segs_digests)[HASH_SEGS],
			 uint8_t *frame_buffer, uint32_t mh_sha256_digest[SHA256_DIGEST_WORDS]);

 /**
  * @brief  Tail process for multi-hash sha256.
  *
  * Calculate the remainder of input data which is less than MH_SHA256_BLOCK_SIZE.
  * It will output the final SHA256 digest based on mh_sha256_segs_digests.
  *
  * @param  partial_buffer Pointer to the start addr of remainder
  * @param  total_len The total length of all sections of input data.
  * @param  mh_sha256_segs_digests The digests of all 16 segments .
  * @param  frame_buffer Pointer to buffer which is a temp working area
  * @param  mh_sha256_digest mh_sha256 digest
  * @returns none
  *
  */
 void mh_sha256_tail_base(uint8_t *partial_buffer, uint32_t total_len,
			 uint32_t (*mh_sha256_segs_digests)[HASH_SEGS],
			 uint8_t *frame_buffer, uint32_t mh_sha256_digest[SHA256_DIGEST_WORDS]);

 /**
  * @brief  Tail process for multi-hash sha256.
  *
  * Calculate the remainder of input data which is less than MH_SHA256_BLOCK_SIZE.
  * It will output the final SHA256 digest based on mh_sha256_segs_digests.
  *
  * @requires SSE
  *
  * @param  partial_buffer Pointer to the start addr of remainder
  * @param  total_len The total length of all sections of input data.
  * @param  mh_sha256_segs_digests The digests of all 16 segments .
  * @param  frame_buffer Pointer to buffer which is a temp working area
  * @param  mh_sha256_digest mh_sha256 digest
  * @returns none
  *
  */
 void mh_sha256_tail_sse(uint8_t *partial_buffer, uint32_t total_len,
			 uint32_t (*mh_sha256_segs_digests)[HASH_SEGS],
			 uint8_t *frame_buffer, uint32_t mh_sha256_digest[SHA256_DIGEST_WORDS]);

 /**
  * @brief  Tail process for multi-hash sha256.
  *
  * Calculate the remainder of input data which is less than MH_SHA256_BLOCK_SIZE.
  * It will output the final SHA256 digest based on mh_sha256_segs_digests.
  *
  * @requires AVX
  *
  * @param  partial_buffer Pointer to the start addr of remainder
  * @param  total_len The total length of all sections of input data.
  * @param  mh_sha256_segs_digests The digests of all 16 segments .
  * @param  frame_buffer Pointer to buffer which is a temp working area
  * @param  mh_sha256_digest mh_sha256 digest
  * @returns none
  *
  */
 void mh_sha256_tail_avx(uint8_t *partial_buffer, uint32_t total_len,
			 uint32_t (*mh_sha256_segs_digests)[HASH_SEGS],
			 uint8_t *frame_buffer, uint32_t mh_sha256_digest[SHA256_DIGEST_WORDS]);

 /**
  * @brief  Tail process for multi-hash sha256.
  *
  * Calculate the remainder of input data which is less than MH_SHA256_BLOCK_SIZE.
  * It will output the final SHA256 digest based on mh_sha256_segs_digests.
  *
  * @requires AVX2
  *
  * @param  partial_buffer Pointer to the start addr of remainder
  * @param  total_len The total length of all sections of input data.
  * @param  mh_sha256_segs_digests The digests of all 16 segments .
  * @param  frame_buffer Pointer to buffer which is a temp working area
  * @param  mh_sha256_digest mh_sha256 digest
  * @returns none
  *
  */
 void mh_sha256_tail_avx2(uint8_t *partial_buffer, uint32_t total_len,
			 uint32_t (*mh_sha256_segs_digests)[HASH_SEGS],
			 uint8_t *frame_buffer, uint32_t mh_sha256_digest[SHA256_DIGEST_WORDS]);

 /**
  * @brief  Tail process for multi-hash sha256.
  *
  * Calculate the remainder of input data which is less than MH_SHA256_BLOCK_SIZE.
  * It will output the final SHA256 digest based on mh_sha256_segs_digests.
  *
  * @requires AVX512
  *
  * @param  partial_buffer Pointer to the start addr of remainder
  * @param  total_len The total length of all sections of input data.
  * @param  mh_sha256_segs_digests The digests of all 16 segments .
  * @param  frame_buffer Pointer to buffer which is a temp working area
  * @param  mh_sha256_digest mh_sha256 digest
  * @returns none
  *
  */
 void mh_sha256_tail_avx512(uint8_t *partial_buffer, uint32_t total_len,
			 uint32_t (*mh_sha256_segs_digests)[HASH_SEGS],
			 uint8_t *frame_buffer, uint32_t mh_sha256_digest[SHA256_DIGEST_WORDS]);

 /**
  * @brief  Calculate mh_sha256 digest of blocks which size is MH_SHA256_BLOCK_SIZE*N.
  *
  * This function determines what instruction sets are enabled and selects the
  * appropriate version at runtime.
  *
  * @param  input_data Pointer to input data to be processed
  * @param  digests 16 segments digests
  * @param  frame_buffer Pointer to buffer which is a temp working area
  * @param  num_blocks The number of blocks.
  * @returns none
  *
  */
 void mh_sha256_block(const uint8_t * input_data, uint32_t digests[SHA256_DIGEST_WORDS][HASH_SEGS],
			 uint8_t frame_buffer[MH_SHA256_BLOCK_SIZE], uint32_t num_blocks);

 /**
  * @brief  Calculate mh_sha256 digest of blocks which size is MH_SHA256_BLOCK_SIZE*N.
  *
  * @param  input_data Pointer to input data to be processed
  * @param  digests 16 segments digests
  * @param  frame_buffer Pointer to buffer which is a temp working area
  * @param  num_blocks The number of blocks.
  * @returns none
  *
  */
 void mh_sha256_block_base(const uint8_t * input_data, uint32_t digests[SHA256_DIGEST_WORDS][HASH_SEGS],
			 uint8_t frame_buffer[MH_SHA256_BLOCK_SIZE], uint32_t num_blocks);

 /**
  * @brief  Calculate mh_sha256 digest of blocks which size is MH_SHA256_BLOCK_SIZE*N.
  *
  * @requires SSE
  * @param  input_data Pointer to input data to be processed
  * @param  digests 16 segments digests
  * @param  frame_buffer Pointer to buffer which is a temp working area
  * @param  num_blocks The number of blocks.
  * @returns none
  *
  */
 void mh_sha256_block_sse(const uint8_t * input_data, uint32_t digests[SHA256_DIGEST_WORDS][HASH_SEGS],
			 uint8_t frame_buffer[MH_SHA256_BLOCK_SIZE], uint32_t num_blocks);

 /**
  * @brief  Calculate mh_sha256 digest of blocks which size is MH_SHA256_BLOCK_SIZE*N.
  *
  * @requires AVX
  *
  * @param  input_data Pointer to input data to be processed
  * @param  digests 16 segments digests
  * @param  frame_buffer Pointer to buffer which is a temp working area
  * @param  num_blocks The number of blocks.
  * @returns none
  *
  */
 void mh_sha256_block_avx(const uint8_t * input_data, uint32_t digests[SHA256_DIGEST_WORDS][HASH_SEGS],
			 uint8_t frame_buffer[MH_SHA256_BLOCK_SIZE], uint32_t num_blocks);

 /**
  * @brief  Calculate mh_sha256 digest of blocks which size is MH_SHA256_BLOCK_SIZE*N.
  *
  * @requires AVX2
  *
  * @param  input_data Pointer to input data to be processed
  * @param  digests 16 segments digests
  * @param  frame_buffer Pointer to buffer which is a temp working area
  * @param  num_blocks The number of blocks.
  * @returns none
  *
  */
 void mh_sha256_block_avx2(const uint8_t * input_data, uint32_t digests[SHA256_DIGEST_WORDS][HASH_SEGS],
			 uint8_t frame_buffer[MH_SHA256_BLOCK_SIZE], uint32_t num_blocks);

 /**
  * @brief  Calculate mh_sha256 digest of blocks which size is MH_SHA256_BLOCK_SIZE*N.
  *
  * @requires AVX512
  *
  * @param  input_data Pointer to input data to be processed
  * @param  digests 16 segments digests
  * @param  frame_buffer Pointer to buffer which is a temp working area
  * @param  num_blocks The number of blocks.
  * @returns none
  *
  */
 void mh_sha256_block_avx512(const uint8_t * input_data, uint32_t digests[SHA256_DIGEST_WORDS][HASH_SEGS],
			 uint8_t frame_buffer[MH_SHA256_BLOCK_SIZE], uint32_t num_blocks);

#ifdef __cplusplus
}
#endif

#endif