Macros used to map PSA algorithms, key types and key sizes to specific key types and operations to call the corresponding driver functions. More...

Detailed Description

Macros used to map PSA algorithms, key types and key sizes to specific key types and operations to call the corresponding driver functions.

Note: Currently this only supports a small number of operations. It should be expanded as needed as this implementation increases support for more operations.

Author: Lena Boeckmann lena..nosp@m.boec.nosp@m.kmann.nosp@m.@haw.nosp@m.-hamb.nosp@m.urg..nosp@m.de

Definition in file psa_crypto_operation_encoder.h.

#include "psa/aead/algorithm.h"
#include "psa/cipher/algorithm.h"

Include dependency graph for psa_crypto_operation_encoder.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

#define	PSA_INVALID_OPERATION (0xFF)
	Unknown or invalid operation.

#define	PSA_ENCODE_ECC_KEY_TYPE_SECPR1(bits)
	Combine a SECP_R1 key type with a given key size (private or public key). More...

#define	PSA_ENCODE_ECC_KEY_TYPE_EDWARDS(bits)
	Combine a Twisted Edwards key type with a given key size (private or public key). More...

#define	PSA_ENCODE_ECC_KEY_TYPE(bits, curve)
	Map an ECC key to a given curve according to its type and size. More...

#define	GET_CBC_NO_PADDING_OPERATION(type, bits)
	Combine key type and size with a PSA_ALG_CBC_NO_PADDING algorithm. More...

#define	GET_AES_CCM_OPERATION(type, bits)
	Combine key type and size with a PSA_ALG_CCM algorithm. More...

#define	GET_CBC_PKCS7_OPERATION(type, bits)
	Combine key type and size with a PSA_ALG_CBC_PKCS7 algorithm. More...

#define	GET_CFB_OPERATION(type, bits) (PSA_INVALID_OPERATION)
	Combine key type and size with a PSA_ALG_CFB algorithm. More...

#define	GET_CTR_OPERATION(type, bits) (PSA_INVALID_OPERATION)
	Combine key type and size with a PSA_ALG_CTR algorithm. More...

#define	GET_ECB_NO_PADDING_OPERATION(type, bits) (PSA_INVALID_OPERATION)
	Combine key type and size with a PSA_ALG_ECB_NO_PADDING algorithm. More...

#define	GET_OFB_OPERATION(type, bits) (PSA_INVALID_OPERATION)
	Combine key type and size with a PSA_ALG_OFB algorithm. More...

#define	GET_STREAM_CIPHER_OPERATION(type, bits)
	Combine key type and size with a PSA_ALG_STREAM_CIPHER algorithm. More...

#define	GET_XTS_OPERATION(type, bits) (PSA_INVALID_OPERATION)
	Combine key type and size with a PSA_ALG_XTS algorithm. More...

#define	PSA_ENCODE_CIPHER_OPERATION(alg, type, bits)
	Map algorithm, key size and type to a specific operation. More...

#define	PSA_ENCODE_AEAD_OPERATION(alg, type, bits)
	Map algorithm, key size and type to a specific operation. More...

enum	psa_cipher_op_t { PSA_CBC_NO_PAD_AES_128 , PSA_CBC_NO_PAD_AES_192 , PSA_CBC_NO_PAD_AES_256 , PSA_CBC_PKCS7_AES_256 , PSA_STREAM_CIPHER_CHACHA20 }
	Enum encoding available cipher operations. More...

enum	psa_aead_op_t { PSA_CCM_AES_128 , PSA_CCM_AES_192 , PSA_CCM_AES_256 }
	Enum encoding available aead operations. More...

enum	psa_asym_key_t { PSA_ECC_P160_K1 , PSA_ECC_P160_R1 , PSA_ECC_P160_R2 , PSA_ECC_P192_K1 , PSA_ECC_P192_R1 , PSA_ECC_P224_K1 , PSA_ECC_P224_R1 , PSA_ECC_P256_K1 , PSA_ECC_P256_R1 , PSA_ECC_P384_R1 , PSA_ECC_P521_R1 , PSA_ECC_FRP , PSA_ECC_ED25519 }
	Enum encoding available asymmetric key types and sizes. More...

