sys/psa_crypto: Split asymmetric signature size definitions into separate file

TODO

Signed-off-by: Armin Wolf <[email protected]>

Author: Wer-Wolf

sys/include/psa_crypto/psa/asymmetric_signature/sizes.h

@@ -0,0 +1,82 @@
+/*
+ * Copyright (C) 2025 TU Dresden
+ * Copyright (C) 2021 HAW Hamburg
+ *
+ * This file is subject to the terms and conditions of the GNU Lesser
+ * General Public License v2.1. See the file LICENSE in the top level
+ * directory for more details.
+ */
+
+/**
+ * @ingroup     sys_psa_crypto
+ * @{
+ *
+ * @file        asymmetric_signature/sizes.h
+ * @brief       Asymmetric signature size definitions for the PSA Crypto API
+ *
+ * @author      Armin Wolf <[email protected]>
+ * @author      Lena Boeckmann <[email protected]>
+ *
+ */
+
+#pragma once
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "psa/sizes.h"
+#include "psa/key/type.h"
+
+/**
+ * @brief   A sufficient signature buffer size for @ref psa_sign_message() and
+ *          @ref psa_sign_hash(), for any of the supported key types and asymmetric signature
+ *          algorithms.
+ *
+ * @details If the size of the signature buffer is at least this large, it is guaranteed that
+ *          @ref psa_sign_message() and @ref psa_sign_hash() will not fail due to an insufficient
+ *          buffer size.
+ *
+ *          See also @ref PSA_SIGN_OUTPUT_SIZE().
+ */
+#define PSA_SIGNATURE_MAX_SIZE /* implementation-defined value */
+
+/**
+ * @brief   ECDSA signature size for a given curve bit size
+ *
+ * @note    This macro returns a compile-time constant if its argument is one.
+ *
+ * @param   curve_bits    Curve size in bits.
+ *
+ * @return  Signature size in bytes.
+ */
+#define PSA_ECDSA_SIGNATURE_SIZE(curve_bits)    \
+    ((size_t)(PSA_BITS_TO_BYTES(curve_bits) * 2))
+
+/**
+ * @brief   Sufficient signature buffer size for @ref psa_sign_message() and @ref psa_sign_hash().
+ *
+ * @details If the size of the signature buffer is at least this large, it is guaranteed that
+ *          @ref psa_sign_message() and @ref psa_sign_hash() will not fail due to an insufficient
+ *          buffer size. The actual size of the output might be smaller in any given call.
+ *
+ *          See also @ref PSA_SIGNATURE_MAX_SIZE.
+ *
+ * @param   key_type An asymmetric key type. This can be a key pair type or a public key type.
+ * @param   key_bits The size of the key in bits.
+ * @param   alg      The signature algorithm.
+ *
+ * @return  A sufficient signature buffer size for the specified asymmetric signature algorithm and
+ *          key parameters.
+ *          0 if algorithm and key parameters are not supported.
+ *          If the parameters are not valid, the return value is unspecified.
+ */
+#define PSA_SIGN_OUTPUT_SIZE(key_type, key_bits, alg)        \
+    (PSA_KEY_TYPE_IS_ECC(key_type) ? PSA_ECDSA_SIGNATURE_SIZE(key_bits) : \
+     ((void)alg, 0))
+
+#ifdef __cplusplus
+}
+#endif
+
+/** @} */

sys/include/psa_crypto/psa/crypto_sizes.h

@@ -33,6 +33,7 @@ extern "C" {
 
 #include "aead/sizes.h"
 #include "asymmetric_encryption/sizes.h"
+#include "asymmetric_signature/sizes.h"
 #include "cipher/sizes.h"
 #include "hash/sizes.h"
 #include "key/sizes.h"
@@ -42,40 +43,6 @@ extern "C" {
 #include "mac/sizes.h"
 #include "sizes.h"
 
-/**
- * @brief   ECDSA signature size for a given curve bit size
- *
- * @note    This macro returns a compile-time constant if its argument is one.
- *
- * @param   curve_bits    Curve size in bits.
- *
- * @return  Signature size in bytes.
- */
-#define PSA_ECDSA_SIGNATURE_SIZE(curve_bits)    \
-    ((size_t)(PSA_BITS_TO_BYTES(curve_bits) * 2))
-
-/**
- * @brief   Sufficient signature buffer size for @ref psa_sign_message() and @ref psa_sign_hash().
- *
- * @details If the size of the signature buffer is at least this large, it is guaranteed that
- *          @ref psa_sign_message() and @ref psa_sign_hash() will not fail due to an insufficient
- *          buffer size. The actual size of the output might be smaller in any given call.
- *
- *          See also @ref PSA_SIGNATURE_MAX_SIZE.
- *
- * @param   key_type An asymmetric key type. This can be a key pair type or a public key type.
- * @param   key_bits The size of the key in bits.
- * @param   alg      The signature algorithm.
- *
- * @return  A sufficient signature buffer size for the specified asymmetric signature algorithm and
- *          key parameters.
- *          0 if algorithm and key parameters are not supported.
- *          If the parameters are not valid, the return value is unspecified.
- */
-#define PSA_SIGN_OUTPUT_SIZE(key_type, key_bits, alg)        \
-    (PSA_KEY_TYPE_IS_ECC(key_type) ? PSA_ECDSA_SIGNATURE_SIZE(key_bits) : \
-     ((void)alg, 0))
-
 #ifdef __cplusplus
 }
 #endif

sys/include/psa_crypto/psa/crypto_values.h

@@ -39,19 +39,6 @@ extern "C" {
 #include "psa/asymmetric_encryption/algorithm.h"
 #include "psa/asymmetric_signature/algorithm.h"
 
-/**
- * @brief   A sufficient signature buffer size for @ref psa_sign_message() and
- *          @ref psa_sign_hash(), for any of the supported key types and asymmetric signature
- *          algorithms.
- *
- * @details If the size of the signature buffer is at least this large, it is guaranteed that
- *          @ref psa_sign_message() and @ref psa_sign_hash() will not fail due to an insufficient
- *          buffer size.
- *
- *          See also @ref PSA_SIGN_OUTPUT_SIZE().
- */
-#define PSA_SIGNATURE_MAX_SIZE /* implementation-defined value */
-
 #ifdef __cplusplus
 }
 #endif