| /** |
| * \file helpers.h |
| * |
| * \brief This file contains the prototypes of helper functions for the |
| * purpose of testing. |
| */ |
| |
| /* |
| * Copyright (C) 2020, ARM Limited, All Rights Reserved |
| * 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. |
| * |
| * This file is part of mbed TLS (https://tls.mbed.org) |
| */ |
| |
| #ifndef TEST_HELPERS_H |
| #define TEST_HELPERS_H |
| |
| #if !defined(MBEDTLS_CONFIG_FILE) |
| #include "mbedtls/config.h" |
| #else |
| #include MBEDTLS_CONFIG_FILE |
| #endif |
| |
| #if defined(MBEDTLS_PLATFORM_C) |
| #include "mbedtls/platform.h" |
| #else |
| #include <stdio.h> |
| #define mbedtls_fprintf fprintf |
| #define mbedtls_snprintf snprintf |
| #define mbedtls_calloc calloc |
| #define mbedtls_free free |
| #define mbedtls_exit exit |
| #define mbedtls_time time |
| #define mbedtls_time_t time_t |
| #define MBEDTLS_EXIT_SUCCESS EXIT_SUCCESS |
| #define MBEDTLS_EXIT_FAILURE EXIT_FAILURE |
| #endif |
| |
| #include <stddef.h> |
| #include <stdint.h> |
| |
| int mbedtls_test_platform_setup( void ); |
| void mbedtls_test_platform_teardown( void ); |
| |
| /** |
| * \brief This function translates an ASCII string encoding an |
| * hexadecimal number into the encoded hexadecimal number. The |
| * hexadecimal number is represented as an array of |
| * unsigned char. |
| * |
| * \note The output buffer can be the same as the input buffer. For |
| * any other overlapping of the input and output buffers, the |
| * behavior is undefined. |
| * |
| * \param obuf Output buffer. |
| * \param obufmax Size in number of bytes of \p obuf. |
| * \param ibuf Input buffer. |
| * \param len The number of unsigned char written in \p obuf. This must |
| * not be \c NULL. |
| * |
| * \return \c 0 on success. |
| * \return \c -1 if the output buffer is too small or the input string |
| * is not a valid ASCII encoding of an hexadecimal number. |
| */ |
| int mbedtls_test_unhexify( unsigned char *obuf, size_t obufmax, |
| const char *ibuf, size_t *len ); |
| |
| void mbedtls_test_hexify( unsigned char *obuf, |
| const unsigned char *ibuf, |
| int len ); |
| |
| /** |
| * Allocate and zeroize a buffer. |
| * |
| * If the size if zero, a pointer to a zeroized 1-byte buffer is returned. |
| * |
| * For convenience, dies if allocation fails. |
| */ |
| unsigned char *mbedtls_test_zero_alloc( size_t len ); |
| |
| /** |
| * Allocate and fill a buffer from hex data. |
| * |
| * The buffer is sized exactly as needed. This allows to detect buffer |
| * overruns (including overreads) when running the test suite under valgrind. |
| * |
| * If the size if zero, a pointer to a zeroized 1-byte buffer is returned. |
| * |
| * For convenience, dies if allocation fails. |
| */ |
| unsigned char *mbedtls_test_unhexify_alloc( const char *ibuf, size_t *olen ); |
| |
| int mbedtls_test_hexcmp( uint8_t * a, uint8_t * b, |
| uint32_t a_len, uint32_t b_len ); |
| |
| #endif /* TEST_HELPERS_H */ |