Steven Cooreman | cd84cb4 | 2020-07-16 20:28:36 +0200 | [diff] [blame] | 1 | /* |
| 2 | * Function signatures for functionality that can be provided by |
| 3 | * cryptographic accelerators. |
Steven Cooreman | 56250fd | 2020-09-04 13:07:15 +0200 | [diff] [blame] | 4 | * Warning: This file will be auto-generated in the future. |
Steven Cooreman | cd84cb4 | 2020-07-16 20:28:36 +0200 | [diff] [blame] | 5 | */ |
Steven Cooreman | 2c7b2f8 | 2020-09-02 13:43:46 +0200 | [diff] [blame] | 6 | /* Copyright The Mbed TLS Contributors |
Steven Cooreman | cd84cb4 | 2020-07-16 20:28:36 +0200 | [diff] [blame] | 7 | * SPDX-License-Identifier: Apache-2.0 |
| 8 | * |
| 9 | * Licensed under the Apache License, Version 2.0 (the "License"); you may |
| 10 | * not use this file except in compliance with the License. |
| 11 | * You may obtain a copy of the License at |
| 12 | * |
| 13 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 14 | * |
| 15 | * Unless required by applicable law or agreed to in writing, software |
| 16 | * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT |
| 17 | * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 18 | * See the License for the specific language governing permissions and |
| 19 | * limitations under the License. |
Steven Cooreman | cd84cb4 | 2020-07-16 20:28:36 +0200 | [diff] [blame] | 20 | */ |
| 21 | |
| 22 | #ifndef PSA_CRYPTO_DRIVER_WRAPPERS_H |
| 23 | #define PSA_CRYPTO_DRIVER_WRAPPERS_H |
| 24 | |
| 25 | #include "psa/crypto.h" |
| 26 | #include "psa/crypto_driver_common.h" |
| 27 | |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 28 | /* |
| 29 | * Signature functions |
| 30 | */ |
gabor-mezei-arm | 50eac35 | 2021-04-22 11:32:19 +0200 | [diff] [blame] | 31 | psa_status_t psa_driver_wrapper_sign_message( |
| 32 | const psa_key_attributes_t *attributes, |
| 33 | const uint8_t *key_buffer, |
| 34 | size_t key_buffer_size, |
| 35 | psa_algorithm_t alg, |
| 36 | const uint8_t *input, |
| 37 | size_t input_length, |
| 38 | uint8_t *signature, |
| 39 | size_t signature_size, |
| 40 | size_t *signature_length ); |
| 41 | |
| 42 | psa_status_t psa_driver_wrapper_verify_message( |
| 43 | const psa_key_attributes_t *attributes, |
| 44 | const uint8_t *key_buffer, |
| 45 | size_t key_buffer_size, |
| 46 | psa_algorithm_t alg, |
| 47 | const uint8_t *input, |
| 48 | size_t input_length, |
| 49 | const uint8_t *signature, |
| 50 | size_t signature_length ); |
| 51 | |
Ronald Cron | 9f17aa4 | 2020-12-08 17:07:25 +0100 | [diff] [blame] | 52 | psa_status_t psa_driver_wrapper_sign_hash( |
| 53 | const psa_key_attributes_t *attributes, |
| 54 | const uint8_t *key_buffer, size_t key_buffer_size, |
| 55 | psa_algorithm_t alg, const uint8_t *hash, size_t hash_length, |
| 56 | uint8_t *signature, size_t signature_size, size_t *signature_length ); |
Steven Cooreman | cd84cb4 | 2020-07-16 20:28:36 +0200 | [diff] [blame] | 57 | |
Ronald Cron | 9f17aa4 | 2020-12-08 17:07:25 +0100 | [diff] [blame] | 58 | psa_status_t psa_driver_wrapper_verify_hash( |
| 59 | const psa_key_attributes_t *attributes, |
| 60 | const uint8_t *key_buffer, size_t key_buffer_size, |
| 61 | psa_algorithm_t alg, const uint8_t *hash, size_t hash_length, |
| 62 | const uint8_t *signature, size_t signature_length ); |
Steven Cooreman | 55ae217 | 2020-07-17 19:46:15 +0200 | [diff] [blame] | 63 | |
Steven Cooreman | 0452476 | 2020-10-13 17:43:44 +0200 | [diff] [blame] | 64 | /* |
| 65 | * Key handling functions |
| 66 | */ |
| 67 | |
Ronald Cron | 8328287 | 2020-11-22 14:02:39 +0100 | [diff] [blame] | 68 | psa_status_t psa_driver_wrapper_import_key( |
| 69 | const psa_key_attributes_t *attributes, |
| 70 | const uint8_t *data, size_t data_length, |
| 71 | uint8_t *key_buffer, size_t key_buffer_size, |
| 72 | size_t *key_buffer_length, size_t *bits ); |
Steven Cooreman | 0452476 | 2020-10-13 17:43:44 +0200 | [diff] [blame] | 73 | |
Ronald Cron | 6722798 | 2020-11-26 15:16:05 +0100 | [diff] [blame] | 74 | psa_status_t psa_driver_wrapper_export_key( |
| 75 | const psa_key_attributes_t *attributes, |
| 76 | const uint8_t *key_buffer, size_t key_buffer_size, |
| 77 | uint8_t *data, size_t data_size, size_t *data_length ); |
| 78 | |
Ronald Cron | 84cc994 | 2020-11-25 14:30:05 +0100 | [diff] [blame] | 79 | psa_status_t psa_driver_wrapper_export_public_key( |
| 80 | const psa_key_attributes_t *attributes, |
| 81 | const uint8_t *key_buffer, size_t key_buffer_size, |
| 82 | uint8_t *data, size_t data_size, size_t *data_length ); |
| 83 | |
Ronald Cron | 9df74be | 2020-12-05 19:15:23 +0100 | [diff] [blame] | 84 | psa_status_t psa_driver_wrapper_get_key_buffer_size( |
| 85 | const psa_key_attributes_t *attributes, |
| 86 | size_t *key_buffer_size ); |
| 87 | |
Archana | d8a83dc | 2021-06-14 10:04:16 +0530 | [diff] [blame] | 88 | psa_status_t psa_driver_wrapper_get_key_buffer_size_from_key_data( |
| 89 | const psa_key_attributes_t *attributes, |
| 90 | const uint8_t *data, |
| 91 | size_t data_length, |
| 92 | size_t *key_buffer_size ); |
| 93 | |
Ronald Cron | 84cc994 | 2020-11-25 14:30:05 +0100 | [diff] [blame] | 94 | psa_status_t psa_driver_wrapper_generate_key( |
| 95 | const psa_key_attributes_t *attributes, |
Ronald Cron | 977c247 | 2020-10-13 08:32:21 +0200 | [diff] [blame] | 96 | uint8_t *key_buffer, size_t key_buffer_size, size_t *key_buffer_length ); |
Steven Cooreman | b9b8442 | 2020-10-14 14:39:20 +0200 | [diff] [blame] | 97 | |
Steven Cooreman | 6801f08 | 2021-02-19 17:21:22 +0100 | [diff] [blame] | 98 | psa_status_t psa_driver_wrapper_get_builtin_key( |
| 99 | psa_drv_slot_number_t slot_number, |
| 100 | psa_key_attributes_t *attributes, |
| 101 | uint8_t *key_buffer, size_t key_buffer_size, size_t *key_buffer_length ); |
| 102 | |
Archana | 8a18036 | 2021-07-05 02:18:48 +0530 | [diff] [blame] | 103 | psa_status_t psa_driver_wrapper_copy_key( |
| 104 | psa_key_attributes_t *attributes, |
| 105 | const uint8_t *source_key, size_t source_key_size, |
Archana | 449608b | 2021-09-08 15:36:05 +0530 | [diff] [blame^] | 106 | uint8_t *target_key_buffer, size_t target_key_buffer_size, |
| 107 | size_t *target_key_buffer_length ); |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 108 | /* |
| 109 | * Cipher functions |
| 110 | */ |
| 111 | psa_status_t psa_driver_wrapper_cipher_encrypt( |
gabor-mezei-arm | a9449a0 | 2021-03-25 11:17:10 +0100 | [diff] [blame] | 112 | const psa_key_attributes_t *attributes, |
| 113 | const uint8_t *key_buffer, |
| 114 | size_t key_buffer_size, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 115 | psa_algorithm_t alg, |
| 116 | const uint8_t *input, |
| 117 | size_t input_length, |
| 118 | uint8_t *output, |
| 119 | size_t output_size, |
| 120 | size_t *output_length ); |
| 121 | |
| 122 | psa_status_t psa_driver_wrapper_cipher_decrypt( |
gabor-mezei-arm | a9449a0 | 2021-03-25 11:17:10 +0100 | [diff] [blame] | 123 | const psa_key_attributes_t *attributes, |
| 124 | const uint8_t *key_buffer, |
| 125 | size_t key_buffer_size, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 126 | psa_algorithm_t alg, |
| 127 | const uint8_t *input, |
| 128 | size_t input_length, |
| 129 | uint8_t *output, |
| 130 | size_t output_size, |
| 131 | size_t *output_length ); |
| 132 | |
| 133 | psa_status_t psa_driver_wrapper_cipher_encrypt_setup( |
Ronald Cron | a4af55f | 2020-12-14 14:36:06 +0100 | [diff] [blame] | 134 | psa_cipher_operation_t *operation, |
| 135 | const psa_key_attributes_t *attributes, |
| 136 | const uint8_t *key_buffer, size_t key_buffer_size, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 137 | psa_algorithm_t alg ); |
| 138 | |
| 139 | psa_status_t psa_driver_wrapper_cipher_decrypt_setup( |
Ronald Cron | a4af55f | 2020-12-14 14:36:06 +0100 | [diff] [blame] | 140 | psa_cipher_operation_t *operation, |
| 141 | const psa_key_attributes_t *attributes, |
| 142 | const uint8_t *key_buffer, size_t key_buffer_size, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 143 | psa_algorithm_t alg ); |
| 144 | |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 145 | psa_status_t psa_driver_wrapper_cipher_set_iv( |
Ronald Cron | 6056fe8 | 2020-12-15 13:58:07 +0100 | [diff] [blame] | 146 | psa_cipher_operation_t *operation, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 147 | const uint8_t *iv, |
| 148 | size_t iv_length ); |
| 149 | |
| 150 | psa_status_t psa_driver_wrapper_cipher_update( |
Ronald Cron | 6056fe8 | 2020-12-15 13:58:07 +0100 | [diff] [blame] | 151 | psa_cipher_operation_t *operation, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 152 | const uint8_t *input, |
| 153 | size_t input_length, |
| 154 | uint8_t *output, |
| 155 | size_t output_size, |
| 156 | size_t *output_length ); |
| 157 | |
| 158 | psa_status_t psa_driver_wrapper_cipher_finish( |
Ronald Cron | 6056fe8 | 2020-12-15 13:58:07 +0100 | [diff] [blame] | 159 | psa_cipher_operation_t *operation, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 160 | uint8_t *output, |
| 161 | size_t output_size, |
| 162 | size_t *output_length ); |
| 163 | |
| 164 | psa_status_t psa_driver_wrapper_cipher_abort( |
Ronald Cron | 6056fe8 | 2020-12-15 13:58:07 +0100 | [diff] [blame] | 165 | psa_cipher_operation_t *operation ); |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 166 | |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 167 | /* |
| 168 | * Hashing functions |
| 169 | */ |
| 170 | psa_status_t psa_driver_wrapper_hash_compute( |
| 171 | psa_algorithm_t alg, |
| 172 | const uint8_t *input, |
| 173 | size_t input_length, |
| 174 | uint8_t *hash, |
| 175 | size_t hash_size, |
| 176 | size_t *hash_length); |
| 177 | |
| 178 | psa_status_t psa_driver_wrapper_hash_setup( |
Steven Cooreman | dbf8ced | 2021-03-04 13:01:18 +0100 | [diff] [blame] | 179 | psa_hash_operation_t *operation, |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 180 | psa_algorithm_t alg ); |
| 181 | |
| 182 | psa_status_t psa_driver_wrapper_hash_clone( |
Steven Cooreman | dbf8ced | 2021-03-04 13:01:18 +0100 | [diff] [blame] | 183 | const psa_hash_operation_t *source_operation, |
| 184 | psa_hash_operation_t *target_operation ); |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 185 | |
| 186 | psa_status_t psa_driver_wrapper_hash_update( |
Steven Cooreman | dbf8ced | 2021-03-04 13:01:18 +0100 | [diff] [blame] | 187 | psa_hash_operation_t *operation, |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 188 | const uint8_t *input, |
| 189 | size_t input_length ); |
| 190 | |
| 191 | psa_status_t psa_driver_wrapper_hash_finish( |
Steven Cooreman | dbf8ced | 2021-03-04 13:01:18 +0100 | [diff] [blame] | 192 | psa_hash_operation_t *operation, |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 193 | uint8_t *hash, |
| 194 | size_t hash_size, |
| 195 | size_t *hash_length ); |
| 196 | |
| 197 | psa_status_t psa_driver_wrapper_hash_abort( |
Steven Cooreman | dbf8ced | 2021-03-04 13:01:18 +0100 | [diff] [blame] | 198 | psa_hash_operation_t *operation ); |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 199 | |
Ronald Cron | de82281 | 2021-03-17 16:08:20 +0100 | [diff] [blame] | 200 | /* |
| 201 | * AEAD functions |
| 202 | */ |
| 203 | |
| 204 | psa_status_t psa_driver_wrapper_aead_encrypt( |
| 205 | const psa_key_attributes_t *attributes, |
| 206 | const uint8_t *key_buffer, size_t key_buffer_size, |
| 207 | psa_algorithm_t alg, |
| 208 | const uint8_t *nonce, size_t nonce_length, |
| 209 | const uint8_t *additional_data, size_t additional_data_length, |
| 210 | const uint8_t *plaintext, size_t plaintext_length, |
| 211 | uint8_t *ciphertext, size_t ciphertext_size, size_t *ciphertext_length ); |
| 212 | |
| 213 | psa_status_t psa_driver_wrapper_aead_decrypt( |
| 214 | const psa_key_attributes_t *attributes, |
| 215 | const uint8_t *key_buffer, size_t key_buffer_size, |
| 216 | psa_algorithm_t alg, |
| 217 | const uint8_t *nonce, size_t nonce_length, |
| 218 | const uint8_t *additional_data, size_t additional_data_length, |
| 219 | const uint8_t *ciphertext, size_t ciphertext_length, |
| 220 | uint8_t *plaintext, size_t plaintext_size, size_t *plaintext_length ); |
| 221 | |
Steven Cooreman | d13a70f | 2021-03-19 15:24:23 +0100 | [diff] [blame] | 222 | /* |
| 223 | * MAC functions |
| 224 | */ |
| 225 | psa_status_t psa_driver_wrapper_mac_compute( |
| 226 | const psa_key_attributes_t *attributes, |
| 227 | const uint8_t *key_buffer, |
| 228 | size_t key_buffer_size, |
| 229 | psa_algorithm_t alg, |
| 230 | const uint8_t *input, |
| 231 | size_t input_length, |
| 232 | uint8_t *mac, |
| 233 | size_t mac_size, |
| 234 | size_t *mac_length ); |
| 235 | |
| 236 | psa_status_t psa_driver_wrapper_mac_sign_setup( |
| 237 | psa_mac_operation_t *operation, |
| 238 | const psa_key_attributes_t *attributes, |
| 239 | const uint8_t *key_buffer, |
| 240 | size_t key_buffer_size, |
| 241 | psa_algorithm_t alg ); |
| 242 | |
| 243 | psa_status_t psa_driver_wrapper_mac_verify_setup( |
| 244 | psa_mac_operation_t *operation, |
| 245 | const psa_key_attributes_t *attributes, |
| 246 | const uint8_t *key_buffer, |
| 247 | size_t key_buffer_size, |
| 248 | psa_algorithm_t alg ); |
| 249 | |
| 250 | psa_status_t psa_driver_wrapper_mac_update( |
| 251 | psa_mac_operation_t *operation, |
| 252 | const uint8_t *input, |
| 253 | size_t input_length ); |
| 254 | |
| 255 | psa_status_t psa_driver_wrapper_mac_sign_finish( |
| 256 | psa_mac_operation_t *operation, |
| 257 | uint8_t *mac, |
| 258 | size_t mac_size, |
| 259 | size_t *mac_length ); |
| 260 | |
| 261 | psa_status_t psa_driver_wrapper_mac_verify_finish( |
| 262 | psa_mac_operation_t *operation, |
| 263 | const uint8_t *mac, |
| 264 | size_t mac_length ); |
| 265 | |
| 266 | psa_status_t psa_driver_wrapper_mac_abort( |
| 267 | psa_mac_operation_t *operation ); |
| 268 | |
Steven Cooreman | cd84cb4 | 2020-07-16 20:28:36 +0200 | [diff] [blame] | 269 | #endif /* PSA_CRYPTO_DRIVER_WRAPPERS_H */ |
| 270 | |
| 271 | /* End of automatically generated file. */ |