This header file provides interfaces of the RTEMS Test Support. More...

#include <rtems.h>
#include <rtems/score/atomic.h>
#include <rtems/score/smpbarrier.h>

Data Structures
struct	rtems_test_parallel_context
	Internal context for parallel job execution. More...

struct	rtems_test_parallel_job
	Basic parallel job description. More...

Macros
#define	RTEMS_TEST_INITIAL_EXTENSION { NULL, NULL, NULL, NULL, NULL, NULL, NULL, rtems_test_fatal_extension, NULL }
	Initial extension for tests.

#define	TEST_STATE RTEMS_TEST_STATE_PASS

#define	RTEMS_TEST_PARALLEL_PROCESSOR_MAX 32

Typedefs
typedef struct rtems_test_parallel_job	rtems_test_parallel_job

typedef void(*	rtems_test_parallel_worker_setup) (rtems_test_parallel_context *ctx, size_t worker_index, rtems_id worker_id)
	Worker task setup handler.

Enumerations
enum	RTEMS_TEST_STATE { RTEMS_TEST_STATE_PASS , RTEMS_TEST_STATE_FAIL , RTEMS_TEST_STATE_USER_INPUT , RTEMS_TEST_STATE_INDETERMINATE , RTEMS_TEST_STATE_BENCHMARK }
	Test states.

Functions
void	rtems_test_fatal_extension (rtems_fatal_source source, bool always_set_to_false, rtems_fatal_code code)
	Fatal extension for tests.

int	rtems_test_begin (const char *name, const RTEMS_TEST_STATE state)
	Prints a begin of test message using printf().

int	rtems_test_end (const char *name)
	Prints an end of test message using printf().

RTEMS_NO_RETURN void	rtems_test_exit (int status)
	Exit the test without calling exit() since it closes stdin, etc and pulls in stdio code.

void	rtems_test_parallel (rtems_test_parallel_context ctx, rtems_test_parallel_worker_setup worker_setup, const rtems_test_parallel_job jobs, size_t job_count)
	Runs a bunch of jobs in parallel on all processors of the system.

void	rtems_test_busy_cpu_usage (time_t seconds, long nanoseconds)
	Performs a busy loop for the specified seconds and nanoseconds based on the CPU usage of the executing thread.

RTEMS_NO_RETURN void	rtems_test_run (rtems_task_argument arg, const RTEMS_TEST_STATE state)
	Runs the test cases of the RTEMS Test Framework using a default configuration in the context of a task.

void	rtems_test_gcov_dump_info (void)
	Dumps the gcov information as a base64 encoded gcfn and gcda data stream using rtems_put_char().

Variables
const char	rtems_test_name []
	Each test must define a test name string.

Detailed Description

This header file provides interfaces of the RTEMS Test Support.

Data Structures