iPXE
sha256_test.c
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2012 Michael Brown <mbrown@fensystems.co.uk>.
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License as
6  * published by the Free Software Foundation; either version 2 of the
7  * License, or any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
17  * 02110-1301, USA.
18  *
19  * You can also choose to distribute this program under the terms of
20  * the Unmodified Binary Distribution Licence (as given in the file
21  * COPYING.UBDL), provided that you have satisfied its requirements.
22  */
23 
24 FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
25 
26 /** @file
27  *
28  * SHA-256 family tests
29  *
30  * NIST test vectors are taken from
31  *
32  * http://csrc.nist.gov/groups/ST/toolkit/documents/Examples/SHA256.pdf
33  * http://csrc.nist.gov/groups/ST/toolkit/documents/Examples/SHA224.pdf
34  *
35  */
36 
37 /* Forcibly enable assertions */
38 #undef NDEBUG
39 
40 #include <ipxe/sha256.h>
41 #include <ipxe/test.h>
42 #include "digest_test.h"
43 
44 /* Empty test vector (digest obtained from "sha256sum /dev/null") */
45 DIGEST_TEST ( sha256_empty, &sha256_algorithm, DIGEST_EMPTY,
46  DIGEST ( 0xe3, 0xb0, 0xc4, 0x42, 0x98, 0xfc, 0x1c, 0x14, 0x9a,
47  0xfb, 0xf4, 0xc8, 0x99, 0x6f, 0xb9, 0x24, 0x27, 0xae,
48  0x41, 0xe4, 0x64, 0x9b, 0x93, 0x4c, 0xa4, 0x95, 0x99,
49  0x1b, 0x78, 0x52, 0xb8, 0x55 ) );
50 
51 /* NIST test vector "abc" */
52 DIGEST_TEST ( sha256_nist_abc, &sha256_algorithm, DIGEST_NIST_ABC,
53  DIGEST ( 0xba, 0x78, 0x16, 0xbf, 0x8f, 0x01, 0xcf, 0xea, 0x41,
54  0x41, 0x40, 0xde, 0x5d, 0xae, 0x22, 0x23, 0xb0, 0x03,
55  0x61, 0xa3, 0x96, 0x17, 0x7a, 0x9c, 0xb4, 0x10, 0xff,
56  0x61, 0xf2, 0x00, 0x15, 0xad ) );
57 
58 /* NIST test vector "abc...opq" */
59 DIGEST_TEST ( sha256_nist_abc_opq, &sha256_algorithm, DIGEST_NIST_ABC_OPQ,
60  DIGEST ( 0x24, 0x8d, 0x6a, 0x61, 0xd2, 0x06, 0x38, 0xb8, 0xe5,
61  0xc0, 0x26, 0x93, 0x0c, 0x3e, 0x60, 0x39, 0xa3, 0x3c,
62  0xe4, 0x59, 0x64, 0xff, 0x21, 0x67, 0xf6, 0xec, 0xed,
63  0xd4, 0x19, 0xdb, 0x06, 0xc1 ) );
64 
65 /* Empty test vector (digest obtained from "sha224sum /dev/null") */
66 DIGEST_TEST ( sha224_empty, &sha224_algorithm, DIGEST_EMPTY,
67  DIGEST ( 0xd1, 0x4a, 0x02, 0x8c, 0x2a, 0x3a, 0x2b, 0xc9, 0x47,
68  0x61, 0x02, 0xbb, 0x28, 0x82, 0x34, 0xc4, 0x15, 0xa2,
69  0xb0, 0x1f, 0x82, 0x8e, 0xa6, 0x2a, 0xc5, 0xb3, 0xe4,
70  0x2f ) );
71 
72 /* NIST test vector "abc" */
73 DIGEST_TEST ( sha224_nist_abc, &sha224_algorithm, DIGEST_NIST_ABC,
74  DIGEST ( 0x23, 0x09, 0x7d, 0x22, 0x34, 0x05, 0xd8, 0x22, 0x86,
75  0x42, 0xa4, 0x77, 0xbd, 0xa2, 0x55, 0xb3, 0x2a, 0xad,
76  0xbc, 0xe4, 0xbd, 0xa0, 0xb3, 0xf7, 0xe3, 0x6c, 0x9d,
77  0xa7 ) );
78 
79 /* NIST test vector "abc...opq" */
80 DIGEST_TEST ( sha224_nist_abc_opq, &sha224_algorithm, DIGEST_NIST_ABC_OPQ,
81  DIGEST ( 0x75, 0x38, 0x8b, 0x16, 0x51, 0x27, 0x76, 0xcc, 0x5d,
82  0xba, 0x5d, 0xa1, 0xfd, 0x89, 0x01, 0x50, 0xb0, 0xc6,
83  0x45, 0x5c, 0xb4, 0xf5, 0x8b, 0x19, 0x52, 0x52, 0x25,
84  0x25 ) );
85 
86 /**
87  * Perform SHA-256 family self-test
88  *
89  */
90 static void sha256_test_exec ( void ) {
91 
92  /* Correctness tests */
93  digest_ok ( &sha256_empty );
94  digest_ok ( &sha256_nist_abc );
95  digest_ok ( &sha256_nist_abc_opq );
96  digest_ok ( &sha224_empty );
97  digest_ok ( &sha224_nist_abc );
98  digest_ok ( &sha224_nist_abc_opq );
99 
100  /* Speed tests */
101  DBG ( "SHA256 required %ld cycles per byte\n",
103  DBG ( "SHA224 required %ld cycles per byte\n",
105 }
106 
107 /** SHA-256 family self-test */
108 struct self_test sha256_test __self_test = {
109  .name = "sha256",
110  .exec = sha256_test_exec,
111 };
DIGEST_TEST(sha256_empty, &sha256_algorithm, DIGEST_EMPTY, DIGEST(0xe3, 0xb0, 0xc4, 0x42, 0x98, 0xfc, 0x1c, 0x14, 0x9a, 0xfb, 0xf4, 0xc8, 0x99, 0x6f, 0xb9, 0x24, 0x27, 0xae, 0x41, 0xe4, 0x64, 0x9b, 0x93, 0x4c, 0xa4, 0x95, 0x99, 0x1b, 0x78, 0x52, 0xb8, 0x55))
struct self_test sha256_test __self_test
SHA-256 family self-test.
Definition: sha256_test.c:108
#define DIGEST_NIST_ABC
Standard test vector: NIST string "abc".
Definition: digest_test.h:60
Self-test infrastructure.
FILE_LICENCE(GPL2_OR_LATER_OR_UBDL)
const char * name
Test set name.
Definition: test.h:17
A self-test set.
Definition: test.h:15
#define DIGEST_NIST_ABC_OPQ
Standard test vector: NIST string "abc...opq".
Definition: digest_test.h:71
unsigned long digest_cost(struct digest_algorithm *digest)
Calculate digest algorithm cost.
Definition: digest_test.c:131
#define digest_ok(test)
Report a digest test result.
Definition: digest_test.h:109
#define DIGEST_EMPTY
Standard test vector: empty data.
Definition: digest_test.h:51
struct digest_algorithm sha256_algorithm
SHA-256 algorithm.
Definition: sha256.c:265
static void sha256_test_exec(void)
Perform SHA-256 family self-test.
Definition: sha256_test.c:90
struct digest_algorithm sha224_algorithm
SHA-224 algorithm.
Definition: sha224.c:64
#define DBG(...)
Print a debugging message.
Definition: compiler.h:498
#define DIGEST(...)
Define inline expected digest.
Definition: der_test.c:45
SHA-256 algorithm.