Macro Definition Documentation

◆ GET_AES_CCM_OPERATION

#define GET_AES_CCM_OPERATION	(	type,
		bits
	)

Value:

    ((type == PSA_KEY_TYPE_AES) ? \
     ((bits == 128) ? PSA_CCM_AES_128 : \
     (bits == 192) ? PSA_CCM_AES_192 : \
     (bits == 256) ? PSA_CCM_AES_256 : \
     PSA_INVALID_OPERATION) : \
     PSA_INVALID_OPERATION)

Combine key type and size with a PSA_ALG_CCM algorithm.

Parameters

type	Key type of type psa_key_type_t
bits	Size of the used key of type psa_key_bits_t

Returns: psa_aead_op_t; PSA_INVALID_OPERATION alg, bits and type are not compatible

Definition at line 146 of file psa_crypto_operation_encoder.h.

◆ GET_CBC_NO_PADDING_OPERATION

#define GET_CBC_NO_PADDING_OPERATION	(	type,
		bits
	)

Value:

    ((type == PSA_KEY_TYPE_AES) ? \
     ((bits == 128) ? PSA_CBC_NO_PAD_AES_128 : \
     (bits == 192) ? PSA_CBC_NO_PAD_AES_192 : \
     (bits == 256) ? PSA_CBC_NO_PAD_AES_256 : \
     PSA_INVALID_OPERATION) : \
     PSA_INVALID_OPERATION)

Combine key type and size with a PSA_ALG_CBC_NO_PADDING algorithm.

Parameters

type	Key type of type psa_key_type_t
bits	Size of the used key of type psa_key_bits_t

Returns: psa_cipher_op_t; PSA_INVALID_OPERATION alg, bits and type are not compatible

Definition at line 129 of file psa_crypto_operation_encoder.h.

◆ GET_CBC_PKCS7_OPERATION

#define GET_CBC_PKCS7_OPERATION	(	type,
		bits
	)

Value:

(((alg == PSA_ALG_CBC_PKCS7) && (type == PSA_KEY_TYPE_AES)) ? PSA_CBC_PKCS7_AES_256 : \

PSA_INVALID_OPERATION)

PSA_ALG_CBC_PKCS7

#define PSA_ALG_CBC_PKCS7

The Cipher Block Chaining (CBC) mode of a block cipher, with PKCS#7 padding.

Definition: algorithm.h:300

Combine key type and size with a PSA_ALG_CBC_PKCS7 algorithm.

Parameters

type	Key type of type psa_key_type_t
bits	Size of the used key of type psa_key_bits_t

Returns: psa_cipher_op_t; PSA_INVALID_OPERATION alg, bits and type are not compatible

Definition at line 163 of file psa_crypto_operation_encoder.h.

◆ GET_CFB_OPERATION

#define GET_CFB_OPERATION	(	type,
		bits
	)	(PSA_INVALID_OPERATION)

Combine key type and size with a PSA_ALG_CFB algorithm.

Parameters

type	Key type of type psa_key_type_t
bits	Size of the used key of type psa_key_bits_t

Returns: psa_cipher_op_t; PSA_INVALID_OPERATION alg, bits and type are not compatible

Definition at line 176 of file psa_crypto_operation_encoder.h.

◆ GET_CTR_OPERATION

#define GET_CTR_OPERATION	(	type,
		bits
	)	(PSA_INVALID_OPERATION)

Combine key type and size with a PSA_ALG_CTR algorithm.

Parameters

type	Key type of type psa_key_type_t
bits	Size of the used key of type psa_key_bits_t

Returns: psa_cipher_op_t; PSA_INVALID_OPERATION alg, bits and type are not compatible

Definition at line 188 of file psa_crypto_operation_encoder.h.

◆ GET_ECB_NO_PADDING_OPERATION

#define GET_ECB_NO_PADDING_OPERATION	(	type,
		bits
	)	(PSA_INVALID_OPERATION)

