4772884133
Using static inline functions is bad for code size; the function from md_internal.h was already used from 3 different C files, so already was copied at least 3 times in the library, and this would only get worse over time. Use actual functions, and also share the actual data between them. Provide a consistent set of operations. Conversion to/from human-readable string was omitted for now but could be added later if needed. In the future, this can be used to replace other similar (inline) functions that are currently scattered, including (but perhaps not limited to): - mbedtls_psa_translate_md() from psa_util.h - mbedtls_md_info_from_psa() (indirectly) from psa_crypto_hash.h - get_md_alg_from_psa() from psa_crypto_rsa.c Signed-off-by: Manuel Pégourié-Gonnard <manuel.pegourie-gonnard@arm.com>
78 lines
2.6 KiB
C
78 lines
2.6 KiB
C
/**
|
|
* Hash information that's independent from the crypto implementation.
|
|
*
|
|
* This can be used by:
|
|
* - code based on PSA
|
|
* - code based on the legacy API
|
|
* - code based on either of them depending on MBEDTLS_USE_PSA_CRYPTO
|
|
* - code based on either of them depending on what's available
|
|
*
|
|
* Note: this internal module will go away when everything become based on
|
|
* PSA Crypto; it is a helper for the transition while hash algorithms are
|
|
* wtill represented using mbedtls_md_type_t in most places even when PSA is
|
|
* used for the actual crypto computations.
|
|
*
|
|
* Copyright The Mbed TLS Contributors
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
* not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
#ifndef MBEDTLS_HASH_INFO_H
|
|
#define MBEDTLS_HASH_INFO_H
|
|
|
|
#include "common.h"
|
|
|
|
#include "mbedtls/md.h"
|
|
#include "psa/crypto.h"
|
|
|
|
/** Get the output length of the given hash type from its MD type.
|
|
*
|
|
* \note To get the output length from the PSA alg, use \c PSA_HASH_LENGTH().
|
|
*
|
|
* \param md_type The hash MD type.
|
|
*
|
|
* \return The output length in bytes, or 0 if not known.
|
|
*/
|
|
unsigned char mbedtls_hash_info_get_size( mbedtls_md_type_t md_type );
|
|
|
|
/** Get the block size of the given hash type from its MD type.
|
|
*
|
|
* \note To get the output length from the PSA alg, use
|
|
* \c PSA_HASH_BLOCK_LENGTH().
|
|
*
|
|
* \param md_type The hash MD type.
|
|
*
|
|
* \return The block size in bytes, or 0 if not known.
|
|
*/
|
|
unsigned char mbedtls_hash_info_get_block_size( mbedtls_md_type_t md_type );
|
|
|
|
/** Get the PSA alg from the MD type.
|
|
*
|
|
* \param md_type The hash MD type.
|
|
*
|
|
* \return The corresponding PSA algorithm identifier,
|
|
* or PSA_ALG_NONE if not known.
|
|
*/
|
|
psa_algorithm_t mbedtls_hash_info_psa_from_md( mbedtls_md_type_t md_type );
|
|
|
|
/** Get the MD type alg from the PSA algorithm identifier.
|
|
*
|
|
* \param psa_alg The PSA hash algorithm.
|
|
*
|
|
* \return The corresponding MD type,
|
|
* or MBEDTLS_MD_NONE if not known.
|
|
*/
|
|
mbedtls_md_type_t mbedtls_hash_info_md_from_psa( psa_algorithm_t psa_alg );
|
|
|
|
#endif /* MBEDTLS_HASH_INFO_H */
|