bee85e2da73eeeff2623b97f5283e178124059fb
[dpdk.git] / examples / fips_validation / fips_validation.h
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright(c) 2018 Intel Corporation
3  */
4
5 #ifndef _FIPS_VALIDATION_H_
6 #define _FIPS_VALIDATION_H_
7
8 #define FIPS_PARSE_ERR(fmt, args)                                       \
9         RTE_LOG(ERR, USER1, "FIPS parse error" ## fmt ## "\n", ## args)
10
11 #define ERR_MSG_SIZE            128
12 #define MAX_CASE_LINE           15
13 #define MAX_LINE_CHAR           204800 /*< max number of characters per line */
14 #define MAX_NB_TESTS            10240
15 #define DEF_MBUF_SEG_SIZE       (UINT16_MAX - sizeof(struct rte_mbuf) - \
16                                 RTE_PKTMBUF_HEADROOM)
17 #define MAX_STRING_SIZE         64
18 #define MAX_FILE_NAME_SIZE      256
19 #define MAX_DIGEST_SIZE         64
20
21 #define POSITIVE_TEST           0
22 #define NEGATIVE_TEST           -1
23
24 #define REQ_FILE_PERFIX         "req"
25 #define RSP_FILE_PERFIX         "rsp"
26 #define FAX_FILE_PERFIX         "fax"
27
28 enum fips_test_algorithms {
29                 FIPS_TEST_ALGO_AES = 0,
30                 FIPS_TEST_ALGO_AES_GCM,
31                 FIPS_TEST_ALGO_AES_CMAC,
32                 FIPS_TEST_ALGO_AES_CCM,
33                 FIPS_TEST_ALGO_HMAC,
34                 FIPS_TEST_ALGO_TDES,
35                 FIPS_TEST_ALGO_SHA,
36                 FIPS_TEST_ALGO_AES_XTS,
37                 FIPS_TEST_ALGO_MAX
38 };
39
40 enum file_types {
41         FIPS_TYPE_REQ = 1,
42         FIPS_TYPE_FAX,
43         FIPS_TYPE_RSP
44 };
45
46 enum fips_test_op {
47         FIPS_TEST_ENC_AUTH_GEN = 1,
48         FIPS_TEST_DEC_AUTH_VERIF,
49 };
50
51 #define MAX_LINE_PER_VECTOR            16
52
53 struct fips_val {
54         uint8_t *val;
55         uint32_t len;
56 };
57
58 struct fips_test_vector {
59         union {
60                 struct {
61                         struct fips_val key;
62                         struct fips_val digest;
63                         struct fips_val auth_aad;
64                         struct fips_val aad;
65                 } cipher_auth;
66                 struct {
67                         struct fips_val key;
68                         struct fips_val digest;
69                         struct fips_val aad;
70                 } aead;
71         };
72
73         struct fips_val pt;
74         struct fips_val ct;
75         struct fips_val iv;
76
77         enum rte_crypto_op_status status;
78 };
79
80 typedef int (*post_prcess_t)(struct fips_val *val);
81
82 typedef int (*parse_callback_t)(const char *key, char *text,
83                 struct fips_val *val);
84
85 struct fips_test_callback {
86         const char *key;
87         parse_callback_t cb;
88         struct fips_val *val;
89 };
90
91 enum fips_aesavs_test_types {
92         AESAVS_TYPE_GFXBOX = 1,
93         AESAVS_TYPE_KEYSBOX,
94         AESAVS_TYPE_VARKEY,
95         AESAVS_TYPE_VARTXT,
96         AESAVS_TYPE_MMT,
97         AESAVS_TYPE_MCT,
98 };
99
100 enum fips_tdes_test_types {
101         TDES_INVERSE_PERMUTATION = 0,
102         TDES_PERMUTATION,
103         TDES_SUBSTITUTION_TABLE,
104         TDES_VARIABLE_KEY,
105         TDES_VARIABLE_TEXT,
106         TDES_KAT,
107         TDES_MCT, /* Monte Carlo (Modes) Test */
108         TDES_MMT /* Multi block Message Test */
109 };
110
111 enum fips_tdes_test_mode {
112         TDES_MODE_CBC = 0,
113         TDES_MODE_ECB
114 };
115
116 enum fips_ccm_test_types {
117         CCM_VADT        = 1, /* Variable Associated Data Test */
118         CCM_VPT,                 /* Variable Payload Test */
119         CCM_VNT,                 /* Variable Nonce Test */
120         CCM_VTT,                 /* Variable Tag Test */
121         CCM_DVPT,        /*  Decryption-Verification Process Test */
122 };
123
124 enum fips_sha_test_types {
125         SHA_KAT = 0,
126         SHA_MCT
127 };
128
129 struct aesavs_interim_data {
130         enum fips_aesavs_test_types test_type;
131         uint32_t cipher_algo;
132         uint32_t key_len;
133 };
134
135 struct hmac_interim_data {
136         enum rte_crypto_auth_algorithm algo;
137 };
138
139 struct tdes_interim_data {
140         enum fips_tdes_test_types test_type;
141         enum fips_tdes_test_mode test_mode;
142         uint32_t nb_keys;
143 };
144
145 struct ccm_interim_data {
146         enum fips_ccm_test_types test_type;
147         uint32_t aad_len;
148         uint32_t pt_len;
149         uint32_t digest_len;
150         uint32_t key_len;
151         uint32_t iv_len;
152 };
153
154 struct sha_interim_data {
155         enum fips_sha_test_types test_type;
156         enum rte_crypto_auth_algorithm algo;
157 };
158
159 struct fips_test_interim_info {
160         FILE *fp_rd;
161         FILE *fp_wr;
162         enum file_types file_type;
163         enum fips_test_algorithms algo;
164         char *one_line_text;
165         char *vec[MAX_LINE_PER_VECTOR];
166         uint32_t vec_start_off;
167         uint32_t nb_vec_lines;
168         char device_name[MAX_STRING_SIZE];
169         char file_name[MAX_FILE_NAME_SIZE];
170         float version;
171
172         union {
173                 struct aesavs_interim_data aes_data;
174                 struct hmac_interim_data hmac_data;
175                 struct tdes_interim_data tdes_data;
176                 struct ccm_interim_data ccm_data;
177                 struct sha_interim_data sha_data;
178         } interim_info;
179
180         enum fips_test_op op;
181
182         const struct fips_test_callback *callbacks;
183         const struct fips_test_callback *interim_callbacks;
184         const struct fips_test_callback *writeback_callbacks;
185
186         post_prcess_t parse_writeback;
187         post_prcess_t kat_check;
188 };
189
190 extern struct fips_test_vector vec;
191 extern struct fips_test_interim_info info;
192
193 int
194 fips_test_init(const char *req_file_path, const char *rsp_file_path,
195                 const char *device_name);
196
197 void
198 fips_test_clear(void);
199
200 int
201 fips_test_fetch_one_block(void);
202
203 int
204 fips_test_parse_one_case(void);
205
206 void
207 fips_test_write_one_case(void);
208
209 int
210 parse_test_aes_init(void);
211
212 int
213 parse_test_tdes_init(void);
214
215 int
216 parse_test_hmac_init(void);
217
218 int
219 parse_test_gcm_init(void);
220
221 int
222 parse_test_cmac_init(void);
223
224 int
225 parse_test_ccm_init(void);
226
227 int
228 parse_test_sha_init(void);
229
230 int
231 parse_test_xts_init(void);
232
233 int
234 parser_read_uint8_hex(uint8_t *value, const char *p);
235
236 int
237 parse_uint8_hex_str(const char *key, char *src, struct fips_val *val);
238
239 int
240 parse_uint8_known_len_hex_str(const char *key, char *src, struct fips_val *val);
241
242 int
243 parser_read_uint32_val(const char *key, char *src, struct fips_val *val);
244
245 int
246 parser_read_uint32_bit_val(const char *key, char *src, struct fips_val *val);
247
248 int
249 parser_read_uint32(uint32_t *value, char *p);
250
251 int
252 parser_read_uint32_val(const char *key, char *src, struct fips_val *val);
253
254 int
255 writeback_hex_str(const char *key, char *dst, struct fips_val *val);
256
257 void
258 parse_write_hex_str(struct fips_val *src);
259
260 int
261 update_info_vec(uint32_t count);
262
263 #endif