support/include/test_support.h

0001 /* SPDX-License-Identifier: BSD-2-Clause */
0002
0003 /*
0004  *  COPYRIGHT (c) 1989-2011.
0005  *  On-Line Applications Research Corporation (OAR).
0006  *
0007  * Redistribution and use in source and binary forms, with or without
0008  * modification, are permitted provided that the following conditions
0009  * are met:
0010  * 1. Redistributions of source code must retain the above copyright
0011  *    notice, this list of conditions and the following disclaimer.
0012  * 2. Redistributions in binary form must reproduce the above copyright
0013  *    notice, this list of conditions and the following disclaimer in the
0014  *    documentation and/or other materials provided with the distribution.
0015  *
0016  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
0017  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
0018  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
0019  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
0020  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
0021  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
0022  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
0023  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
0024  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
0025  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
0026  * POSSIBILITY OF SUCH DAMAGE.
0027  */
0028
0029 #ifndef __TEST_SUPPORT_h
0030 #define __TEST_SUPPORT_h
0031
0032 #include <stdarg.h>
0033 #include <rtems.h>
0034
0035 #ifdef __cplusplus
0036 extern "C" {
0037 #endif
0038
0039 /*
0040  *  Return a pointer to the POSIX name that is slightly
0041  *  beyond the legal limit.
0042  */
0043 const char *Get_Too_Long_Name(void);
0044
0045 /*
0046  *  Return a pointer to the longest legal POSIX name.
0047  */
0048 const char *Get_Longest_Name(void);
0049
0050 /*
0051  *  Spin for specified number of ticks.  The first tick we spin through is a
0052  *  partial one.
0053  */
0054 void rtems_test_spin_for_ticks(rtems_interval ticks);
0055
0056 /*
0057  *  Spin until the next clock tick
0058  */
0059 void rtems_test_spin_until_next_tick( void );
0060
0061 /*********************************************************************/
0062 /*********************************************************************/
0063 /**************              TMTEST SUPPORT             **************/
0064 /*********************************************************************/
0065 /*********************************************************************/
0066
0067 /*
0068  *  Type of method used for timing operations
0069  */
0070 typedef void (*rtems_time_test_method_t)(
0071   int    iteration,
0072   void  *argument
0073 );
0074
0075 /*
0076  *  Obtain baseline timing information for benchmark tests.
0077  */
0078 void rtems_time_test_measure_operation(
0079   const char               *description,
0080   rtems_time_test_method_t  operation,
0081   void                     *argument,
0082   int                       iterations,
0083   int                       overhead
0084 );
0085
0086 /*********************************************************************/
0087 /*********************************************************************/
0088 /**************              TEST SUPPORT               **************/
0089 /*********************************************************************/
0090 /*********************************************************************/
0091
0092 void locked_print_initialize(void);
0093
0094 int locked_printf(const char *fmt, ...);
0095
0096 int locked_vprintf(const char *fmt, va_list ap);
0097
0098 #ifdef __cplusplus
0099 };
0100 #endif
0101
0102 #endif