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)