28#ifndef PSA_CRYPTO_SIZES_H
29#define PSA_CRYPTO_SIZES_H
33#if !defined(MBEDTLS_CONFIG_FILE)
36#include MBEDTLS_CONFIG_FILE
39#define PSA_BITS_TO_BYTES(bits) (((bits) + 7) / 8)
40#define PSA_BYTES_TO_BITS(bytes) ((bytes) * 8)
42#define PSA_ROUND_UP_TO_MULTIPLE(block_size, length) \
43 (((length) + (block_size) - 1) / (block_size) * (block_size))
57#define PSA_HASH_LENGTH(alg) \
59 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_MD2 ? 16 : \
60 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_MD4 ? 16 : \
61 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_MD5 ? 16 : \
62 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_RIPEMD160 ? 20 : \
63 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_1 ? 20 : \
64 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_224 ? 28 : \
65 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_256 ? 32 : \
66 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_384 ? 48 : \
67 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_512 ? 64 : \
68 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_512_224 ? 28 : \
69 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_512_256 ? 32 : \
70 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA3_224 ? 28 : \
71 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA3_256 ? 32 : \
72 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA3_384 ? 48 : \
73 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA3_512 ? 64 : \
91#define PSA_HASH_BLOCK_LENGTH(alg) \
93 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_MD2 ? 16 : \
94 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_MD4 ? 64 : \
95 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_MD5 ? 64 : \
96 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_RIPEMD160 ? 64 : \
97 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_1 ? 64 : \
98 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_224 ? 64 : \
99 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_256 ? 64 : \
100 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_384 ? 128 : \
101 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_512 ? 128 : \
102 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_512_224 ? 128 : \
103 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA_512_256 ? 128 : \
104 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA3_224 ? 144 : \
105 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA3_256 ? 136 : \
106 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA3_384 ? 104 : \
107 PSA_ALG_HMAC_GET_HASH(alg) == PSA_ALG_SHA3_512 ? 72 : \
120#if defined(PSA_WANT_ALG_SHA_512) || defined(PSA_WANT_ALG_SHA_384)
121#define PSA_HASH_MAX_SIZE 64
122#define PSA_HMAC_MAX_HASH_BLOCK_SIZE 128
124#define PSA_HASH_MAX_SIZE 32
125#define PSA_HMAC_MAX_HASH_BLOCK_SIZE 64
140#define PSA_MAC_MAX_SIZE PSA_HASH_MAX_SIZE
163#define PSA_AEAD_TAG_LENGTH(key_type, key_bits, alg) \
164 (PSA_AEAD_NONCE_LENGTH(key_type, alg) != 0 ? \
165 PSA_ALG_AEAD_GET_TAG_LENGTH(alg) : \
166 ((void) (key_bits), 0))
172#define PSA_AEAD_TAG_MAX_SIZE 16
187#define PSA_VENDOR_RSA_MAX_KEY_BITS 4096
191#if defined(MBEDTLS_ECP_DP_SECP521R1_ENABLED)
192#define PSA_VENDOR_ECC_MAX_CURVE_BITS 521
193#elif defined(MBEDTLS_ECP_DP_BP512R1_ENABLED)
194#define PSA_VENDOR_ECC_MAX_CURVE_BITS 512
195#elif defined(MBEDTLS_ECP_DP_CURVE448_ENABLED)
196#define PSA_VENDOR_ECC_MAX_CURVE_BITS 448
197#elif defined(MBEDTLS_ECP_DP_SECP384R1_ENABLED)
198#define PSA_VENDOR_ECC_MAX_CURVE_BITS 384
199#elif defined(MBEDTLS_ECP_DP_BP384R1_ENABLED)
200#define PSA_VENDOR_ECC_MAX_CURVE_BITS 384
201#elif defined(MBEDTLS_ECP_DP_SECP256R1_ENABLED)
202#define PSA_VENDOR_ECC_MAX_CURVE_BITS 256
203#elif defined(MBEDTLS_ECP_DP_SECP256K1_ENABLED)
204#define PSA_VENDOR_ECC_MAX_CURVE_BITS 256
205#elif defined(MBEDTLS_ECP_DP_BP256R1_ENABLED)
206#define PSA_VENDOR_ECC_MAX_CURVE_BITS 256
207#elif defined(MBEDTLS_ECP_DP_CURVE25519_ENABLED)
208#define PSA_VENDOR_ECC_MAX_CURVE_BITS 255
209#elif defined(MBEDTLS_ECP_DP_SECP224R1_ENABLED)
210#define PSA_VENDOR_ECC_MAX_CURVE_BITS 224
211#elif defined(MBEDTLS_ECP_DP_SECP224K1_ENABLED)
212#define PSA_VENDOR_ECC_MAX_CURVE_BITS 224
213#elif defined(MBEDTLS_ECP_DP_SECP192R1_ENABLED)
214#define PSA_VENDOR_ECC_MAX_CURVE_BITS 192
215#elif defined(MBEDTLS_ECP_DP_SECP192K1_ENABLED)
216#define PSA_VENDOR_ECC_MAX_CURVE_BITS 192
218#define PSA_VENDOR_ECC_MAX_CURVE_BITS 0
236#define PSA_TLS12_PSK_TO_MS_PSK_MAX_SIZE 128
239#define PSA_BLOCK_CIPHER_BLOCK_MAX_SIZE 16
262#define PSA_MAC_LENGTH(key_type, key_bits, alg) \
263 ((alg) & PSA_ALG_MAC_TRUNCATION_MASK ? PSA_MAC_TRUNCATED_LENGTH(alg) : \
264 PSA_ALG_IS_HMAC(alg) ? PSA_HASH_LENGTH(PSA_ALG_HMAC_GET_HASH(alg)) : \
265 PSA_ALG_IS_BLOCK_CIPHER_MAC(alg) ? PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type) : \
266 ((void) (key_type), (void) (key_bits), 0))
294#define PSA_AEAD_ENCRYPT_OUTPUT_SIZE(key_type, alg, plaintext_length) \
295 (PSA_AEAD_NONCE_LENGTH(key_type, alg) != 0 ? \
296 (plaintext_length) + PSA_ALG_AEAD_GET_TAG_LENGTH(alg) : \
317#define PSA_AEAD_ENCRYPT_OUTPUT_MAX_SIZE(plaintext_length) \
318 ((plaintext_length) + PSA_AEAD_TAG_MAX_SIZE)
347#define PSA_AEAD_DECRYPT_OUTPUT_SIZE(key_type, alg, ciphertext_length) \
348 (PSA_AEAD_NONCE_LENGTH(key_type, alg) != 0 && \
349 (ciphertext_length) > PSA_ALG_AEAD_GET_TAG_LENGTH(alg) ? \
350 (ciphertext_length) - PSA_ALG_AEAD_GET_TAG_LENGTH(alg) : \
371#define PSA_AEAD_DECRYPT_OUTPUT_MAX_SIZE(ciphertext_length) \
399#define PSA_AEAD_NONCE_LENGTH(key_type, alg) \
400 (PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type) == 16 ? \
401 MBEDTLS_PSA_ALG_AEAD_EQUAL(alg, PSA_ALG_CCM) ? 13 : \
402 MBEDTLS_PSA_ALG_AEAD_EQUAL(alg, PSA_ALG_GCM) ? 12 : \
404 (key_type) == PSA_KEY_TYPE_CHACHA20 && \
405 MBEDTLS_PSA_ALG_AEAD_EQUAL(alg, PSA_ALG_CHACHA20_POLY1305) ? 12 : \
419#define PSA_AEAD_NONCE_MAX_SIZE 13
451#define PSA_AEAD_UPDATE_OUTPUT_SIZE(key_type, alg, input_length) \
452 (PSA_AEAD_NONCE_LENGTH(key_type, alg) != 0 ? \
453 PSA_ALG_IS_AEAD_ON_BLOCK_CIPHER(alg) ? \
454 PSA_ROUND_UP_TO_MULTIPLE(PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type), (input_length)) : \
468#define PSA_AEAD_UPDATE_OUTPUT_MAX_SIZE(input_length) \
469 (PSA_ROUND_UP_TO_MULTIPLE(PSA_BLOCK_CIPHER_BLOCK_MAX_SIZE, (input_length)))
492#define PSA_AEAD_FINISH_OUTPUT_SIZE(key_type, alg) \
493 (PSA_AEAD_NONCE_LENGTH(key_type, alg) != 0 && \
494 PSA_ALG_IS_AEAD_ON_BLOCK_CIPHER(alg) ? \
495 PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type) : \
503#define PSA_AEAD_FINISH_OUTPUT_MAX_SIZE (PSA_BLOCK_CIPHER_BLOCK_MAX_SIZE)
526#define PSA_AEAD_VERIFY_OUTPUT_SIZE(key_type, alg) \
527 (PSA_AEAD_NONCE_LENGTH(key_type, alg) != 0 && \
528 PSA_ALG_IS_AEAD_ON_BLOCK_CIPHER(alg) ? \
529 PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type) : \
537#define PSA_AEAD_VERIFY_OUTPUT_MAX_SIZE (PSA_BLOCK_CIPHER_BLOCK_MAX_SIZE)
539#define PSA_RSA_MINIMUM_PADDING_SIZE(alg) \
540 (PSA_ALG_IS_RSA_OAEP(alg) ? \
541 2 * PSA_HASH_LENGTH(PSA_ALG_RSA_OAEP_GET_HASH(alg)) + 1 : \
552#define PSA_ECDSA_SIGNATURE_SIZE(curve_bits) \
553 (PSA_BITS_TO_BYTES(curve_bits) * 2)
580#define PSA_SIGN_OUTPUT_SIZE(key_type, key_bits, alg) \
581 (PSA_KEY_TYPE_IS_RSA(key_type) ? ((void) alg, PSA_BITS_TO_BYTES(key_bits)) : \
582 PSA_KEY_TYPE_IS_ECC(key_type) ? PSA_ECDSA_SIGNATURE_SIZE(key_bits) : \
585#define PSA_VENDOR_ECDSA_SIGNATURE_MAX_SIZE \
586 PSA_ECDSA_SIGNATURE_SIZE(PSA_VENDOR_ECC_MAX_CURVE_BITS)
595#define PSA_SIGNATURE_MAX_SIZE \
596 (PSA_BITS_TO_BYTES(PSA_VENDOR_RSA_MAX_KEY_BITS) > PSA_VENDOR_ECDSA_SIGNATURE_MAX_SIZE ? \
597 PSA_BITS_TO_BYTES(PSA_VENDOR_RSA_MAX_KEY_BITS) : \
598 PSA_VENDOR_ECDSA_SIGNATURE_MAX_SIZE)
625#define PSA_ASYMMETRIC_ENCRYPT_OUTPUT_SIZE(key_type, key_bits, alg) \
626 (PSA_KEY_TYPE_IS_RSA(key_type) ? \
627 ((void) alg, PSA_BITS_TO_BYTES(key_bits)) : \
636#define PSA_ASYMMETRIC_ENCRYPT_OUTPUT_MAX_SIZE \
637 (PSA_BITS_TO_BYTES(PSA_VENDOR_RSA_MAX_KEY_BITS))
664#define PSA_ASYMMETRIC_DECRYPT_OUTPUT_SIZE(key_type, key_bits, alg) \
665 (PSA_KEY_TYPE_IS_RSA(key_type) ? \
666 PSA_BITS_TO_BYTES(key_bits) - PSA_RSA_MINIMUM_PADDING_SIZE(alg) : \
676#define PSA_ASYMMETRIC_DECRYPT_OUTPUT_MAX_SIZE \
677 (PSA_BITS_TO_BYTES(PSA_VENDOR_RSA_MAX_KEY_BITS))
689#define PSA_KEY_EXPORT_ASN1_INTEGER_MAX_SIZE(bits) \
703#define PSA_KEY_EXPORT_RSA_PUBLIC_KEY_MAX_SIZE(key_bits) \
704 (PSA_KEY_EXPORT_ASN1_INTEGER_MAX_SIZE(key_bits) + 11)
728#define PSA_KEY_EXPORT_RSA_KEY_PAIR_MAX_SIZE(key_bits) \
729 (9 * PSA_KEY_EXPORT_ASN1_INTEGER_MAX_SIZE((key_bits) / 2 + 1) + 14)
747#define PSA_KEY_EXPORT_DSA_PUBLIC_KEY_MAX_SIZE(key_bits) \
748 (PSA_KEY_EXPORT_ASN1_INTEGER_MAX_SIZE(key_bits) * 3 + 59)
766#define PSA_KEY_EXPORT_DSA_KEY_PAIR_MAX_SIZE(key_bits) \
767 (PSA_KEY_EXPORT_ASN1_INTEGER_MAX_SIZE(key_bits) * 3 + 75)
779#define PSA_KEY_EXPORT_ECC_PUBLIC_KEY_MAX_SIZE(key_bits) \
780 (2 * PSA_BITS_TO_BYTES(key_bits) + 1)
786#define PSA_KEY_EXPORT_ECC_KEY_PAIR_MAX_SIZE(key_bits) \
787 (PSA_BITS_TO_BYTES(key_bits))
828#define PSA_EXPORT_KEY_OUTPUT_SIZE(key_type, key_bits) \
829 (PSA_KEY_TYPE_IS_UNSTRUCTURED(key_type) ? PSA_BITS_TO_BYTES(key_bits) : \
830 (key_type) == PSA_KEY_TYPE_RSA_KEY_PAIR ? PSA_KEY_EXPORT_RSA_KEY_PAIR_MAX_SIZE(key_bits) : \
831 (key_type) == PSA_KEY_TYPE_RSA_PUBLIC_KEY ? PSA_KEY_EXPORT_RSA_PUBLIC_KEY_MAX_SIZE(key_bits) : \
832 (key_type) == PSA_KEY_TYPE_DSA_KEY_PAIR ? PSA_KEY_EXPORT_DSA_KEY_PAIR_MAX_SIZE(key_bits) : \
833 (key_type) == PSA_KEY_TYPE_DSA_PUBLIC_KEY ? PSA_KEY_EXPORT_DSA_PUBLIC_KEY_MAX_SIZE(key_bits) : \
834 PSA_KEY_TYPE_IS_ECC_KEY_PAIR(key_type) ? PSA_KEY_EXPORT_ECC_KEY_PAIR_MAX_SIZE(key_bits) : \
835 PSA_KEY_TYPE_IS_ECC_PUBLIC_KEY(key_type) ? PSA_KEY_EXPORT_ECC_PUBLIC_KEY_MAX_SIZE(key_bits) : \
883#define PSA_EXPORT_PUBLIC_KEY_OUTPUT_SIZE(key_type, key_bits) \
884 (PSA_KEY_TYPE_IS_RSA(key_type) ? PSA_KEY_EXPORT_RSA_PUBLIC_KEY_MAX_SIZE(key_bits) : \
885 PSA_KEY_TYPE_IS_ECC(key_type) ? PSA_KEY_EXPORT_ECC_PUBLIC_KEY_MAX_SIZE(key_bits) : \
896#define PSA_EXPORT_KEY_PAIR_MAX_SIZE \
897 (PSA_KEY_EXPORT_RSA_KEY_PAIR_MAX_SIZE(PSA_VENDOR_RSA_MAX_KEY_BITS) > \
898 PSA_KEY_EXPORT_ECC_KEY_PAIR_MAX_SIZE(PSA_VENDOR_ECC_MAX_CURVE_BITS) ? \
899 PSA_KEY_EXPORT_RSA_KEY_PAIR_MAX_SIZE(PSA_VENDOR_RSA_MAX_KEY_BITS) : \
900 PSA_KEY_EXPORT_ECC_KEY_PAIR_MAX_SIZE(PSA_VENDOR_ECC_MAX_CURVE_BITS))
911#define PSA_EXPORT_PUBLIC_KEY_MAX_SIZE \
912 (PSA_KEY_EXPORT_RSA_PUBLIC_KEY_MAX_SIZE(PSA_VENDOR_RSA_MAX_KEY_BITS) > \
913 PSA_KEY_EXPORT_ECC_PUBLIC_KEY_MAX_SIZE(PSA_VENDOR_ECC_MAX_CURVE_BITS) ? \
914 PSA_KEY_EXPORT_RSA_PUBLIC_KEY_MAX_SIZE(PSA_VENDOR_RSA_MAX_KEY_BITS) : \
915 PSA_KEY_EXPORT_ECC_PUBLIC_KEY_MAX_SIZE(PSA_VENDOR_ECC_MAX_CURVE_BITS))
941#define PSA_RAW_KEY_AGREEMENT_OUTPUT_SIZE(key_type, key_bits) \
942 (PSA_KEY_TYPE_IS_ECC_KEY_PAIR(key_type) ? \
943 PSA_BITS_TO_BYTES(key_bits) : \
953#define PSA_RAW_KEY_AGREEMENT_OUTPUT_MAX_SIZE \
954 (PSA_BITS_TO_BYTES(PSA_VENDOR_ECC_MAX_CURVE_BITS))
980#define PSA_CIPHER_IV_LENGTH(key_type, alg) \
981 (PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type) > 1 && \
982 ((alg) == PSA_ALG_CTR || \
983 (alg) == PSA_ALG_CFB || \
984 (alg) == PSA_ALG_OFB || \
985 (alg) == PSA_ALG_XTS || \
986 (alg) == PSA_ALG_CBC_NO_PADDING || \
987 (alg) == PSA_ALG_CBC_PKCS7) ? PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type) : \
988 (key_type) == PSA_KEY_TYPE_CHACHA20 && \
989 (alg) == PSA_ALG_STREAM_CIPHER ? 12 : \
996#define PSA_CIPHER_IV_MAX_SIZE 16
1021#define PSA_CIPHER_ENCRYPT_OUTPUT_SIZE(key_type, alg, input_length) \
1022 (alg == PSA_ALG_CBC_PKCS7 ? \
1023 (PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type) != 0 ? \
1024 PSA_ROUND_UP_TO_MULTIPLE(PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type), \
1025 (input_length) + 1) + \
1026 PSA_CIPHER_IV_LENGTH((key_type), (alg)) : 0) : \
1027 (PSA_ALG_IS_CIPHER(alg) ? \
1028 (input_length) + PSA_CIPHER_IV_LENGTH((key_type), (alg)) : \
1042#define PSA_CIPHER_ENCRYPT_OUTPUT_MAX_SIZE(input_length) \
1043 (PSA_ROUND_UP_TO_MULTIPLE(PSA_BLOCK_CIPHER_BLOCK_MAX_SIZE, \
1044 (input_length) + 1) + \
1045 PSA_CIPHER_IV_MAX_SIZE)
1066#define PSA_CIPHER_DECRYPT_OUTPUT_SIZE(key_type, alg, input_length) \
1067 (PSA_ALG_IS_CIPHER(alg) && \
1068 ((key_type) & PSA_KEY_TYPE_CATEGORY_MASK) == PSA_KEY_TYPE_CATEGORY_SYMMETRIC ? \
1082#define PSA_CIPHER_DECRYPT_OUTPUT_MAX_SIZE(input_length) \
1103#define PSA_CIPHER_UPDATE_OUTPUT_SIZE(key_type, alg, input_length) \
1104 (PSA_ALG_IS_CIPHER(alg) ? \
1105 (PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type) != 0 ? \
1106 (((alg) == PSA_ALG_CBC_PKCS7 || \
1107 (alg) == PSA_ALG_CBC_NO_PADDING || \
1108 (alg) == PSA_ALG_ECB_NO_PADDING) ? \
1109 PSA_ROUND_UP_TO_MULTIPLE(PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type), \
1111 (input_length)) : 0) : \
1124#define PSA_CIPHER_UPDATE_OUTPUT_MAX_SIZE(input_length) \
1125 (PSA_ROUND_UP_TO_MULTIPLE(PSA_BLOCK_CIPHER_BLOCK_MAX_SIZE, input_length))
1144#define PSA_CIPHER_FINISH_OUTPUT_SIZE(key_type, alg) \
1145 (PSA_ALG_IS_CIPHER(alg) ? \
1146 (alg == PSA_ALG_CBC_PKCS7 ? \
1147 PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type) : \
1156#define PSA_CIPHER_FINISH_OUTPUT_MAX_SIZE \
1157 (PSA_BLOCK_CIPHER_BLOCK_MAX_SIZE)
Configuration options (set of defines)