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