Mbed TLS v3.6.0
|
PSA cryptography module: Mbed TLS structured type implementations. More...
#include "mbedtls/private_access.h"
#include "psa/build_info.h"
#include "psa/crypto_driver_contexts_primitives.h"
#include "psa/crypto_driver_contexts_composites.h"
#include "psa/crypto_driver_contexts_key_derivation.h"
Go to the source code of this file.
Data Structures | |
struct | psa_hash_operation_s |
struct | psa_cipher_operation_s |
struct | psa_mac_operation_s |
struct | psa_aead_operation_s |
struct | psa_key_derivation_s |
struct | psa_key_production_parameters_s |
struct | psa_key_policy_s |
struct | psa_key_attributes_s |
struct | psa_sign_hash_interruptible_operation_s |
The context for PSA interruptible hash signing. More... | |
struct | psa_verify_hash_interruptible_operation_s |
The context for PSA interruptible hash verification. More... | |
Macros | |
#define | PSA_HASH_OPERATION_INIT { 0, { 0 } } |
#define | PSA_CIPHER_OPERATION_INIT { 0, 0, 0, 0, { 0 } } |
#define | PSA_MAC_OPERATION_INIT { 0, 0, 0, { 0 } } |
#define | PSA_AEAD_OPERATION_INIT { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, { 0 } } |
#define | PSA_KEY_DERIVATION_OPERATION_INIT { 0, 0, 0, { 0 } } |
#define | PSA_KEY_PRODUCTION_PARAMETERS_INIT { 0 } |
#define | PSA_KEY_POLICY_INIT { 0, 0, 0 } |
#define | PSA_KEY_BITS_TOO_LARGE ((psa_key_bits_t) -1) |
#define | PSA_MAX_KEY_BITS 0xfff8 |
#define | PSA_KEY_ATTRIBUTES_MAYBE_SLOT_NUMBER |
#define | PSA_KEY_ATTRIBUTES_INIT |
#define | PSA_SIGN_HASH_INTERRUPTIBLE_OPERATION_INIT { 0, { 0 }, 0, 0 } |
#define | PSA_VERIFY_HASH_INTERRUPTIBLE_OPERATION_INIT { 0, { 0 }, 0, 0 } |
Typedefs | |
typedef struct psa_key_policy_s | psa_key_policy_t |
typedef uint16_t | psa_key_bits_t |
PSA cryptography module: Mbed TLS structured type implementations.
This file contains the definitions of some data structures with implementation-specific definitions.
In implementations with isolation between the application and the cryptography module, it is expected that the front-end and the back-end would have different versions of this file.
For multipart operations without driver delegation support, each multipart operation structure contains a psa_algorithm_t alg
field which indicates which specific algorithm the structure is for. When the structure is not in use, alg
is 0. Most of the structure consists of a union which is discriminated by alg
.
For multipart operations with driver delegation support, each multipart operation structure contains an unsigned int id
field indicating which driver got assigned to do the operation. When the structure is not in use, 'id' is 0. The structure contains also a driver context which is the union of the contexts of all drivers able to handle the type of multipart operation.
Note that when alg
or id
is 0, the content of other fields is undefined. In particular, it is not guaranteed that a freshly-initialized structure is all-zero: we initialize structures to something like {0, 0}
, which is only guaranteed to initializes the first member of the union; GCC and Clang initialize the whole structure to 0 (at the time of writing), but MSVC and CompCert don't.
In Mbed TLS, multipart operation structures live independently from the key. This allows Mbed TLS to free the key objects when destroying a key slot. If a multipart operation needs to remember the key after the setup function returns, the operation structure needs to contain a copy of the key.
Definition in file crypto_struct.h.
#define PSA_KEY_ATTRIBUTES_MAYBE_SLOT_NUMBER |
Definition at line 295 of file crypto_struct.h.
#define PSA_KEY_BITS_TOO_LARGE ((psa_key_bits_t) -1) |
Definition at line 261 of file crypto_struct.h.
#define PSA_KEY_POLICY_INIT { 0, 0, 0 } |
Definition at line 249 of file crypto_struct.h.
#define PSA_KEY_PRODUCTION_PARAMETERS_INIT { 0 } |
The default production parameters for key generation or key derivation.
Calling psa_generate_key_ext() or psa_key_derivation_output_key_ext() with params=PSA_KEY_PRODUCTION_PARAMETERS_INIT
and params_data_length == 0
is equivalent to calling psa_generate_key() or psa_key_derivation_output_key() respectively.
Definition at line 240 of file crypto_struct.h.
#define PSA_MAX_KEY_BITS 0xfff8 |
Definition at line 267 of file crypto_struct.h.
#define PSA_SIGN_HASH_INTERRUPTIBLE_OPERATION_INIT { 0, { 0 }, 0, 0 } |
Definition at line 447 of file crypto_struct.h.
#define PSA_VERIFY_HASH_INTERRUPTIBLE_OPERATION_INIT { 0, { 0 }, 0, 0 } |
Definition at line 485 of file crypto_struct.h.
typedef uint16_t psa_key_bits_t |
Definition at line 258 of file crypto_struct.h.
typedef struct psa_key_policy_s psa_key_policy_t |
Definition at line 247 of file crypto_struct.h.
|
inlinestatic |
Definition at line 192 of file crypto_struct.h.
References PSA_AEAD_OPERATION_INIT.
|
inlinestatic |
Definition at line 121 of file crypto_struct.h.
References PSA_CIPHER_OPERATION_INIT.
|
inlinestatic |
Definition at line 357 of file crypto_struct.h.
References PSA_KEY_USAGE_SIGN_HASH, PSA_KEY_USAGE_SIGN_MESSAGE, PSA_KEY_USAGE_VERIFY_HASH, and PSA_KEY_USAGE_VERIFY_MESSAGE.
Referenced by psa_set_key_usage_flags().
|
inlinestatic |
Definition at line 387 of file crypto_struct.h.
|
inlinestatic |
Definition at line 415 of file crypto_struct.h.
|
inlinestatic |
Definition at line 324 of file crypto_struct.h.
|
inlinestatic |
Definition at line 351 of file crypto_struct.h.
|
inlinestatic |
Definition at line 399 of file crypto_struct.h.
|
inlinestatic |
Definition at line 375 of file crypto_struct.h.
|
inlinestatic |
Definition at line 89 of file crypto_struct.h.
References PSA_HASH_OPERATION_INIT.
|
inlinestatic |
Definition at line 303 of file crypto_struct.h.
References PSA_KEY_ATTRIBUTES_INIT.
|
inlinestatic |
Definition at line 219 of file crypto_struct.h.
References PSA_KEY_DERIVATION_OPERATION_INIT.
|
inlinestatic |
Definition at line 250 of file crypto_struct.h.
References PSA_KEY_POLICY_INIT.
|
inlinestatic |
Definition at line 153 of file crypto_struct.h.
References PSA_MAC_OPERATION_INIT.
|
inlinestatic |
Definition at line 381 of file crypto_struct.h.
|
inlinestatic |
Definition at line 405 of file crypto_struct.h.
References PSA_KEY_BITS_TOO_LARGE, and PSA_MAX_KEY_BITS.
|
inlinestatic |
Definition at line 309 of file crypto_struct.h.
References PSA_KEY_LIFETIME_FROM_PERSISTENCE_AND_LOCATION, PSA_KEY_LIFETIME_GET_LOCATION, PSA_KEY_LIFETIME_IS_VOLATILE, and PSA_KEY_LIFETIME_PERSISTENT.
|
inlinestatic |
Definition at line 338 of file crypto_struct.h.
References PSA_KEY_LIFETIME_IS_VOLATILE.
|
inlinestatic |
Definition at line 393 of file crypto_struct.h.
|
inlinestatic |
Definition at line 368 of file crypto_struct.h.
References psa_extend_key_usage_flags().
|
inlinestatic |
Definition at line 451 of file crypto_struct.h.
References PSA_SIGN_HASH_INTERRUPTIBLE_OPERATION_INIT.
|
inlinestatic |
Definition at line 489 of file crypto_struct.h.
References PSA_VERIFY_HASH_INTERRUPTIBLE_OPERATION_INIT.