Combine key type and size with a PSA_ALG_ECB_NO_PADDING algorithm.

Parameters

type	Key type of type psa_key_type_t
bits	Size of the used key of type psa_key_bits_t

Returns: psa_cipher_op_t; PSA_INVALID_OPERATION alg, bits and type are not compatible

Definition at line 200 of file psa_crypto_operation_encoder.h.

◆ GET_OFB_OPERATION

#define GET_OFB_OPERATION	(	type,
		bits
	)	(PSA_INVALID_OPERATION)

Combine key type and size with a PSA_ALG_OFB algorithm.

Parameters

type	Key type of type psa_key_type_t
bits	Size of the used key of type psa_key_bits_t

Returns: psa_cipher_op_t; PSA_INVALID_OPERATION alg, bits and type are not compatible

Definition at line 212 of file psa_crypto_operation_encoder.h.

◆ GET_STREAM_CIPHER_OPERATION

#define GET_STREAM_CIPHER_OPERATION	(	type,
		bits
	)

Value:

(((type == PSA_KEY_TYPE_CHACHA20) && (bits == 256)) ? PSA_STREAM_CIPHER_CHACHA20 : \

PSA_INVALID_OPERATION)

PSA_KEY_TYPE_CHACHA20

#define PSA_KEY_TYPE_CHACHA20

Key for the ChaCha20 stream cipher or the ChaCha20-Poly1305 AEAD algorithm.

Definition: type.h:444

Combine key type and size with a PSA_ALG_STREAM_CIPHER algorithm.

Parameters

type	Key type of type psa_key_type_t
bits	Size of the used key of type psa_key_bits_t

Returns: psa_cipher_op_t; PSA_INVALID_OPERATION alg, bits and type are not compatible

Definition at line 224 of file psa_crypto_operation_encoder.h.

◆ GET_XTS_OPERATION

#define GET_XTS_OPERATION	(	type,
		bits
	)	(PSA_INVALID_OPERATION)

Combine key type and size with a PSA_ALG_XTS algorithm.

Parameters

type	Key type of type psa_key_type_t
bits	Size of the used key of type psa_key_bits_t

Returns: psa_cipher_op_t; PSA_INVALID_OPERATION alg, bits and type are not compatible

Definition at line 237 of file psa_crypto_operation_encoder.h.

◆ PSA_ENCODE_AEAD_OPERATION

#define PSA_ENCODE_AEAD_OPERATION	(	alg,
		type,
		bits
	)

Value:

((PSA_ALG_AEAD_WITH_DEFAULT_LENGTH_TAG(alg) == PSA_ALG_CCM) ? \

GET_AES_CCM_OPERATION(type, bits) : PSA_INVALID_OPERATION)

PSA_ALG_AEAD_WITH_DEFAULT_LENGTH_TAG

#define PSA_ALG_AEAD_WITH_DEFAULT_LENGTH_TAG(aead_alg)

An AEAD algorithm with the default tag length.

Definition: algorithm.h:190

PSA_ALG_CCM

#define PSA_ALG_CCM

The Counter with CBC-MAC (CCM) authenticated encryption algorithm.

Definition: algorithm.h:97

GET_AES_CCM_OPERATION

#define GET_AES_CCM_OPERATION(type, bits)

Combine key type and size with a PSA_ALG_CCM algorithm.

Definition: psa_crypto_operation_encoder.h:146

Map algorithm, key size and type to a specific operation.

Parameters

alg	Algorithm of type psa_algorithm_t.
type	Key type of type psa_key_type_t
bits	Size of the used key of type psa_key_bits_t

Returns: psa_aead_op_t; PSA_INVALID_OPERATION alg, bits and type are not compatible

Definition at line 271 of file psa_crypto_operation_encoder.h.

◆ PSA_ENCODE_CIPHER_OPERATION

#define PSA_ENCODE_CIPHER_OPERATION	(	alg,
		type,
		bits
	)

