xref: /optee_os/ta/pkcs11/include/pkcs11_ta.h (revision b6ca7e5dd226f2c3691d798ab81d1cf35dfec33e)
1 /* SPDX-License-Identifier: BSD-2-Clause */
2 /*
3  * Copyright (c) 2018-2020, Linaro Limited
4  */
5 
6 #ifndef PKCS11_TA_H
7 #define PKCS11_TA_H
8 
9 #include <stdbool.h>
10 #include <stdint.h>
11 
12 #define PKCS11_TA_UUID { 0xfd02c9da, 0x306c, 0x48c7, \
13 			 { 0xa4, 0x9c, 0xbb, 0xd8, 0x27, 0xae, 0x86, 0xee } }
14 
15 /* PKCS11 trusted application version information */
16 #define PKCS11_TA_VERSION_MAJOR			0
17 #define PKCS11_TA_VERSION_MINOR			1
18 #define PKCS11_TA_VERSION_PATCH			0
19 
20 /* Attribute specific values */
21 #define PKCS11_CK_UNAVAILABLE_INFORMATION	UINT32_C(0xFFFFFFFF)
22 #define PKCS11_UNDEFINED_ID			UINT32_C(0xFFFFFFFF)
23 #define PKCS11_FALSE				false
24 #define PKCS11_TRUE				true
25 
26 /*
27  * Note on PKCS#11 TA commands ABI
28  *
29  * For evolution of the TA API and to not mess with the GPD TEE 4 parameters
30  * constraint, all the PKCS11 TA invocation commands use a subset of available
31  * the GPD TEE invocation parameter types.
32  *
33  * Param#0 is used for the so-called control arguments of the invoked command
34  * and for providing a PKCS#11 compliant status code for the request command.
35  * Param#0 is an in/out memory reference (aka memref[0]). The input buffer
36  * stores serialized arguments for the command. The output buffer store the
37  * 32bit TA return code for the command. As a consequence, param#0 shall
38  * always be an input/output memory reference of at least 32bit, more if
39  * the command expects more input arguments.
40  *
41  * When the TA returns with TEE_SUCCESS result, client shall always get the
42  * 32bit value stored in param#0 output buffer and use the value as TA
43  * return code for the invoked command.
44  *
45  * Param#1 can be used for input data arguments of the invoked command.
46  * It is unused or is an input memory reference, aka memref[1].
47  * Evolution of the API may use memref[1] for output data as well.
48  *
49  * Param#2 is mostly used for output data arguments of the invoked command
50  * and for output handles generated from invoked commands.
51  * Few commands uses it for a secondary input data buffer argument.
52  * It is unused or is an input/output/in-out memory reference, aka memref[2].
53  *
54  * Param#3 is currently unused and reserved for evolution of the API.
55  */
56 
57 enum pkcs11_ta_cmd {
58 	/*
59 	 * PKCS11_CMD_PING		Ack TA presence and return version info
60 	 *
61 	 * [in]  memref[0] = 32bit, unused, must be 0
62 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
63 	 * [out] memref[2] = [
64 	 *              32bit version major value,
65 	 *              32bit version minor value
66 	 *              32bit version patch value
67 	 *       ]
68 	 */
69 	PKCS11_CMD_PING = 0,
70 
71 	/*
72 	 * PKCS11_CMD_SLOT_LIST - Get the table of the valid slot IDs
73 	 *
74 	 * [in]  memref[0] = 32bit, unused, must be 0
75 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
76 	 * [out] memref[2] = 32bit array slot_ids[slot counts]
77 	 *
78 	 * The TA instance may represent several PKCS#11 slots and
79 	 * associated tokens. This commadn reports the IDs of embedded tokens.
80 	 * This command relates the PKCS#11 API function C_GetSlotList().
81 	 */
82 	PKCS11_CMD_SLOT_LIST = 1,
83 
84 	/*
85 	 * PKCS11_CMD_SLOT_INFO - Get cryptoki structured slot information
86 	 *
87 	 * [in]	 memref[0] = 32bit slot ID
88 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
89 	 * [out] memref[2] = (struct pkcs11_slot_info)info
90 	 *
91 	 * The TA instance may represent several PKCS#11 slots/tokens.
92 	 * This command relates the PKCS#11 API function C_GetSlotInfo().
93 	 */
94 	PKCS11_CMD_SLOT_INFO = 2,
95 
96 	/*
97 	 * PKCS11_CMD_TOKEN_INFO - Get cryptoki structured token information
98 	 *
99 	 * [in]	 memref[0] = 32bit slot ID
100 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
101 	 * [out] memref[2] = (struct pkcs11_token_info)info
102 	 *
103 	 * The TA instance may represent several PKCS#11 slots/tokens.
104 	 * This command relates the PKCS#11 API function C_GetTokenInfo().
105 	 */
106 	PKCS11_CMD_TOKEN_INFO = 3,
107 
108 	/*
109 	 * PKCS11_CMD_MECHANISM_IDS - Get list of the supported mechanisms
110 	 *
111 	 * [in]	 memref[0] = 32bit slot ID
112 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
113 	 * [out] memref[2] = 32bit array mechanism IDs
114 	 *
115 	 * This command relates to the PKCS#11 API function
116 	 * C_GetMechanismList().
117 	 */
118 	PKCS11_CMD_MECHANISM_IDS = 4,
119 
120 	/*
121 	 * PKCS11_CMD_MECHANISM_INFO - Get information on a specific mechanism
122 	 *
123 	 * [in]  memref[0] = [
124 	 *              32bit slot ID,
125 	 *              32bit mechanism ID (PKCS11_CKM_*)
126 	 *       ]
127 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
128 	 * [out] memref[2] = (struct pkcs11_mechanism_info)info
129 	 *
130 	 * This command relates to the PKCS#11 API function
131 	 * C_GetMechanismInfo().
132 	 */
133 	PKCS11_CMD_MECHANISM_INFO = 5,
134 
135 	/*
136 	 * PKCS11_CMD_OPEN_SESSION - Open a session
137 	 *
138 	 * [in]  memref[0] = [
139 	 *              32bit slot ID,
140 	 *              32bit session flags,
141 	 *       ]
142 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
143 	 * [out] memref[2] = 32bit session handle
144 	 *
145 	 * This command relates to the PKCS#11 API function C_OpenSession().
146 	 */
147 	PKCS11_CMD_OPEN_SESSION = 6,
148 
149 	/*
150 	 * PKCS11_CMD_CLOSE_SESSION - Close an opened session
151 	 *
152 	 * [in]  memref[0] = 32bit session handle
153 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
154 	 *
155 	 * This command relates to the PKCS#11 API function C_CloseSession().
156 	 */
157 	PKCS11_CMD_CLOSE_SESSION = 7,
158 
159 	/*
160 	 * PKCS11_CMD_CLOSE_ALL_SESSIONS - Close all client sessions on token
161 	 *
162 	 * [in]	 memref[0] = 32bit slot ID
163 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
164 	 *
165 	 * This command relates to the PKCS#11 API function
166 	 * C_CloseAllSessions().
167 	 */
168 	PKCS11_CMD_CLOSE_ALL_SESSIONS = 8,
169 
170 	/*
171 	 * PKCS11_CMD_SESSION_INFO - Get Cryptoki information on a session
172 	 *
173 	 * [in]  memref[0] = 32bit session handle
174 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
175 	 * [out] memref[2] = (struct pkcs11_session_info)info
176 	 *
177 	 * This command relates to the PKCS#11 API function C_GetSessionInfo().
178 	 */
179 	PKCS11_CMD_SESSION_INFO = 9,
180 
181 	/*
182 	 * PKCS11_CMD_INIT_TOKEN - Initialize PKCS#11 token
183 	 *
184 	 * [in]  memref[0] = [
185 	 *              32bit slot ID,
186 	 *              32bit PIN length,
187 	 *              byte array label[32]
188 	 *              byte array PIN[PIN length],
189 	 *	 ]
190 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
191 	 *
192 	 * This command relates to the PKCS#11 API function C_InitToken().
193 	 */
194 	PKCS11_CMD_INIT_TOKEN = 10,
195 
196 	/*
197 	 * PKCS11_CMD_INIT_PIN - Initialize user PIN
198 	 *
199 	 * [in]  memref[0] = [
200 	 *              32bit session handle,
201 	 *              32bit PIN byte size,
202 	 *              byte array: PIN data
203 	 *	 ]
204 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
205 	 *
206 	 * This command relates to the PKCS#11 API function C_InitPIN().
207 	 */
208 	PKCS11_CMD_INIT_PIN = 11,
209 
210 	/*
211 	 * PKCS11_CMD_SET_PIN - Change user PIN
212 	 *
213 	 * [in]	 memref[0] = [
214 	 *              32bit session handle,
215 	 *              32bit old PIN byte size,
216 	 *              32bit new PIN byte size,
217 	 *              byte array: PIN data,
218 	 *              byte array: new PIN data,
219 	 *       ]
220 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
221 	 *
222 	 * This command relates to the PKCS#11 API function C_SetPIN().
223 	 */
224 	PKCS11_CMD_SET_PIN = 12,
225 
226 	/*
227 	 * PKCS11_CMD_LOGIN - Initialize user PIN
228 	 *
229 	 * [in]  memref[0] = [
230 	 *              32bit session handle,
231 	 *              32bit user identifier, enum pkcs11_user_type
232 	 *              32bit PIN byte size,
233 	 *              byte array: PIN data
234 	 *	 ]
235 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
236 	 *
237 	 * This command relates to the PKCS#11 API function C_Login().
238 	 */
239 	PKCS11_CMD_LOGIN = 13,
240 
241 	/*
242 	 * PKCS11_CMD_LOGOUT - Log out from token
243 	 *
244 	 * [in]  memref[0] = [
245 	 *              32bit session handle,
246 	 *	 ]
247 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
248 	 *
249 	 * This command relates to the PKCS#11 API function C_Logout().
250 	 */
251 	PKCS11_CMD_LOGOUT = 14,
252 
253 	/*
254 	 * PKCS11_CMD_CREATE_OBJECT - Create a raw client assembled object in
255 	 *			      the session or token
256 	 *
257 	 *
258 	 * [in]  memref[0] = [
259 	 *              32bit session handle,
260 	 *              (struct pkcs11_object_head)attribs + attributes data
261 	 *	 ]
262 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
263 	 * [out] memref[2] = 32bit object handle
264 	 *
265 	 * This command relates to the PKCS#11 API function C_CreateObject().
266 	 */
267 	PKCS11_CMD_CREATE_OBJECT = 15,
268 
269 	/*
270 	 * PKCS11_CMD_DESTROY_OBJECT - Destroy an object
271 	 *
272 	 * [in]  memref[0] = [
273 	 *              32bit session handle,
274 	 *              32bit object handle
275 	 *	 ]
276 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
277 	 *
278 	 * This command relates to the PKCS#11 API function C_DestroyObject().
279 	 */
280 	PKCS11_CMD_DESTROY_OBJECT = 16,
281 
282 	/*
283 	 * PKCS11_CMD_ENCRYPT_INIT - Initialize encryption processing
284 	 * PKCS11_CMD_DECRYPT_INIT - Initialize decryption processing
285 	 *
286 	 * [in]  memref[0] = [
287 	 *              32bit session handle,
288 	 *              32bit object handle of the key,
289 	 *              (struct pkcs11_attribute_head)mechanism + mecha params
290 	 *	 ]
291 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
292 	 *
293 	 * These commands relate to the PKCS#11 API functions
294 	 * C_EncryptInit() and C_DecryptInit().
295 	 */
296 	PKCS11_CMD_ENCRYPT_INIT = 17,
297 	PKCS11_CMD_DECRYPT_INIT = 18,
298 
299 	/*
300 	 * PKCS11_CMD_ENCRYPT_UPDATE - Update encryption processing
301 	 * PKCS11_CMD_DECRYPT_UPDATE - Update decryption processing
302 	 *
303 	 * [in]  memref[0] = 32bit session handle
304 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
305 	 * [in]  memref[1] = input data to be processed
306 	 * [out] memref[2] = output processed data
307 	 *
308 	 * These commands relate to the PKCS#11 API functions
309 	 * C_EncryptUpdate() and C_DecryptUpdate().
310 	 */
311 	PKCS11_CMD_ENCRYPT_UPDATE = 19,
312 	PKCS11_CMD_DECRYPT_UPDATE = 20,
313 
314 	/*
315 	 * PKCS11_CMD_ENCRYPT_FINAL - Finalize encryption processing
316 	 * PKCS11_CMD_DECRYPT_FINAL - Finalize decryption processing
317 	 *
318 	 * [in]  memref[0] = 32bit session handle
319 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
320 	 * [out] memref[2] = output processed data
321 	 *
322 	 * These commands relate to the PKCS#11 API functions
323 	 * C_EncryptFinal() and C_DecryptFinal().
324 	 */
325 	PKCS11_CMD_ENCRYPT_FINAL = 21,
326 	PKCS11_CMD_DECRYPT_FINAL = 22,
327 
328 	/*
329 	 * PKCS11_CMD_ENCRYPT_ONESHOT - Update and finalize encryption
330 	 *                              processing
331 	 * PKCS11_CMD_DECRYPT_ONESHOT - Update and finalize decryption
332 	 *                              processing
333 	 *
334 	 * [in]  memref[0] = 32bit session handle
335 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
336 	 * [in]  memref[1] = input data to be processed
337 	 * [out] memref[2] = output processed data
338 	 *
339 	 * These commands relate to the PKCS#11 API functions C_Encrypt and
340 	 * C_Decrypt.
341 	 */
342 	PKCS11_CMD_ENCRYPT_ONESHOT = 23,
343 	PKCS11_CMD_DECRYPT_ONESHOT = 24,
344 
345 	/*
346 	 * PKCS11_CMD_SIGN_INIT   - Initialize a signature computation
347 	 *                          processing
348 	 * PKCS11_CMD_VERIFY_INIT - Initialize a signature verification
349 	 *                          processing
350 	 *
351 	 * [in]  memref[0] = [
352 	 *              32bit session handle,
353 	 *              32bit key handle,
354 	 *              (struct pkcs11_attribute_head)mechanism +
355 	 *                                            mechanism params,
356 	 *	 ]
357 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
358 	 *
359 	 * These commands relate to the PKCS#11 API functions C_SignInit() and
360 	 * C_VerifyInit().
361 	 */
362 	PKCS11_CMD_SIGN_INIT = 25,
363 	PKCS11_CMD_VERIFY_INIT = 26,
364 
365 	/*
366 	 * PKCS11_CMD_SIGN_UPDATE   - Update a signature computation processing
367 	 * PKCS11_CMD_VERIFY_UPDATE - Update a signature verification processing
368 	 *
369 	 * [in]  memref[0] = 32bit session handle
370 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
371 	 * [in]  memref[1] = input data to be processed
372 	 *
373 	 * These commands relate to the PKCS#11 API functions C_SignUpdate() and
374 	 * C_VerifyUpdate().
375 	 */
376 	PKCS11_CMD_SIGN_UPDATE = 27,
377 	PKCS11_CMD_VERIFY_UPDATE = 28,
378 
379 	/*
380 	 * PKCS11_CMD_SIGN_FINAL - Finalize a signature computation processing
381 	 *
382 	 * [in]  memref[0] = 32bit session handle
383 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
384 	 * [out] memref[2] = output signature
385 	 *
386 	 * This command relates to the PKCS#11 API functions C_SignFinal().
387 	 */
388 	PKCS11_CMD_SIGN_FINAL = 29,
389 
390 	/*
391 	 * PKCS11_CMD_VERIFY_FINAL - Finalize a signature verification
392 	 *                           processing
393 	 *
394 	 * [in]  memref[0] = 32bit session handle
395 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
396 	 * [in]  memref[2] = input signature to be processed
397 	 *
398 	 * This command relates to the PKCS#11 API functions C_VerifyFinal().
399 	 */
400 	PKCS11_CMD_VERIFY_FINAL = 30,
401 
402 	/*
403 	 * PKCS11_CMD_SIGN_ONESHOT - Compute a signature
404 	 *
405 	 * [in]  memref[0] = 32bit session handle
406 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
407 	 * [in]  memref[1] = input data to be processed
408 	 * [out] memref[2] = byte array: generated signature
409 	 *
410 	 * This command relates to the PKCS#11 API function C_Sign().
411 	 */
412 	PKCS11_CMD_SIGN_ONESHOT = 31,
413 
414 	/*
415 	 * PKCS11_CMD_VERIFY_ONESHOT - Compute and compare a signature
416 	 *
417 	 * [in]  memref[0] = 32bit session handle
418 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
419 	 * [in]  memref[1] = input data to be processed
420 	 * [in]  memref[2] = input signature to be processed
421 	 *
422 	 * This command relates to the PKCS#11 API function C_Verify().
423 	 */
424 	PKCS11_CMD_VERIFY_ONESHOT = 32,
425 
426 	/*
427 	 * PKCS11_CMD_GENERATE_KEY - Generate a symmetric key or domain
428 	 *                           parameters
429 	 *
430 	 * [in]  memref[0] = [
431 	 *              32bit session handle,
432 	 *              (struct pkcs11_attribute_head)mechanism + mecha params,
433 	 *              (struct pkcs11_object_head)attribs + attributes data
434 	 *	 ]
435 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
436 	 * [out] memref[2] = 32bit object handle
437 	 *
438 	 * This command relates to the PKCS#11 API function C_GenerateKey().
439 	 */
440 	PKCS11_CMD_GENERATE_KEY = 33,
441 
442 	/*
443 	 * PKCS11_CMD_FIND_OBJECTS_INIT - Initialize an object search
444 	 *
445 	 * [in]  memref[0] = [
446 	 *              32bit session handle,
447 	 *              (struct pkcs11_object_head)attribs + attributes data
448 	 *	 ]
449 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
450 	 *
451 	 * This command relates to the PKCS#11 API function C_FindOjectsInit().
452 	 */
453 	PKCS11_CMD_FIND_OBJECTS_INIT = 34,
454 
455 	/*
456 	 * PKCS11_CMD_FIND_OBJECTS - Get handles of matching objects
457 	 *
458 	 * [in]  memref[0] = 32bit session handle
459 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
460 	 * [out] memref[2] = 32bit array object_handle_array[N]
461 	 *
462 	 * This command relates to the PKCS#11 API function C_FindOjects().
463 	 * The size of object_handle_array depends on the size of the output
464 	 * buffer provided by the client.
465 	 */
466 	PKCS11_CMD_FIND_OBJECTS = 35,
467 
468 	/*
469 	 * PKCS11_CMD_FIND_OBJECTS_FINAL - Finalize current objects search
470 	 *
471 	 * [in]  memref[0] = 32bit session handle
472 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
473 	 *
474 	 * This command relates to the PKCS#11 API function C_FindOjectsFinal().
475 	 */
476 	PKCS11_CMD_FIND_OBJECTS_FINAL = 36,
477 
478 	/*
479 	 * PKCS11_CMD_GET_OBJECT_SIZE - Get byte size used by object in the TEE
480 	 *
481 	 * [in]  memref[0] = [
482 	 *              32bit session handle,
483 	 *              32bit object handle
484 	 *	 ]
485 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
486 	 * [out] memref[2] = 32bit object_byte_size
487 	 *
488 	 * This command relates to the PKCS#11 API function C_GetObjectSize().
489 	 */
490 	PKCS11_CMD_GET_OBJECT_SIZE = 37,
491 
492 	/*
493 	 * PKCS11_CMD_GET_ATTRIBUTE_VALUE - Get the value of object attribute(s)
494 	 *
495 	 * [in]  memref[0] = [
496 	 *              32bit session handle,
497 	 *              32bit object handle,
498 	 *              (struct pkcs11_object_head)attribs + attributes data
499 	 *	 ]
500 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
501 	 * [out] memref[2] = (struct pkcs11_object_head)attribs + attributes
502 	 *                   data
503 	 *
504 	 * This command relates to the PKCS#11 API function C_GetAttributeValue.
505 	 * Caller provides an attribute template as 3rd argument in memref[0]
506 	 * (referred here as attribs + attributes data). Upon successful
507 	 * completion, the TA returns the provided template filled with expected
508 	 * data through output argument memref[2] (referred here again as
509 	 * attribs + attributes data).
510 	 */
511 	PKCS11_CMD_GET_ATTRIBUTE_VALUE = 38,
512 
513 	/*
514 	 * PKCS11_CMD_SET_ATTRIBUTE_VALUE - Set the value of object attribute(s)
515 	 *
516 	 * [in]  memref[0] = [
517 	 *              32bit session handle,
518 	 *              32bit object handle,
519 	 *              (struct pkcs11_object_head)attribs + attributes data
520 	 *	 ]
521 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
522 	 *
523 	 * This command relates to the PKCS#11 API function C_SetAttributeValue.
524 	 * Caller provides an attribute template as 3rd argument in memref[0]
525 	 * (referred here as attribs + attributes data).
526 	 */
527 	PKCS11_CMD_SET_ATTRIBUTE_VALUE = 39,
528 
529 	/*
530 	 * PKCS11_CMD_COPY_OBJECT - Copies an object, creating a new object for
531 	 *			    the copy.
532 	 *
533 	 * [in]  memref[0] = [
534 	 *              32bit session handle,
535 	 *              32bit object handle,
536 	 *              (struct pkcs11_object_head)attribs + attributes data
537 	 *	 ]
538 	 * [out] memref[0] = 32bit return code, enum pkcs11_rc
539 	 * [out] memref[2] = 32bit object handle
540 	 *
541 	 * This command relates to the PKCS#11 API function C_CopyObject().
542 	 * Caller provides an attribute template as 3rd argument in memref[0]
543 	 * (referred here as attribs + attributes data).
544 	 */
545 	PKCS11_CMD_COPY_OBJECT = 40,
546 
547 };
548 
549 /*
550  * Command return codes
551  * PKCS11_<x> relates CryptoKi client API CKR_<x>
552  */
553 enum pkcs11_rc {
554 	PKCS11_CKR_OK				= 0,
555 	PKCS11_CKR_CANCEL			= 0x0001,
556 	PKCS11_CKR_SLOT_ID_INVALID		= 0x0003,
557 	PKCS11_CKR_GENERAL_ERROR		= 0x0005,
558 	PKCS11_CKR_FUNCTION_FAILED		= 0x0006,
559 	PKCS11_CKR_ARGUMENTS_BAD		= 0x0007,
560 	PKCS11_CKR_ATTRIBUTE_READ_ONLY		= 0x0010,
561 	PKCS11_CKR_ATTRIBUTE_SENSITIVE		= 0x0011,
562 	PKCS11_CKR_ATTRIBUTE_TYPE_INVALID	= 0x0012,
563 	PKCS11_CKR_ATTRIBUTE_VALUE_INVALID	= 0x0013,
564 	PKCS11_CKR_ACTION_PROHIBITED		= 0x001b,
565 	PKCS11_CKR_DATA_INVALID			= 0x0020,
566 	PKCS11_CKR_DATA_LEN_RANGE		= 0x0021,
567 	PKCS11_CKR_DEVICE_ERROR			= 0x0030,
568 	PKCS11_CKR_DEVICE_MEMORY		= 0x0031,
569 	PKCS11_CKR_DEVICE_REMOVED		= 0x0032,
570 	PKCS11_CKR_ENCRYPTED_DATA_INVALID	= 0x0040,
571 	PKCS11_CKR_ENCRYPTED_DATA_LEN_RANGE	= 0x0041,
572 	PKCS11_CKR_KEY_HANDLE_INVALID		= 0x0060,
573 	PKCS11_CKR_KEY_SIZE_RANGE		= 0x0062,
574 	PKCS11_CKR_KEY_TYPE_INCONSISTENT	= 0x0063,
575 	PKCS11_CKR_KEY_FUNCTION_NOT_PERMITTED	= 0x0068,
576 	PKCS11_CKR_KEY_NOT_WRAPPABLE		= 0x0069,
577 	PKCS11_CKR_KEY_UNEXTRACTABLE		= 0x006a,
578 	PKCS11_CKR_MECHANISM_INVALID		= 0x0070,
579 	PKCS11_CKR_MECHANISM_PARAM_INVALID	= 0x0071,
580 	PKCS11_CKR_OBJECT_HANDLE_INVALID	= 0x0082,
581 	PKCS11_CKR_OPERATION_ACTIVE		= 0x0090,
582 	PKCS11_CKR_OPERATION_NOT_INITIALIZED	= 0x0091,
583 	PKCS11_CKR_PIN_INCORRECT		= 0x00a0,
584 	PKCS11_CKR_PIN_INVALID			= 0x00a1,
585 	PKCS11_CKR_PIN_LEN_RANGE		= 0x00a2,
586 	PKCS11_CKR_PIN_EXPIRED			= 0x00a3,
587 	PKCS11_CKR_PIN_LOCKED			= 0x00a4,
588 	PKCS11_CKR_SESSION_CLOSED		= 0x00b0,
589 	PKCS11_CKR_SESSION_COUNT		= 0x00b1,
590 	PKCS11_CKR_SESSION_HANDLE_INVALID	= 0x00b3,
591 	PKCS11_CKR_SESSION_PARALLEL_NOT_SUPPORTED = 0x00b4,
592 	PKCS11_CKR_SESSION_READ_ONLY		= 0x00b5,
593 	PKCS11_CKR_SESSION_EXISTS		= 0x00b6,
594 	PKCS11_CKR_SESSION_READ_ONLY_EXISTS	= 0x00b7,
595 	PKCS11_CKR_SESSION_READ_WRITE_SO_EXISTS	= 0x00b8,
596 	PKCS11_CKR_SIGNATURE_INVALID		= 0x00c0,
597 	PKCS11_CKR_SIGNATURE_LEN_RANGE		= 0x00c1,
598 	PKCS11_CKR_TEMPLATE_INCOMPLETE		= 0x00d0,
599 	PKCS11_CKR_TEMPLATE_INCONSISTENT	= 0x00d1,
600 	PKCS11_CKR_TOKEN_NOT_PRESENT		= 0x00e0,
601 	PKCS11_CKR_TOKEN_NOT_RECOGNIZED		= 0x00e1,
602 	PKCS11_CKR_TOKEN_WRITE_PROTECTED	= 0x00e2,
603 	PKCS11_CKR_USER_ALREADY_LOGGED_IN	= 0x0100,
604 	PKCS11_CKR_USER_NOT_LOGGED_IN		= 0x0101,
605 	PKCS11_CKR_USER_PIN_NOT_INITIALIZED	= 0x0102,
606 	PKCS11_CKR_USER_TYPE_INVALID		= 0x0103,
607 	PKCS11_CKR_USER_ANOTHER_ALREADY_LOGGED_IN = 0x0104,
608 	PKCS11_CKR_USER_TOO_MANY_TYPES		= 0x0105,
609 	PKCS11_CKR_DOMAIN_PARAMS_INVALID	= 0x0130,
610 	PKCS11_CKR_CURVE_NOT_SUPPORTED		= 0x0140,
611 	PKCS11_CKR_BUFFER_TOO_SMALL		= 0x0150,
612 	PKCS11_CKR_SAVED_STATE_INVALID		= 0x0160,
613 	PKCS11_CKR_INFORMATION_SENSITIVE	= 0x0170,
614 	PKCS11_CKR_STATE_UNSAVEABLE		= 0x0180,
615 	PKCS11_CKR_PIN_TOO_WEAK			= 0x01b8,
616 	PKCS11_CKR_PUBLIC_KEY_INVALID		= 0x01b9,
617 	PKCS11_CKR_FUNCTION_REJECTED		= 0x0200,
618 	/* Vendor specific IDs not returned to client */
619 	PKCS11_RV_NOT_FOUND			= 0x80000000,
620 	PKCS11_RV_NOT_IMPLEMENTED		= 0x80000001,
621 };
622 
623 /*
624  * Arguments for PKCS11_CMD_SLOT_INFO
625  */
626 #define PKCS11_SLOT_DESC_SIZE			64
627 #define PKCS11_SLOT_MANUFACTURER_SIZE		32
628 #define PKCS11_SLOT_VERSION_SIZE		2
629 
630 struct pkcs11_slot_info {
631 	uint8_t slot_description[PKCS11_SLOT_DESC_SIZE];
632 	uint8_t manufacturer_id[PKCS11_SLOT_MANUFACTURER_SIZE];
633 	uint32_t flags;
634 	uint8_t hardware_version[PKCS11_SLOT_VERSION_SIZE];
635 	uint8_t firmware_version[PKCS11_SLOT_VERSION_SIZE];
636 };
637 
638 /*
639  * Values for pkcs11_slot_info::flags.
640  * PKCS11_CKFS_<x> reflects CryptoKi client API slot flags CKF_<x>.
641  */
642 #define PKCS11_CKFS_TOKEN_PRESENT		(1U << 0)
643 #define PKCS11_CKFS_REMOVABLE_DEVICE		(1U << 1)
644 #define PKCS11_CKFS_HW_SLOT			(1U << 2)
645 
646 /*
647  * Arguments for PKCS11_CMD_TOKEN_INFO
648  */
649 #define PKCS11_TOKEN_LABEL_SIZE			32
650 #define PKCS11_TOKEN_MANUFACTURER_SIZE		32
651 #define PKCS11_TOKEN_MODEL_SIZE			16
652 #define PKCS11_TOKEN_SERIALNUM_SIZE		16
653 
654 struct pkcs11_token_info {
655 	uint8_t label[PKCS11_TOKEN_LABEL_SIZE];
656 	uint8_t manufacturer_id[PKCS11_TOKEN_MANUFACTURER_SIZE];
657 	uint8_t model[PKCS11_TOKEN_MODEL_SIZE];
658 	uint8_t serial_number[PKCS11_TOKEN_SERIALNUM_SIZE];
659 	uint32_t flags;
660 	uint32_t max_session_count;
661 	uint32_t session_count;
662 	uint32_t max_rw_session_count;
663 	uint32_t rw_session_count;
664 	uint32_t max_pin_len;
665 	uint32_t min_pin_len;
666 	uint32_t total_public_memory;
667 	uint32_t free_public_memory;
668 	uint32_t total_private_memory;
669 	uint32_t free_private_memory;
670 	uint8_t hardware_version[2];
671 	uint8_t firmware_version[2];
672 	uint8_t utc_time[16];
673 };
674 
675 /*
676  * Values for pkcs11_token_info::flags.
677  * PKCS11_CKFT_<x> reflects CryptoKi client API token flags CKF_<x>.
678  */
679 #define PKCS11_CKFT_RNG					(1U << 0)
680 #define PKCS11_CKFT_WRITE_PROTECTED			(1U << 1)
681 #define PKCS11_CKFT_LOGIN_REQUIRED			(1U << 2)
682 #define PKCS11_CKFT_USER_PIN_INITIALIZED		(1U << 3)
683 #define PKCS11_CKFT_RESTORE_KEY_NOT_NEEDED		(1U << 5)
684 #define PKCS11_CKFT_CLOCK_ON_TOKEN			(1U << 6)
685 #define PKCS11_CKFT_PROTECTED_AUTHENTICATION_PATH	(1U << 8)
686 #define PKCS11_CKFT_DUAL_CRYPTO_OPERATIONS		(1U << 9)
687 #define PKCS11_CKFT_TOKEN_INITIALIZED			(1U << 10)
688 #define PKCS11_CKFT_SECONDARY_AUTHENTICATION		(1U << 11)
689 #define PKCS11_CKFT_USER_PIN_COUNT_LOW			(1U << 16)
690 #define PKCS11_CKFT_USER_PIN_FINAL_TRY			(1U << 17)
691 #define PKCS11_CKFT_USER_PIN_LOCKED			(1U << 18)
692 #define PKCS11_CKFT_USER_PIN_TO_BE_CHANGED		(1U << 19)
693 #define PKCS11_CKFT_SO_PIN_COUNT_LOW			(1U << 20)
694 #define PKCS11_CKFT_SO_PIN_FINAL_TRY			(1U << 21)
695 #define PKCS11_CKFT_SO_PIN_LOCKED			(1U << 22)
696 #define PKCS11_CKFT_SO_PIN_TO_BE_CHANGED		(1U << 23)
697 #define PKCS11_CKFT_ERROR_STATE				(1U << 24)
698 
699 /* Values for user identity */
700 enum pkcs11_user_type {
701 	PKCS11_CKU_SO = 0x000,
702 	PKCS11_CKU_USER = 0x001,
703 	PKCS11_CKU_CONTEXT_SPECIFIC = 0x002,
704 };
705 
706 /*
707  * TEE Identity based authentication for tokens
708  *
709  * When configuration CFG_PKCS11_TA_AUTH_TEE_IDENTITY is enabled TEE Identity
710  * based authentication scheme is enabled.
711  *
712  * Feature enablement per token basis is controlled by token flag:
713  * pkcs11_token_info->flags & PKCS11_CKFT_PROTECTED_AUTHENTICATION_PATH
714  *
715  * When calling C_InitToken() mode is determined based on SO PIN value.
716  * - If the PIN is empty (or NULL_PTR) then active client TEE Identity will be
717  *   used as SO TEE Identity
718  * - If the PIN is given then normal PIN behavior is used
719  *
720  * Once TEE Identity based authentication is activated following operational
721  * changes happen:
722  * - PIN failure counters are disabled to prevent token authentication lockups
723  * - Switching to different authentication mode needs C_InitToken()
724  * - When C_Login() or so is performed actual PIN value is ignored and active
725  *   client TEE Identity will be used
726  *
727  * Different types of TEE Identity authentication methods can be configured:
728  * - Configured with C_InitToken(), C_InitPIN() or by C_SetPIN()
729  * - PIN value follows below PIN syntax
730  *
731  * TEE Identity based authenticate PIN syntax:
732  * - PIN value: NULL_PTR or empty
733  *   - Use active client TEE Identity
734  * - PIN value: public
735  *   - TEE public login
736  * - PIN value: user:<client UUID string>
737  *   - TEE user login with client UUID matching user credentials
738  * - PIN value: group:<client UUID string>
739  *   - TEE group login with client UUID matching group credentials
740  */
741 
742 /* Keywords for protected authenticated path PIN parser */
743 #define PKCS11_AUTH_TEE_IDENTITY_PUBLIC	"public"
744 #define PKCS11_AUTH_TEE_IDENTITY_USER	"user:"
745 #define PKCS11_AUTH_TEE_IDENTITY_GROUP	"group:"
746 
747 /*
748  * Values for 32bit session flags argument to PKCS11_CMD_OPEN_SESSION
749  * and pkcs11_session_info::flags.
750  * PKCS11_CKFSS_<x> reflects CryptoKi client API session flags CKF_<x>.
751  */
752 #define PKCS11_CKFSS_RW_SESSION				(1U << 1)
753 #define PKCS11_CKFSS_SERIAL_SESSION			(1U << 2)
754 
755 /*
756  * Arguments for PKCS11_CMD_SESSION_INFO
757  */
758 
759 struct pkcs11_session_info {
760 	uint32_t slot_id;
761 	uint32_t state;
762 	uint32_t flags;
763 	uint32_t device_error;
764 };
765 
766 /* Valid values for pkcs11_session_info::state */
767 enum pkcs11_session_state {
768 	PKCS11_CKS_RO_PUBLIC_SESSION = 0,
769 	PKCS11_CKS_RO_USER_FUNCTIONS = 1,
770 	PKCS11_CKS_RW_PUBLIC_SESSION = 2,
771 	PKCS11_CKS_RW_USER_FUNCTIONS = 3,
772 	PKCS11_CKS_RW_SO_FUNCTIONS = 4,
773 };
774 
775 /*
776  * Arguments for PKCS11_CMD_MECHANISM_INFO
777  */
778 
779 struct pkcs11_mechanism_info {
780 	uint32_t min_key_size;
781 	uint32_t max_key_size;
782 	uint32_t flags;
783 };
784 
785 /*
786  * Values for pkcs11_mechanism_info::flags.
787  * PKCS11_CKFM_<x> reflects CryptoKi client API mechanism flags CKF_<x>.
788  */
789 #define PKCS11_CKFM_HW				(1U << 0)
790 #define PKCS11_CKFM_ENCRYPT			(1U << 8)
791 #define PKCS11_CKFM_DECRYPT			(1U << 9)
792 #define PKCS11_CKFM_DIGEST			(1U << 10)
793 #define PKCS11_CKFM_SIGN			(1U << 11)
794 #define PKCS11_CKFM_SIGN_RECOVER		(1U << 12)
795 #define PKCS11_CKFM_VERIFY			(1U << 13)
796 #define PKCS11_CKFM_VERIFY_RECOVER		(1U << 14)
797 #define PKCS11_CKFM_GENERATE			(1U << 15)
798 #define PKCS11_CKFM_GENERATE_KEY_PAIR		(1U << 16)
799 #define PKCS11_CKFM_WRAP			(1U << 17)
800 #define PKCS11_CKFM_UNWRAP			(1U << 18)
801 #define PKCS11_CKFM_DERIVE			(1U << 19)
802 #define PKCS11_CKFM_EC_F_P			(1U << 20)
803 #define PKCS11_CKFM_EC_F_2M			(1U << 21)
804 #define PKCS11_CKFM_EC_ECPARAMETERS		(1U << 22)
805 #define PKCS11_CKFM_EC_NAMEDCURVE		(1U << 23)
806 #define PKCS11_CKFM_EC_UNCOMPRESS		(1U << 24)
807 #define PKCS11_CKFM_EC_COMPRESS			(1U << 25)
808 
809 /*
810  * pkcs11_object_head - Header of object whose data are serialized in memory
811  *
812  * An object is made of several attributes. Attributes are stored one next to
813  * the other with byte alignment as a serialized byte array. The byte array
814  * of serialized attributes is prepended with the size of the attrs[] array
815  * in bytes and the number of attributes in the array, yielding the struct
816  * pkcs11_object_head.
817  *
818  * @attrs_size - byte size of whole byte array attrs[]
819  * @attrs_count - number of attribute items stored in attrs[]
820  * @attrs - then starts the attributes data
821  */
822 struct pkcs11_object_head {
823 	uint32_t attrs_size;
824 	uint32_t attrs_count;
825 	uint8_t attrs[];
826 };
827 
828 /*
829  * Attribute reference in the TA ABI. Each attribute starts with a header
830  * structure followed by the attribute value. The attribute byte size is
831  * defined in the attribute header.
832  *
833  * @id - the 32bit identifier of the attribute, see PKCS11_CKA_<x>
834  * @size - the 32bit value attribute byte size
835  * @data - then starts the attribute value
836  */
837 struct pkcs11_attribute_head {
838 	uint32_t id;
839 	uint32_t size;
840 	uint8_t data[];
841 };
842 
843 /*
844  * Attribute identification IDs as of v2.40 excluding deprecated IDs.
845  * Valid values for struct pkcs11_attribute_head::id
846  * PKCS11_CKA_<x> reflects CryptoKi client API attribute IDs CKA_<x>.
847  */
848 enum pkcs11_attr_id {
849 	PKCS11_CKA_CLASS			= 0x0000,
850 	PKCS11_CKA_TOKEN			= 0x0001,
851 	PKCS11_CKA_PRIVATE			= 0x0002,
852 	PKCS11_CKA_LABEL			= 0x0003,
853 	PKCS11_CKA_APPLICATION			= 0x0010,
854 	PKCS11_CKA_VALUE			= 0x0011,
855 	PKCS11_CKA_OBJECT_ID			= 0x0012,
856 	PKCS11_CKA_CERTIFICATE_TYPE		= 0x0080,
857 	PKCS11_CKA_ISSUER			= 0x0081,
858 	PKCS11_CKA_SERIAL_NUMBER		= 0x0082,
859 	PKCS11_CKA_AC_ISSUER			= 0x0083,
860 	PKCS11_CKA_OWNER			= 0x0084,
861 	PKCS11_CKA_ATTR_TYPES			= 0x0085,
862 	PKCS11_CKA_TRUSTED			= 0x0086,
863 	PKCS11_CKA_CERTIFICATE_CATEGORY		= 0x0087,
864 	PKCS11_CKA_JAVA_MIDP_SECURITY_DOMAIN	= 0x0088,
865 	PKCS11_CKA_URL				= 0x0089,
866 	PKCS11_CKA_HASH_OF_SUBJECT_PUBLIC_KEY	= 0x008a,
867 	PKCS11_CKA_HASH_OF_ISSUER_PUBLIC_KEY	= 0x008b,
868 	PKCS11_CKA_NAME_HASH_ALGORITHM		= 0x008c,
869 	PKCS11_CKA_CHECK_VALUE			= 0x0090,
870 	PKCS11_CKA_KEY_TYPE			= 0x0100,
871 	PKCS11_CKA_SUBJECT			= 0x0101,
872 	PKCS11_CKA_ID				= 0x0102,
873 	PKCS11_CKA_SENSITIVE			= 0x0103,
874 	PKCS11_CKA_ENCRYPT			= 0x0104,
875 	PKCS11_CKA_DECRYPT			= 0x0105,
876 	PKCS11_CKA_WRAP				= 0x0106,
877 	PKCS11_CKA_UNWRAP			= 0x0107,
878 	PKCS11_CKA_SIGN				= 0x0108,
879 	PKCS11_CKA_SIGN_RECOVER			= 0x0109,
880 	PKCS11_CKA_VERIFY			= 0x010a,
881 	PKCS11_CKA_VERIFY_RECOVER		= 0x010b,
882 	PKCS11_CKA_DERIVE			= 0x010c,
883 	PKCS11_CKA_START_DATE			= 0x0110,
884 	PKCS11_CKA_END_DATE			= 0x0111,
885 	PKCS11_CKA_MODULUS			= 0x0120,
886 	PKCS11_CKA_MODULUS_BITS			= 0x0121,
887 	PKCS11_CKA_PUBLIC_EXPONENT		= 0x0122,
888 	PKCS11_CKA_PRIVATE_EXPONENT		= 0x0123,
889 	PKCS11_CKA_PRIME_1			= 0x0124,
890 	PKCS11_CKA_PRIME_2			= 0x0125,
891 	PKCS11_CKA_EXPONENT_1			= 0x0126,
892 	PKCS11_CKA_EXPONENT_2			= 0x0127,
893 	PKCS11_CKA_COEFFICIENT			= 0x0128,
894 	PKCS11_CKA_PUBLIC_KEY_INFO		= 0x0129,
895 	PKCS11_CKA_PRIME			= 0x0130,
896 	PKCS11_CKA_SUBPRIME			= 0x0131,
897 	PKCS11_CKA_BASE				= 0x0132,
898 	PKCS11_CKA_PRIME_BITS			= 0x0133,
899 	PKCS11_CKA_SUBPRIME_BITS		= 0x0134,
900 	PKCS11_CKA_VALUE_BITS			= 0x0160,
901 	PKCS11_CKA_VALUE_LEN			= 0x0161,
902 	PKCS11_CKA_EXTRACTABLE			= 0x0162,
903 	PKCS11_CKA_LOCAL			= 0x0163,
904 	PKCS11_CKA_NEVER_EXTRACTABLE		= 0x0164,
905 	PKCS11_CKA_ALWAYS_SENSITIVE		= 0x0165,
906 	PKCS11_CKA_KEY_GEN_MECHANISM		= 0x0166,
907 	PKCS11_CKA_MODIFIABLE			= 0x0170,
908 	PKCS11_CKA_COPYABLE			= 0x0171,
909 	PKCS11_CKA_DESTROYABLE			= 0x0172,
910 	PKCS11_CKA_EC_PARAMS			= 0x0180,
911 	PKCS11_CKA_EC_POINT			= 0x0181,
912 	PKCS11_CKA_ALWAYS_AUTHENTICATE		= 0x0202,
913 	PKCS11_CKA_WRAP_WITH_TRUSTED		= 0x0210,
914 	/*
915 	 * The leading 4 comes from the PKCS#11 spec or:ing with
916 	 * CKF_ARRAY_ATTRIBUTE = 0x40000000.
917 	 */
918 	PKCS11_CKA_WRAP_TEMPLATE		= 0x40000211,
919 	PKCS11_CKA_UNWRAP_TEMPLATE		= 0x40000212,
920 	PKCS11_CKA_DERIVE_TEMPLATE		= 0x40000213,
921 	PKCS11_CKA_OTP_FORMAT			= 0x0220,
922 	PKCS11_CKA_OTP_LENGTH			= 0x0221,
923 	PKCS11_CKA_OTP_TIME_INTERVAL		= 0x0222,
924 	PKCS11_CKA_OTP_USER_FRIENDLY_MODE	= 0x0223,
925 	PKCS11_CKA_OTP_CHALLENGE_REQUIREMENT	= 0x0224,
926 	PKCS11_CKA_OTP_TIME_REQUIREMENT		= 0x0225,
927 	PKCS11_CKA_OTP_COUNTER_REQUIREMENT	= 0x0226,
928 	PKCS11_CKA_OTP_PIN_REQUIREMENT		= 0x0227,
929 	PKCS11_CKA_OTP_COUNTER			= 0x022e,
930 	PKCS11_CKA_OTP_TIME			= 0x022f,
931 	PKCS11_CKA_OTP_USER_IDENTIFIER		= 0x022a,
932 	PKCS11_CKA_OTP_SERVICE_IDENTIFIER	= 0x022b,
933 	PKCS11_CKA_OTP_SERVICE_LOGO		= 0x022c,
934 	PKCS11_CKA_OTP_SERVICE_LOGO_TYPE	= 0x022d,
935 	PKCS11_CKA_GOSTR3410_PARAMS		= 0x0250,
936 	PKCS11_CKA_GOSTR3411_PARAMS		= 0x0251,
937 	PKCS11_CKA_GOST28147_PARAMS		= 0x0252,
938 	PKCS11_CKA_HW_FEATURE_TYPE		= 0x0300,
939 	PKCS11_CKA_RESET_ON_INIT		= 0x0301,
940 	PKCS11_CKA_HAS_RESET			= 0x0302,
941 	PKCS11_CKA_PIXEL_X			= 0x0400,
942 	PKCS11_CKA_PIXEL_Y			= 0x0401,
943 	PKCS11_CKA_RESOLUTION			= 0x0402,
944 	PKCS11_CKA_CHAR_ROWS			= 0x0403,
945 	PKCS11_CKA_CHAR_COLUMNS			= 0x0404,
946 	PKCS11_CKA_COLOR			= 0x0405,
947 	PKCS11_CKA_BITS_PER_PIXEL		= 0x0406,
948 	PKCS11_CKA_CHAR_SETS			= 0x0480,
949 	PKCS11_CKA_ENCODING_METHODS		= 0x0481,
950 	PKCS11_CKA_MIME_TYPES			= 0x0482,
951 	PKCS11_CKA_MECHANISM_TYPE		= 0x0500,
952 	PKCS11_CKA_REQUIRED_CMS_ATTRIBUTES	= 0x0501,
953 	PKCS11_CKA_DEFAULT_CMS_ATTRIBUTES	= 0x0502,
954 	PKCS11_CKA_SUPPORTED_CMS_ATTRIBUTES	= 0x0503,
955 	/*
956 	 * The leading 4 comes from the PKCS#11 spec or:ing with
957 	 * CKF_ARRAY_ATTRIBUTE = 0x40000000.
958 	 */
959 	PKCS11_CKA_ALLOWED_MECHANISMS		= 0x40000600,
960 	/* Vendor extension: reserved for undefined ID (~0U) */
961 	PKCS11_CKA_UNDEFINED_ID			= PKCS11_UNDEFINED_ID,
962 };
963 
964 /*
965  * Valid values for attribute PKCS11_CKA_CLASS
966  * PKCS11_CKO_<x> reflects CryptoKi client API object class IDs CKO_<x>.
967  */
968 enum pkcs11_class_id {
969 	PKCS11_CKO_DATA				= 0x000,
970 	PKCS11_CKO_CERTIFICATE			= 0x001,
971 	PKCS11_CKO_PUBLIC_KEY			= 0x002,
972 	PKCS11_CKO_PRIVATE_KEY			= 0x003,
973 	PKCS11_CKO_SECRET_KEY			= 0x004,
974 	PKCS11_CKO_HW_FEATURE			= 0x005,
975 	PKCS11_CKO_DOMAIN_PARAMETERS		= 0x006,
976 	PKCS11_CKO_MECHANISM			= 0x007,
977 	PKCS11_CKO_OTP_KEY			= 0x008,
978 	/* Vendor extension: reserved for undefined ID (~0U) */
979 	PKCS11_CKO_UNDEFINED_ID			= PKCS11_UNDEFINED_ID,
980 };
981 
982 /*
983  * Valid values for attribute PKCS11_CKA_KEY_TYPE
984  * PKCS11_CKK_<x> reflects CryptoKi client API key type IDs CKK_<x>.
985  * Note that this is only a subset of the PKCS#11 specification.
986  */
987 enum pkcs11_key_type {
988 	PKCS11_CKK_RSA				= 0x000,
989 	PKCS11_CKK_DSA				= 0x001,
990 	PKCS11_CKK_DH				= 0x002,
991 	PKCS11_CKK_EC				= 0x003,
992 	PKCS11_CKK_GENERIC_SECRET		= 0x010,
993 	PKCS11_CKK_AES				= 0x01f,
994 	PKCS11_CKK_MD5_HMAC			= 0x027,
995 	PKCS11_CKK_SHA_1_HMAC			= 0x028,
996 	PKCS11_CKK_SHA256_HMAC			= 0x02b,
997 	PKCS11_CKK_SHA384_HMAC			= 0x02c,
998 	PKCS11_CKK_SHA512_HMAC			= 0x02d,
999 	PKCS11_CKK_SHA224_HMAC			= 0x02e,
1000 	/* Vendor extension: reserved for undefined ID (~0U) */
1001 	PKCS11_CKK_UNDEFINED_ID			= PKCS11_UNDEFINED_ID,
1002 };
1003 
1004 /*
1005  * Valid values for mechanism IDs
1006  * PKCS11_CKM_<x> reflects CryptoKi client API mechanism IDs CKM_<x>.
1007  * Note that this will be extended as needed.
1008  */
1009 enum pkcs11_mechanism_id {
1010 	PKCS11_CKM_MD5_HMAC			= 0x00211,
1011 	PKCS11_CKM_SHA_1_HMAC			= 0x00221,
1012 	PKCS11_CKM_SHA256_HMAC			= 0x00251,
1013 	PKCS11_CKM_SHA224_HMAC			= 0x00256,
1014 	PKCS11_CKM_SHA384_HMAC			= 0x00261,
1015 	PKCS11_CKM_SHA512_HMAC			= 0x00271,
1016 	PKCS11_CKM_GENERIC_SECRET_KEY_GEN	= 0x00350,
1017 	PKCS11_CKM_AES_KEY_GEN			= 0x01080,
1018 	PKCS11_CKM_AES_ECB			= 0x01081,
1019 	PKCS11_CKM_AES_CBC			= 0x01082,
1020 	PKCS11_CKM_AES_CBC_PAD			= 0x01085,
1021 	PKCS11_CKM_AES_CTR			= 0x01086,
1022 	PKCS11_CKM_AES_CTS			= 0x01089,
1023 	PKCS11_CKM_AES_ECB_ENCRYPT_DATA		= 0x01104,
1024 	PKCS11_CKM_AES_CBC_ENCRYPT_DATA		= 0x01105,
1025 	/*
1026 	 * Vendor extensions below.
1027 	 * PKCS11 added IDs for operation not related to a CK mechanism ID
1028 	 */
1029 	PKCS11_PROCESSING_IMPORT		= 0x80000000,
1030 	PKCS11_CKM_UNDEFINED_ID			= PKCS11_UNDEFINED_ID,
1031 };
1032 #endif /*PKCS11_TA_H*/
1033