xref: /optee_os/ta/pkcs11/src/processing.h (revision 3ddd5cd700ed03e2265c9c3286697fd3c395a7bc)
1 /* SPDX-License-Identifier: BSD-2-Clause */
2 /*
3  * Copyright (c) 2017-2020, Linaro Limited
4  */
5 
6 #ifndef PKCS11_TA_PROCESSING_H
7 #define PKCS11_TA_PROCESSING_H
8 
9 #include <pkcs11_attributes.h>
10 #include <tee_internal_api.h>
11 
12 struct pkcs11_client;
13 struct pkcs11_session;
14 struct pkcs11_object;
15 struct active_processing;
16 
17 /*
18  * Entry points from PKCS11 TA invocation commands
19  */
20 
21 enum pkcs11_rc entry_generate_secret(struct pkcs11_client *client,
22 				     uint32_t ptypes, TEE_Param *params);
23 
24 enum pkcs11_rc entry_generate_key_pair(struct pkcs11_client *client,
25 				       uint32_t ptypes, TEE_Param *params);
26 
27 enum pkcs11_rc entry_processing_init(struct pkcs11_client *client,
28 				     uint32_t ptypes, TEE_Param *params,
29 				     enum processing_func function);
30 
31 enum pkcs11_rc entry_processing_step(struct pkcs11_client *client,
32 				     uint32_t ptypes, TEE_Param *params,
33 				     enum processing_func function,
34 				     enum processing_step step);
35 
36 enum pkcs11_rc entry_processing_key(struct pkcs11_client *client,
37 				    uint32_t ptypes, TEE_Param *params,
38 				    enum processing_func function);
39 
40 enum pkcs11_rc entry_release_active_processing(struct pkcs11_client *client,
41 					       uint32_t ptypes,
42 					       TEE_Param *params);
43 
44 /*
45  * Util
46  */
47 size_t get_object_key_bit_size(struct pkcs11_object *obj);
48 
49 void release_active_processing(struct pkcs11_session *session);
50 
51 enum pkcs11_rc alloc_get_tee_attribute_data(TEE_ObjectHandle tee_obj,
52 					    uint32_t attribute,
53 					    void **data, size_t *size);
54 
55 enum pkcs11_rc tee2pkcs_add_attribute(struct obj_attrs **head,
56 				      uint32_t pkcs11_id,
57 				      TEE_ObjectHandle tee_obj,
58 				      uint32_t tee_id);
59 
60 /* Asymmetric key operations util */
61 bool processing_is_tee_asymm(uint32_t proc_id);
62 
63 enum pkcs11_rc init_asymm_operation(struct pkcs11_session *session,
64 				    enum processing_func function,
65 				    struct pkcs11_attribute_head *proc_params,
66 				    struct pkcs11_object *obj);
67 
68 enum pkcs11_rc step_asymm_operation(struct pkcs11_session *session,
69 				    enum processing_func function,
70 				    enum processing_step step,
71 				    uint32_t ptypes, TEE_Param *params);
72 
73 /*
74  * Symmetric crypto algorithm specific functions
75  */
76 bool processing_is_tee_symm(uint32_t proc_id);
77 
78 enum pkcs11_rc init_symm_operation(struct pkcs11_session *session,
79 				   enum processing_func function,
80 				   struct pkcs11_attribute_head *proc_params,
81 				   struct pkcs11_object *key);
82 
83 enum pkcs11_rc step_symm_operation(struct pkcs11_session *session,
84 				   enum processing_func function,
85 				   enum processing_step step,
86 				   uint32_t ptypes, TEE_Param *params);
87 
88 enum pkcs11_rc tee_init_ctr_operation(struct active_processing *processing,
89 				      void *proc_params, size_t params_size);
90 
91 enum pkcs11_rc derive_key_by_symm_enc(struct pkcs11_session *session,
92 				      void **out_buf, uint32_t *out_sz);
93 
94 /* Digest specific functions */
95 bool processing_is_tee_digest(enum pkcs11_mechanism_id mecha_id);
96 
97 enum pkcs11_rc
98 init_digest_operation(struct pkcs11_session *session,
99 		      struct pkcs11_attribute_head *proc_params);
100 
101 enum pkcs11_rc step_digest_operation(struct pkcs11_session *session,
102 				     enum processing_step step,
103 				     struct pkcs11_object *obj,
104 				     uint32_t ptypes, TEE_Param *params);
105 
106 /*
107  * Elliptic curve crypto algorithm specific functions
108  */
109 enum pkcs11_rc load_tee_ec_key_attrs(TEE_Attribute **tee_attrs,
110 				     size_t *tee_count,
111 				     struct pkcs11_object *obj);
112 
113 size_t ec_params2tee_keysize(void *attr, size_t size);
114 
115 uint32_t ec_params2tee_curve(void *attr, size_t size);
116 
117 enum pkcs11_rc pkcs2tee_algo_ecdsa(uint32_t *tee_id,
118 				   struct pkcs11_attribute_head *proc_params,
119 				   struct pkcs11_object *obj);
120 
121 enum pkcs11_rc generate_ec_keys(struct pkcs11_attribute_head *proc_params,
122 				struct obj_attrs **pub_head,
123 				struct obj_attrs **priv_head);
124 
125 size_t ecdsa_get_input_max_byte_size(TEE_OperationHandle op);
126 
127 #endif /*PKCS11_TA_PROCESSING_H*/
128