Value:

    ((alg == PSA_ALG_CBC_NO_PADDING) ? GET_CBC_NO_PADDING_OPERATION(type, bits) : \
     (alg == PSA_ALG_CBC_PKCS7) ? GET_CBC_PKCS7_OPERATION(type, bits) : \
     (alg == PSA_ALG_CFB) ? GET_CFB_OPERATION(type, bits) : \
     (alg == PSA_ALG_CTR) ? GET_CTR_OPERATION(type, bits) : \
     (alg == PSA_ALG_ECB_NO_PADDING) ? GET_ECB_NO_PADDING_OPERATION(type, bits) : \
     (alg == PSA_ALG_OFB) ? GET_OFB_OPERATION(type, bits) : \
     (alg == PSA_ALG_STREAM_CIPHER) ? GET_STREAM_CIPHER_OPERATION(type, bits) : \
     (alg == PSA_ALG_XTS) ? GET_XTS_OPERATION(type, bits) : \
     PSA_INVALID_OPERATION)

Map algorithm, key size and type to a specific operation.

Parameters

alg	Algorithm of type psa_algorithm_t.
type	Key type of type psa_key_type_t
bits	Size of the used key of type psa_key_bits_t

Returns: psa_cipher_op_t; PSA_INVALID_OPERATION alg, bits and type are not compatible

Definition at line 250 of file psa_crypto_operation_encoder.h.

◆ PSA_ENCODE_ECC_KEY_TYPE

#define PSA_ENCODE_ECC_KEY_TYPE	(	bits,
		curve
	)

Value:

    ((curve == PSA_ECC_FAMILY_SECP_R1) ? PSA_ENCODE_ECC_KEY_TYPE_SECPR1(bits) : \
     (curve == PSA_ECC_FAMILY_TWISTED_EDWARDS) ? PSA_ENCODE_ECC_KEY_TYPE_EDWARDS(bits) : \
     PSA_INVALID_OPERATION)

Map an ECC key to a given curve according to its type and size.

Parameters

bits	Key size of type psa_key_bits_t
curve	Must be a curve of type psa_ecc_family_t

Returns: psa_asym_key_t; PSA_INVALID_OPERATION curve and bits are incompatible

Definition at line 115 of file psa_crypto_operation_encoder.h.

◆ PSA_ENCODE_ECC_KEY_TYPE_EDWARDS

#define PSA_ENCODE_ECC_KEY_TYPE_EDWARDS ( bits )

Value:

((bits == 255) || (bits == 256) ? PSA_ECC_ED25519 : \

PSA_INVALID_OPERATION)

Combine a Twisted Edwards key type with a given key size (private or public key).

Parameters

bits	Key size of type psa_key_bits_t

Returns: psa_asym_key_t; PSA_INVALID_OPERATION bits is not compatible with Twisted Edwards curves

Definition at line 102 of file psa_crypto_operation_encoder.h.

◆ PSA_ENCODE_ECC_KEY_TYPE_SECPR1

#define PSA_ENCODE_ECC_KEY_TYPE_SECPR1 ( bits )

Value:

    ((bits == 256) || (bits == 520) ? PSA_ECC_P256_R1 : \
     (bits == 192) || (bits == 392) ? PSA_ECC_P192_R1 : \
     PSA_INVALID_OPERATION)

Combine a SECP_R1 key type with a given key size (private or public key).

Parameters

bits	Key size of type psa_key_bits_t

Returns: psa_asym_key_t; PSA_INVALID_OPERATION bits is not compatible with SECP_R1 curves

Definition at line 89 of file psa_crypto_operation_encoder.h.

Enumeration Type Documentation

◆ psa_aead_op_t

enum psa_aead_op_t

Enum encoding available aead operations.

To be expanded with the development of this implementation.

Definition at line 54 of file psa_crypto_operation_encoder.h.

◆ psa_asym_key_t

enum psa_asym_key_t

Enum encoding available asymmetric key types and sizes.

To be expanded with the development of this implementation.

Definition at line 65 of file psa_crypto_operation_encoder.h.

◆ psa_cipher_op_t

enum psa_cipher_op_t

Enum encoding available cipher operations.

To be expanded with the development of this implementation.

Definition at line 41 of file psa_crypto_operation_encoder.h.