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 |
Dave Rodgman | 7ff7965 | 2023-11-03 12:04:52 +0000 | [diff] [blame^] | 7 | * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later |
Steven Cooreman | cd84cb4 | 2020-07-16 20:28:36 +0200 | [diff] [blame] | 8 | */ |
| 9 | |
| 10 | #ifndef PSA_CRYPTO_DRIVER_WRAPPERS_H |
| 11 | #define PSA_CRYPTO_DRIVER_WRAPPERS_H |
| 12 | |
| 13 | #include "psa/crypto.h" |
| 14 | #include "psa/crypto_driver_common.h" |
| 15 | |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 16 | /* |
Ronald Cron | 088d5d0 | 2021-04-10 16:57:30 +0200 | [diff] [blame] | 17 | * Initialization and termination functions |
| 18 | */ |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 19 | psa_status_t psa_driver_wrapper_init(void); |
| 20 | void psa_driver_wrapper_free(void); |
Ronald Cron | 088d5d0 | 2021-04-10 16:57:30 +0200 | [diff] [blame] | 21 | |
| 22 | /* |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 23 | * Signature functions |
| 24 | */ |
gabor-mezei-arm | c53f4f6 | 2021-04-22 11:32:19 +0200 | [diff] [blame] | 25 | psa_status_t psa_driver_wrapper_sign_message( |
| 26 | const psa_key_attributes_t *attributes, |
| 27 | const uint8_t *key_buffer, |
| 28 | size_t key_buffer_size, |
| 29 | psa_algorithm_t alg, |
| 30 | const uint8_t *input, |
| 31 | size_t input_length, |
| 32 | uint8_t *signature, |
| 33 | size_t signature_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 34 | size_t *signature_length); |
gabor-mezei-arm | c53f4f6 | 2021-04-22 11:32:19 +0200 | [diff] [blame] | 35 | |
| 36 | psa_status_t psa_driver_wrapper_verify_message( |
| 37 | const psa_key_attributes_t *attributes, |
| 38 | const uint8_t *key_buffer, |
| 39 | size_t key_buffer_size, |
| 40 | psa_algorithm_t alg, |
| 41 | const uint8_t *input, |
| 42 | size_t input_length, |
| 43 | const uint8_t *signature, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 44 | size_t signature_length); |
gabor-mezei-arm | c53f4f6 | 2021-04-22 11:32:19 +0200 | [diff] [blame] | 45 | |
Ronald Cron | 9f17aa4 | 2020-12-08 17:07:25 +0100 | [diff] [blame] | 46 | psa_status_t psa_driver_wrapper_sign_hash( |
| 47 | const psa_key_attributes_t *attributes, |
| 48 | const uint8_t *key_buffer, size_t key_buffer_size, |
| 49 | psa_algorithm_t alg, const uint8_t *hash, size_t hash_length, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 50 | uint8_t *signature, size_t signature_size, size_t *signature_length); |
Steven Cooreman | cd84cb4 | 2020-07-16 20:28:36 +0200 | [diff] [blame] | 51 | |
Ronald Cron | 9f17aa4 | 2020-12-08 17:07:25 +0100 | [diff] [blame] | 52 | psa_status_t psa_driver_wrapper_verify_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, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 56 | const uint8_t *signature, size_t signature_length); |
Steven Cooreman | 55ae217 | 2020-07-17 19:46:15 +0200 | [diff] [blame] | 57 | |
Steven Cooreman | 0452476 | 2020-10-13 17:43:44 +0200 | [diff] [blame] | 58 | /* |
| 59 | * Key handling functions |
| 60 | */ |
| 61 | |
Ronald Cron | 8328287 | 2020-11-22 14:02:39 +0100 | [diff] [blame] | 62 | psa_status_t psa_driver_wrapper_import_key( |
| 63 | const psa_key_attributes_t *attributes, |
| 64 | const uint8_t *data, size_t data_length, |
| 65 | uint8_t *key_buffer, size_t key_buffer_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 66 | size_t *key_buffer_length, size_t *bits); |
Steven Cooreman | 0452476 | 2020-10-13 17:43:44 +0200 | [diff] [blame] | 67 | |
Ronald Cron | 6722798 | 2020-11-26 15:16:05 +0100 | [diff] [blame] | 68 | psa_status_t psa_driver_wrapper_export_key( |
| 69 | const psa_key_attributes_t *attributes, |
| 70 | const uint8_t *key_buffer, size_t key_buffer_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 71 | uint8_t *data, size_t data_size, size_t *data_length); |
Ronald Cron | 6722798 | 2020-11-26 15:16:05 +0100 | [diff] [blame] | 72 | |
Ronald Cron | 84cc994 | 2020-11-25 14:30:05 +0100 | [diff] [blame] | 73 | psa_status_t psa_driver_wrapper_export_public_key( |
| 74 | const psa_key_attributes_t *attributes, |
| 75 | const uint8_t *key_buffer, size_t key_buffer_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 76 | uint8_t *data, size_t data_size, size_t *data_length); |
Ronald Cron | 84cc994 | 2020-11-25 14:30:05 +0100 | [diff] [blame] | 77 | |
Ronald Cron | 9df74be | 2020-12-05 19:15:23 +0100 | [diff] [blame] | 78 | psa_status_t psa_driver_wrapper_get_key_buffer_size( |
| 79 | const psa_key_attributes_t *attributes, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 80 | size_t *key_buffer_size); |
Ronald Cron | 9df74be | 2020-12-05 19:15:23 +0100 | [diff] [blame] | 81 | |
Ronald Cron | 84cc994 | 2020-11-25 14:30:05 +0100 | [diff] [blame] | 82 | psa_status_t psa_driver_wrapper_generate_key( |
| 83 | const psa_key_attributes_t *attributes, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 84 | 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] | 85 | |
Steven Cooreman | 6801f08 | 2021-02-19 17:21:22 +0100 | [diff] [blame] | 86 | psa_status_t psa_driver_wrapper_get_builtin_key( |
| 87 | psa_drv_slot_number_t slot_number, |
| 88 | psa_key_attributes_t *attributes, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 89 | uint8_t *key_buffer, size_t key_buffer_size, size_t *key_buffer_length); |
Steven Cooreman | 6801f08 | 2021-02-19 17:21:22 +0100 | [diff] [blame] | 90 | |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 91 | /* |
| 92 | * Cipher functions |
| 93 | */ |
| 94 | psa_status_t psa_driver_wrapper_cipher_encrypt( |
gabor-mezei-arm | fa990b5 | 2021-03-25 11:17:10 +0100 | [diff] [blame] | 95 | const psa_key_attributes_t *attributes, |
| 96 | const uint8_t *key_buffer, |
| 97 | size_t key_buffer_size, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 98 | psa_algorithm_t alg, |
Ronald Cron | a833169 | 2021-07-09 09:19:35 +0200 | [diff] [blame] | 99 | const uint8_t *iv, |
| 100 | size_t iv_length, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 101 | const uint8_t *input, |
| 102 | size_t input_length, |
| 103 | uint8_t *output, |
| 104 | size_t output_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 105 | size_t *output_length); |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 106 | |
| 107 | psa_status_t psa_driver_wrapper_cipher_decrypt( |
gabor-mezei-arm | fa990b5 | 2021-03-25 11:17:10 +0100 | [diff] [blame] | 108 | const psa_key_attributes_t *attributes, |
| 109 | const uint8_t *key_buffer, |
| 110 | size_t key_buffer_size, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 111 | psa_algorithm_t alg, |
| 112 | const uint8_t *input, |
| 113 | size_t input_length, |
| 114 | uint8_t *output, |
| 115 | size_t output_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 116 | size_t *output_length); |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 117 | |
| 118 | psa_status_t psa_driver_wrapper_cipher_encrypt_setup( |
Ronald Cron | a4af55f | 2020-12-14 14:36:06 +0100 | [diff] [blame] | 119 | psa_cipher_operation_t *operation, |
| 120 | const psa_key_attributes_t *attributes, |
| 121 | const uint8_t *key_buffer, size_t key_buffer_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 122 | psa_algorithm_t alg); |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 123 | |
| 124 | psa_status_t psa_driver_wrapper_cipher_decrypt_setup( |
Ronald Cron | a4af55f | 2020-12-14 14:36:06 +0100 | [diff] [blame] | 125 | psa_cipher_operation_t *operation, |
| 126 | const psa_key_attributes_t *attributes, |
| 127 | const uint8_t *key_buffer, size_t key_buffer_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 128 | psa_algorithm_t alg); |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 129 | |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 130 | psa_status_t psa_driver_wrapper_cipher_set_iv( |
Ronald Cron | 6056fe8 | 2020-12-15 13:58:07 +0100 | [diff] [blame] | 131 | psa_cipher_operation_t *operation, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 132 | const uint8_t *iv, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 133 | size_t iv_length); |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 134 | |
| 135 | psa_status_t psa_driver_wrapper_cipher_update( |
Ronald Cron | 6056fe8 | 2020-12-15 13:58:07 +0100 | [diff] [blame] | 136 | psa_cipher_operation_t *operation, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 137 | const uint8_t *input, |
| 138 | size_t input_length, |
| 139 | uint8_t *output, |
| 140 | size_t output_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 141 | size_t *output_length); |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 142 | |
| 143 | psa_status_t psa_driver_wrapper_cipher_finish( |
Ronald Cron | 6056fe8 | 2020-12-15 13:58:07 +0100 | [diff] [blame] | 144 | psa_cipher_operation_t *operation, |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 145 | uint8_t *output, |
| 146 | size_t output_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 147 | size_t *output_length); |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 148 | |
| 149 | psa_status_t psa_driver_wrapper_cipher_abort( |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 150 | psa_cipher_operation_t *operation); |
Steven Cooreman | 37941cb | 2020-07-28 18:49:51 +0200 | [diff] [blame] | 151 | |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 152 | /* |
| 153 | * Hashing functions |
| 154 | */ |
| 155 | psa_status_t psa_driver_wrapper_hash_compute( |
| 156 | psa_algorithm_t alg, |
| 157 | const uint8_t *input, |
| 158 | size_t input_length, |
| 159 | uint8_t *hash, |
| 160 | size_t hash_size, |
| 161 | size_t *hash_length); |
| 162 | |
| 163 | psa_status_t psa_driver_wrapper_hash_setup( |
Steven Cooreman | dbf8ced | 2021-03-04 13:01:18 +0100 | [diff] [blame] | 164 | psa_hash_operation_t *operation, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 165 | psa_algorithm_t alg); |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 166 | |
| 167 | psa_status_t psa_driver_wrapper_hash_clone( |
Steven Cooreman | dbf8ced | 2021-03-04 13:01:18 +0100 | [diff] [blame] | 168 | const psa_hash_operation_t *source_operation, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 169 | psa_hash_operation_t *target_operation); |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 170 | |
| 171 | psa_status_t psa_driver_wrapper_hash_update( |
Steven Cooreman | dbf8ced | 2021-03-04 13:01:18 +0100 | [diff] [blame] | 172 | psa_hash_operation_t *operation, |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 173 | const uint8_t *input, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 174 | size_t input_length); |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 175 | |
| 176 | psa_status_t psa_driver_wrapper_hash_finish( |
Steven Cooreman | dbf8ced | 2021-03-04 13:01:18 +0100 | [diff] [blame] | 177 | psa_hash_operation_t *operation, |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 178 | uint8_t *hash, |
| 179 | size_t hash_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 180 | size_t *hash_length); |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 181 | |
| 182 | psa_status_t psa_driver_wrapper_hash_abort( |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 183 | psa_hash_operation_t *operation); |
Steven Cooreman | 1e58235 | 2021-02-18 17:24:37 +0100 | [diff] [blame] | 184 | |
Ronald Cron | de82281 | 2021-03-17 16:08:20 +0100 | [diff] [blame] | 185 | /* |
| 186 | * AEAD functions |
| 187 | */ |
| 188 | |
| 189 | psa_status_t psa_driver_wrapper_aead_encrypt( |
| 190 | const psa_key_attributes_t *attributes, |
| 191 | const uint8_t *key_buffer, size_t key_buffer_size, |
| 192 | psa_algorithm_t alg, |
| 193 | const uint8_t *nonce, size_t nonce_length, |
| 194 | const uint8_t *additional_data, size_t additional_data_length, |
| 195 | const uint8_t *plaintext, size_t plaintext_length, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 196 | uint8_t *ciphertext, size_t ciphertext_size, size_t *ciphertext_length); |
Ronald Cron | de82281 | 2021-03-17 16:08:20 +0100 | [diff] [blame] | 197 | |
| 198 | psa_status_t psa_driver_wrapper_aead_decrypt( |
| 199 | const psa_key_attributes_t *attributes, |
| 200 | const uint8_t *key_buffer, size_t key_buffer_size, |
| 201 | psa_algorithm_t alg, |
| 202 | const uint8_t *nonce, size_t nonce_length, |
| 203 | const uint8_t *additional_data, size_t additional_data_length, |
| 204 | const uint8_t *ciphertext, size_t ciphertext_length, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 205 | uint8_t *plaintext, size_t plaintext_size, size_t *plaintext_length); |
Ronald Cron | de82281 | 2021-03-17 16:08:20 +0100 | [diff] [blame] | 206 | |
Steven Cooreman | 896d51e | 2021-03-19 15:24:23 +0100 | [diff] [blame] | 207 | /* |
| 208 | * MAC functions |
| 209 | */ |
| 210 | psa_status_t psa_driver_wrapper_mac_compute( |
| 211 | const psa_key_attributes_t *attributes, |
| 212 | const uint8_t *key_buffer, |
| 213 | size_t key_buffer_size, |
| 214 | psa_algorithm_t alg, |
| 215 | const uint8_t *input, |
| 216 | size_t input_length, |
| 217 | uint8_t *mac, |
| 218 | size_t mac_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 219 | size_t *mac_length); |
Steven Cooreman | 896d51e | 2021-03-19 15:24:23 +0100 | [diff] [blame] | 220 | |
| 221 | psa_status_t psa_driver_wrapper_mac_sign_setup( |
| 222 | psa_mac_operation_t *operation, |
| 223 | const psa_key_attributes_t *attributes, |
| 224 | const uint8_t *key_buffer, |
| 225 | size_t key_buffer_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 226 | psa_algorithm_t alg); |
Steven Cooreman | 896d51e | 2021-03-19 15:24:23 +0100 | [diff] [blame] | 227 | |
| 228 | psa_status_t psa_driver_wrapper_mac_verify_setup( |
| 229 | psa_mac_operation_t *operation, |
| 230 | const psa_key_attributes_t *attributes, |
| 231 | const uint8_t *key_buffer, |
| 232 | size_t key_buffer_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 233 | psa_algorithm_t alg); |
Steven Cooreman | 896d51e | 2021-03-19 15:24:23 +0100 | [diff] [blame] | 234 | |
| 235 | psa_status_t psa_driver_wrapper_mac_update( |
| 236 | psa_mac_operation_t *operation, |
| 237 | const uint8_t *input, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 238 | size_t input_length); |
Steven Cooreman | 896d51e | 2021-03-19 15:24:23 +0100 | [diff] [blame] | 239 | |
| 240 | psa_status_t psa_driver_wrapper_mac_sign_finish( |
| 241 | psa_mac_operation_t *operation, |
| 242 | uint8_t *mac, |
| 243 | size_t mac_size, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 244 | size_t *mac_length); |
Steven Cooreman | 896d51e | 2021-03-19 15:24:23 +0100 | [diff] [blame] | 245 | |
| 246 | psa_status_t psa_driver_wrapper_mac_verify_finish( |
| 247 | psa_mac_operation_t *operation, |
| 248 | const uint8_t *mac, |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 249 | size_t mac_length); |
Steven Cooreman | 896d51e | 2021-03-19 15:24:23 +0100 | [diff] [blame] | 250 | |
| 251 | psa_status_t psa_driver_wrapper_mac_abort( |
Gilles Peskine | 1b6c09a | 2023-01-11 14:52:35 +0100 | [diff] [blame] | 252 | psa_mac_operation_t *operation); |
Steven Cooreman | 896d51e | 2021-03-19 15:24:23 +0100 | [diff] [blame] | 253 | |
Steven Cooreman | cd84cb4 | 2020-07-16 20:28:36 +0200 | [diff] [blame] | 254 | #endif /* PSA_CRYPTO_DRIVER_WRAPPERS_H */ |
| 255 | |
| 256 | /* End of automatically generated file. */ |