mem_unit_test.c File Reference

Test the MEM package. More...

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <stddef.h>
#include <CDM/CDM_pubdefs.h>
#include <ITC/ITC_pubdefs.h>
#include <MSG/MSG_pubdefs.h>
#include <MSG/MSG_printProc.h>
#include <PBS/PBS.h>
#include <PBS/SEM.h>
#include <PBS/TASK.h>
#include <PBS/WUT.h>
#include <MEM/MEM.h>
#include <MEM/MEM_msgs.h>
#include <MEM/MEM_pubdefs.h>
#include <MEM/MEM_tlmdefs.h>
#include <mempriv.h>
#include <mem_unit_test.h>
#include <mem_util_pool.h>
#include <mem_util_tlm.h>

Functions
static void	show_banner (const char *desc_1, const char *desc_2)
	Display a message as a banner.
static void	show_at_level (const int level, const char *item_1, const char *item_2)
	Display text with indentation.
void	test_Push_State (test_Test_Descriptor *td_p, const char *desc, const int index)
	Enter a new test state.
void	test_Pop_State (test_Test_Descriptor *td_p)
	Return for a test state.
static void	show_desc_stack (const test_Test_Descriptor *td_p)
	Display the current state decription stack.
static void	show_status_name (const unsigned int status)
	Display the name for a status code.
static unsigned int	start_message_system (void)
	Start the messaging system.
static unsigned int	stop_message_system (void)
	Stop the messaging system.
void	test_Show (const test_Test_Descriptor *td_p, const int level, const char *item_1, const char *item_2)
	Display text with indentation.
void	test_Show_Msg_OK (const test_Test_Descriptor *td_p)
	Indicate that the next error message is expected.
static WUT_cb_status	test_wut_handler (void *prm, WUT_tmr *wut)
	Handle wake-up timer expiration.
int	test_Delay (const test_Test_Descriptor *td_p, const unsigned int num_msecs)
	Delay the current task a number of milliseconds.
int	test_Generic_Error (const test_Test_Descriptor *td_p, const char *fmt, const char *str_param, const unsigned int int_param)
	Display a generic error message.
int	test_NULL_Compare (const test_Test_Descriptor *td_p, const unsigned int actual, const char *desc)
	Check a 32-bit value to make sure it is not NULL.
int	test_Status_Compare (const test_Test_Descriptor *td_p, const unsigned int expect, const unsigned int actual, const char *func)
	Check a status value returned from a MEM library function.
int	test_Status_Success (const test_Test_Descriptor *td_p, const unsigned int actual, const char *func)
	Check a MSG status code to make sure it's reporting success.
int	test_Value32_Compare (const test_Test_Descriptor *td_p, const unsigned int expect, const unsigned int actual, const char *desc)
	Check a 32-bit value.
int	test_Descriptor_Compare (const test_Test_Descriptor *td_p, const MEM_Descriptor *expect, const MEM_Descriptor *actual, const char *desc)
	Verify the contents of a memory descriptor.
int	test_LoadInfo_Compare (const test_Test_Descriptor *td_p, const MEM_LoadInfo *expect, MEM_LoadInfo *actual)
	Verify the contents of a MEM_LoadInfo object.
int	test_DumpInfo_Compare (const test_Test_Descriptor *td_p, const MEM_DumpInfo *expect, MEM_DumpInfo *actual)
	Verify the contents of a MEM_DumpInfo object.
void	test_Show_Tlm (const test_Test_Descriptor *td_p, const MEM_LMEMSIUDATA_Tlm *expect, const MEM_LMEMSIUDATA_Tlm *actual)
	Display the contents of a dump telemetry packet.
int	test_DumpTlm_Compare (const test_Test_Descriptor *td_p, const MEM_LMEMSIUDATA_Tlm *expect, const MEM_LMEMSIUDATA_Tlm *actual, const char *desc)
	Verify the contents of dump telemetry packet.
int	test_Info_Compare (const test_Test_Descriptor *td_p, const MEM_Info *expect, MEM_Info *actual, const char *desc)
	Verify the contents of a MEM_Info object.
int	test_Memory_Compare (const test_Test_Descriptor *td_p, const void *expect_p, const void *actual_p, const void *mask_p, const size_t num_bytes)
	Verify the contents of a buffer in memory.
void	test_Show_Item (const test_Test_Descriptor *td_p, const char *name, const char *fmt, const char *str_param, const unsigned int int_param)
	Display an item of data.
void	test_Show_Dump_Progress (const test_Test_Descriptor *td_p, const char *name, const size_t chunk_size, const caddr_t addr, const size_t progress, const size_t full_size)
	Display dump progress.
void	test_PrnFill32 (void *startAddr, const unsigned long nWords)
	PRN fill.
unsigned long	test_PrnVerify32 (const void *startAddr, const unsigned long nWords, unsigned long *firstFailure, unsigned long *expect, unsigned long *found)
	PRN verify.
static void	mem_unit_test_func (int *status_p)
	The unit test.
int	mem_unit_test ()
	The unit test entry point.
int	main (void)
	The application entry point for the sun-gcc version of the test.

---

Detailed Description

Test the MEM package.

  CVS $Id: mem_unit_test.c,v 1.18 2011/03/29 01:58:52 apw Exp $
  

Test the constituents of the MEM package. Included in this file is the test 'main', which configures the test environment, invokes individual subtests, and reports status. The actual subtests are contained in separate source files.

This file also includes some support functions that can be used by the subtests to compare actual and expected values, and to display various types of information and status. By passing all user output through these support functions, the output mechanism can be modified without affecting the subtest source code (e.g. changing printf to fprintf).

---

Function Documentation

int main

(

void

)

The application entry point for the sun-gcc version of the test.

Return values:

	0	Success.
	-1	Failure.

References mem_unit_test().

int mem_unit_test

(

)

The unit test entry point.

Run the unit test as a separate task.

Return values:

	0	Success.
	-1	Failure.

References mem_unit_test_func().

Referenced by main().

void mem_unit_test_func

(

int *

status_p

)

[static]

The unit test.

Configures the test environment, runs the various subtests, collects the status values, and displays the results.

Parameters:

status_p

Pointer to location to return test status.

Returns:

Nothing.

References DIM, _test_Test_Descriptor::exec, _test_Test_Descriptor::fail, mem_Control_test(), mem_CreateDescriptor_test(), mem_DumpContext_test(), mem_DumpMemory_test(), mem_DumpParam_test(), mem_DumpRegSet_test(), mem_DumpWrap_test(), mem_LoadContext_test(), mem_LoadMemory_test(), mem_LoadParam_test(), mem_LoadSize_test(), mem_MapBuild_test(), mem_RamAccess_test(), POOL_init(), POOL_shutdown(), show_banner(), start_message_system(), stop_message_system(), test_Delay(), test_Pop_State(), test_Push_State(), TLM_init(), TLM_shutdown(), TLM_start(), TLM_stop(), and _test_Test_Descriptor::wut.

Referenced by mem_unit_test().

void show_at_level	(	const int	level,
		const char *	item_1,
		const char *	item_2
	)			[static]

Display text with indentation.

Display text with indentation appropriate for the specified test state level.

Parameters:

	level	Test state level.
	item_1	First text string to display.
	item_2	Second text string to display.

Returns:

Nothing.

Referenced by show_desc_stack(), test_Descriptor_Compare(), test_DumpInfo_Compare(), test_DumpTlm_Compare(), test_Generic_Error(), test_Info_Compare(), test_LoadInfo_Compare(), test_Memory_Compare(), test_NULL_Compare(), test_Push_State(), test_Show(), test_Show_Dump_Progress(), test_Show_Item(), test_Show_Tlm(), test_Status_Compare(), test_Status_Success(), and test_Value32_Compare().

void show_banner	(	const char *	desc_1,
		const char *	desc_2
	)			[static]

Display a message as a banner.

Parameters:

	desc_1	First text string to display.
	desc_2	Second text string to display.

Returns:

Nothing.

Referenced by mem_unit_test_func(), test_Pop_State(), and test_Push_State().

void show_desc_stack

(

const test_Test_Descriptor *

td_p

)

[static]

Display the current state decription stack.

Display all the state descriptions on the test's state stack.

Parameters:

td_p

Pointer to test descriptor.

Returns:

Nothing.

References _test_Test_Descriptor::depth, _test_Test_Descriptor::desc, _test_Test_Descriptor::index, and show_at_level().

Referenced by test_Descriptor_Compare(), test_DumpInfo_Compare(), test_DumpTlm_Compare(), test_Generic_Error(), test_Info_Compare(), test_LoadInfo_Compare(), test_Memory_Compare(), test_NULL_Compare(), test_Status_Compare(), test_Status_Success(), and test_Value32_Compare().

void show_status_name

(

const unsigned int

status

)

[static]

Display the name for a status code.

Parameters:

status

Status code to interpret.

Returns:

Nothing.

Referenced by test_Status_Compare(), and test_Status_Success().

unsigned int start_message_system

(

void

)

[static]

Start the messaging system.

Returns:

A MEM MSG value.

Referenced by mem_unit_test_func().

unsigned int stop_message_system

(

void

)

[static]

Stop the messaging system.

Returns:

A MEM MSG value.

Referenced by mem_unit_test_func().

int test_Delay	(	const test_Test_Descriptor *	td_p,
		const unsigned int	num_msecs
	)

Delay the current task a number of milliseconds.

Parameters:

	td_p	Pointer to test descriptor.
	num_msecs	Number of milliseconds to delay.

Return values:

	0	Success.
	-1	Failure.

References test_NULL_Compare(), test_Status_Success(), test_wut_handler(), and _test_Test_Descriptor::wut.

Referenced by cmd_send(), mem_loadWrite_wrap(), mem_unit_test_func(), TASK_stop(), and WRAP_check_telem().

int test_Descriptor_Compare	(	const test_Test_Descriptor *	td_p,
		const MEM_Descriptor *	expect,
		const MEM_Descriptor *	actual,
		const char *	desc
	)

Verify the contents of a memory descriptor.

This function verifies the contents of a memory descriptor and reports an error if the values are not as expected.

Parameters:

	td_p	Pointer to test descriptor.
	expect	Pointer to a memory descriptor with the expected values.
	actual	Pointer to the memory descriptor to verify.
	desc	Text description of the descriptor.

Return values:

	0	Descriptor values are correct.
	-1	One or more elements of the descriptor are incorrect.

References _MEM_Descriptor::addr, _MEM_Descriptor::bytes, _test_Test_Descriptor::depth, MEM_MAP_NAME, _MEM_Descriptor::memmap, show_at_level(), show_desc_stack(), and _MEM_Descriptor::words.

Referenced by mem_check_dump_command(), and test_DumpInfo_Compare().

int test_DumpInfo_Compare	(	const test_Test_Descriptor *	td_p,
		const MEM_DumpInfo *	expect,
		MEM_DumpInfo *	actual
	)

Verify the contents of a MEM_DumpInfo object.

This function verifies the contents of a MEM_DumpInfo object and reports an error if the values are not as expected.

Parameters:

	td_p	Pointer to test descriptor.
	expect	Pointer to a MEM_DumpInfo object with the expected values.
	actual	Pointer to the MEM_DumpInfo object to verify.

Return values:

	0	MEM_DumpInfo values are correct.
	-1	One or more elements of the MEM_DumpInfo object are incorrect.

References _MEM_DumpInfo::current_addr, _test_Test_Descriptor::depth, _MEM_DumpInfo::md, show_at_level(), show_desc_stack(), _MEM_DumpInfo::status, test_Descriptor_Compare(), and _MEM_DumpInfo::wrapped.

Referenced by mem_dumpGetInfo_wrap().

int test_DumpTlm_Compare	(	const test_Test_Descriptor *	td_p,
		const MEM_LMEMSIUDATA_Tlm *	expect,
		const MEM_LMEMSIUDATA_Tlm *	actual,
		const char *	desc
	)

Verify the contents of dump telemetry packet.

Parameters:

	td_p	Pointer to test descriptor.
	expect	Pointer to expected telemetry packet values.
	actual	Pointer to actual telemetry packet values.
	desc	Description of the telemetry packet.

Return values:

	0	Telemetry packet values are correct.
	-1	One or more elements of the telemetry packet are incorrect.

References _test_Test_Descriptor::depth, _MEM_LMEMSIUDATA_Tlm::hdr, show_at_level(), show_desc_stack(), and test_Show_Tlm().

Referenced by TLM_check_tlm().

int test_Generic_Error	(	const test_Test_Descriptor *	td_p,
		const char *	fmt,
		const char *	str_param,
		const unsigned int	int_param
	)

Display a generic error message.

Parameters:

	td_p	Pointer to test descriptor.
	fmt	Format string to display.
	str_param	First parameter (string) for fmt string.
	int_param	Second parameter (uint) for fmt string.

Returns:

-1.

References _test_Test_Descriptor::depth, show_at_level(), and show_desc_stack().

Referenced by POOL_shutdown(), TLM_check_no_tlm(), and TLM_check_tlm().

int test_Info_Compare	(	const test_Test_Descriptor *	td_p,
		const MEM_Info *	expect,
		MEM_Info *	actual,
		const char *	desc
	)

Verify the contents of a MEM_Info object.

This function verifies the contents of a MEM_Info object and reports an error if the values are not as expected.

Parameters:

	td_p	Pointer to test descriptor.
	expect	Pointer to a MEM_Info object with the expected values.
	actual	Pointer to the MEM_Info object to verify.
	desc	Description of the information.

Return values:

	0	MEM_Info values are correct.
	-1	One or more elements of the MEM_Info object are incorrect.

References _test_Test_Descriptor::depth, show_at_level(), and show_desc_stack().

Referenced by WRAP_get_info().

int test_LoadInfo_Compare	(	const test_Test_Descriptor *	td_p,
		const MEM_LoadInfo *	expect,
		MEM_LoadInfo *	actual
	)

Verify the contents of a MEM_LoadInfo object.

This function verifies the contents of a MEM_LoadInfo object and reports an error if the values are not as expected.

Parameters:

	td_p	Pointer to test descriptor.
	expect	Pointer to a MEM_LoadInfo object with the expected values.
	actual	Pointer to the MEM_LoadInfo object to verify.

Return values:

	0	MEM_LoadInfo values are correct.
	-1	One or more elements of the MEM_LoadInfo object are incorrect.

References _test_Test_Descriptor::depth, _MEM_LoadInfo::is_active, _MEM_LoadInfo::map, MEM_MAP_NAME, _MEM_LoadInfo::offset, show_at_level(), show_desc_stack(), _MEM_LoadInfo::start_addr, _MEM_LoadInfo::status, and _MEM_LoadInfo::total_bytes.

Referenced by mem_loadGetInfo_wrap().

int test_Memory_Compare	(	const test_Test_Descriptor *	td_p,
		const void *	expect_p,
		const void *	actual_p,
		const void *	mask_p,
		const size_t	num_bytes
	)

Verify the contents of a buffer in memory.

This function verifies the contents of a memory buffer and reports an error if the values are not as expected. An optional mask can be used to indicate which bits should be verified.

Parameters:

	td_p	Pointer to test descriptor.
	expect_p	Pointer to a memory buffer with the expected values.
	actual_p	Pointer to the memory buffer to verify.
	mask_p	Pointer to a memory buffer of mask values.
	num_bytes	Number of bytes to verify within the buffer.

Return values:

	0	Buffer values are correct.
	-1	One or more values within the buffer are incorrect.

References _test_Test_Descriptor::depth, show_at_level(), and show_desc_stack().

Referenced by mem_check_memory_write(), mem_DumpMemory_test(), mem_DumpPCI_test(), mem_DumpRegSet_test(), mem_DumpWrap_test(), mem_LoadMemory_test(), and WRAP_read_surom().

int test_NULL_Compare	(	const test_Test_Descriptor *	td_p,
		const unsigned int	actual,
		const char *	desc
	)

Check a 32-bit value to make sure it is not NULL.

Parameters:

	td_p	Pointer to test descriptor.
	actual	Actual value.
	desc	Description of the value.

Return values:

	0	Actual value != NULL.
	-1	Actual value == NULL.

References _test_Test_Descriptor::depth, show_at_level(), and show_desc_stack().

Referenced by cmd_send(), POOL_init(), TASK_init(), test_Delay(), TLM_check_no_tlm(), TLM_check_tlm(), TLM_init(), TLM_shutdown(), TLM_start(), TLM_stop(), and TLM_tlm_rcvd().

void test_Pop_State

(

test_Test_Descriptor *

td_p

)

Return for a test state.

Pop a test state description from a test's state stack.

Parameters:

td_p

Pointer to test descriptor.

Returns:

Nothing.

References _test_Test_Descriptor::depth, _test_Test_Descriptor::desc, and show_banner().

Referenced by CMD_init(), cmd_send(), CMD_send_dump_mem(), CMD_send_load_mem(), CMD_shutdown(), CMD_start(), CMD_stop(), mem_check_dump_command(), mem_check_memory_write(), mem_check_null_desc_params(), mem_Control_test(), mem_CreateDescriptor_test(), mem_DumpContext_test(), mem_dumpGetContext_wrap(), mem_dumpGetData_wrap(), mem_dumpGetInfo_wrap(), mem_dumpInit_wrap(), mem_dumpMapAddEntry_wrap(), mem_dumpMapInit_wrap(), mem_DumpMemory_test(), mem_DumpParam_test(), mem_DumpPCI_test(), mem_DumpRegSet_test(), mem_dumpReleaseContext_wrap(), mem_dumpStart_wrap(), mem_DumpWrap_test(), mem_LoadContext_test(), mem_loadGetContext_wrap(), mem_loadGetInfo_wrap(), mem_loadInit_wrap(), mem_loadMapAddEntry_wrap(), mem_loadMapInit_wrap(), mem_LoadMemory_test(), mem_LoadParam_test(), mem_loadPktMemory_wrap(), mem_loadPktPci_wrap(), mem_loadPktReg_wrap(), mem_loadReleaseContext_wrap(), mem_LoadSize_test(), mem_loadWrite_wrap(), mem_mapAddEntry_wrap(), mem_MapBuild_test(), mem_mapInit_wrap(), mem_RamAccess_test(), mem_unit_test_func(), mem_ValidateMemoryRange_test(), POOL_init(), POOL_shutdown(), TASK_add_queue(), TASK_init(), TASK_remove_queue(), TASK_shutdown(), TASK_start(), TASK_stop(), TLM_check_tlm(), TLM_init(), TLM_shutdown(), TLM_start(), TLM_stop(), TLM_tlm_rcvd(), WRAP_check_telem(), WRAP_get_info(), WRAP_init(), WRAP_initialize(), WRAP_read_surom(), and WRAP_shutdown().

void test_PrnFill32	(	void *	startAddr,
		const unsigned long	nWords
	)

PRN fill.

Fills a buffer in memory with a pseudo-random sequence of numbers.

The PRN is based on this polynomial: 8 7 5 3 h(x) = x + x + x + x + 1

Parameters:

	startAddr	(input) Pointer to start of 32-bit aligned memory buffer.
	nWords	(input) Number of 32-bit words to fill.

Referenced by mem_check_memory_write(), mem_DumpMemory_test(), mem_DumpWrap_test(), and mem_LoadMemory_test().

unsigned long test_PrnVerify32	(	const void *	startAddr,
		const unsigned long	nWords,
		unsigned long *	firstFailure,
		unsigned long *	expect,
		unsigned long *	found
	)

PRN verify.

Verifies a pseudo-random sequence of numbers and reports number of errors found and details about the first error.

The PRN is based on this polynomial: 8 7 5 3 h(x) = x + x + x + x + 1

Parameters:

	startAddr	(input) Pointer to start of 32-bit aligned sequence.
	nWords	(input) Number of 32-bit words to verify.
	firstFailure	(output) 32-bit offset of first failure.
	expect	(output) Data expected at first failure.
	found	(output) Actual data found at first failure.

Return values:

Number

of errors found.

void test_Push_State	(	test_Test_Descriptor *	td_p,
		const char *	desc,
		const int	index
	)

Enter a new test state.

Push a new test state description onto a test's state stack. This state stack provides a trace of the execution of the test.

Parameters:

	td_p	Pointer to test descriptor.
	desc	Description of the new state.
	index	Generic index value.

Returns:

Nothing.

References _test_Test_Descriptor::depth, _test_Test_Descriptor::desc, DIM, _test_Test_Descriptor::index, show_at_level(), and show_banner().

Referenced by CMD_init(), cmd_send(), CMD_send_dump_mem(), CMD_send_load_mem(), CMD_shutdown(), CMD_start(), CMD_stop(), mem_check_dump_command(), mem_check_memory_write(), mem_check_null_desc_params(), mem_Control_test(), mem_CreateDescriptor_test(), mem_DumpContext_test(), mem_dumpGetContext_wrap(), mem_dumpGetData_wrap(), mem_dumpGetInfo_wrap(), mem_dumpInit_wrap(), mem_dumpMapAddEntry_wrap(), mem_dumpMapInit_wrap(), mem_DumpMemory_test(), mem_DumpParam_test(), mem_DumpPCI_test(), mem_DumpRegSet_test(), mem_dumpReleaseContext_wrap(), mem_dumpStart_wrap(), mem_DumpWrap_test(), mem_LoadContext_test(), mem_loadGetContext_wrap(), mem_loadGetInfo_wrap(), mem_loadInit_wrap(), mem_loadMapAddEntry_wrap(), mem_loadMapInit_wrap(), mem_LoadMemory_test(), mem_LoadParam_test(), mem_loadPktMemory_wrap(), mem_loadPktPci_wrap(), mem_loadPktReg_wrap(), mem_loadReleaseContext_wrap(), mem_LoadSize_test(), mem_loadWrite_wrap(), mem_mapAddEntry_wrap(), mem_MapBuild_test(), mem_mapInit_wrap(), mem_RamAccess_test(), mem_unit_test_func(), mem_ValidateMemoryRange_test(), POOL_init(), POOL_shutdown(), TASK_add_queue(), TASK_init(), TASK_remove_queue(), TASK_shutdown(), TASK_start(), TASK_stop(), TLM_check_tlm(), TLM_init(), TLM_shutdown(), TLM_start(), TLM_stop(), TLM_tlm_rcvd(), WRAP_check_telem(), WRAP_get_info(), WRAP_init(), WRAP_initialize(), WRAP_read_surom(), and WRAP_shutdown().

void test_Show	(	const test_Test_Descriptor *	td_p,
		const int	level,
		const char *	item_1,
		const char *	item_2
	)

Display text with indentation.

Display text with indentation appropriate for the specified level.

Parameters:

	td_p	Pointer to test descriptor.
	level	Indentation level.
	item_1	First text string to display.
	item_2	Second text string to display.

Returns:

Nothing.

References show_at_level().

Referenced by test_Show_Msg_OK().

void test_Show_Dump_Progress	(	const test_Test_Descriptor *	td_p,
		const char *	name,
		const size_t	chunk_size,
		const caddr_t	addr,
		const size_t	progress,
		const size_t	full_size
	)

Display dump progress.

This function displays the progress of a dump.

Parameters:

	td_p	Pointer to test descriptor.
	name	Name of the dump.
	chunk_size	Number of bytes dumped in last chunk.
	addr	Starting address of last chunk.
	progress	Number of bytes dumped so far.
	full_size	Full size of the dump, in bytes.

Returns:

Nothing.

References _test_Test_Descriptor::depth, and show_at_level().

Referenced by mem_dumpGetData_wrap().

void test_Show_Item	(	const test_Test_Descriptor *	td_p,
		const char *	name,
		const char *	fmt,
		const char *	str_param,
		const unsigned int	int_param
	)

Display an item of data.

This function displays an item of data in a predefined format.

Parameters:

	td_p	Pointer to test descriptor.
	name	Name of the item.
	fmt	Format string to display the item's value.
	str_param	First parameter (string) for fmt string.
	int_param	Second parameter (uint) for fmt string.

Returns:

Nothing.

References _test_Test_Descriptor::depth, and show_at_level().

Referenced by cmd_send(), mem_ValidateMemoryRange_test(), and tlm_dispatch().

void test_Show_Msg_OK

(

const test_Test_Descriptor *

td_p

)

Indicate that the next error message is expected.

Display text that indicates that the next error message is expected.

Parameters:

td_p

Pointer to test descriptor.

Returns:

Nothing.

References test_Show().

Referenced by cmd_send(), mem_check_dump_command(), mem_check_null_desc_params(), mem_dumpGetContext_wrap(), mem_dumpGetData_wrap(), mem_dumpGetInfo_wrap(), mem_dumpInit_wrap(), mem_dumpMapAddEntry_wrap(), mem_dumpMapInit_wrap(), mem_dumpReleaseContext_wrap(), mem_dumpStart_wrap(), mem_loadGetContext_wrap(), mem_loadGetInfo_wrap(), mem_loadInit_wrap(), mem_loadMapAddEntry_wrap(), mem_loadMapInit_wrap(), mem_loadPktMemory_wrap(), mem_loadPktPci_wrap(), mem_loadPktReg_wrap(), mem_loadReleaseContext_wrap(), mem_loadWrite_wrap(), mem_mapAddEntry_wrap(), mem_mapInit_wrap(), mem_ValidateMemoryRange_test(), WRAP_get_info(), WRAP_init(), WRAP_initialize(), and WRAP_shutdown().

void test_Show_Tlm	(	const test_Test_Descriptor *	td_p,
		const MEM_LMEMSIUDATA_Tlm *	expect,
		const MEM_LMEMSIUDATA_Tlm *	actual
	)

Display the contents of a dump telemetry packet.

Parameters:

	td_p	Pointer to test descriptor.
	expect	Pointer to expected telemetry packet values.
	actual	Pointer to actual telemetry packet values.

Returns:

Nothing.

References _MEM_LMEMSIUDATA_Tlm::address, _MEM_TIDBF::bf, _MEM_LMEMSIUDATA_Tlm::cmdFuncCode, _MEM_LMEMSIUDATA_Tlm::data, _test_Test_Descriptor::depth, _MEM_LMEMSIUDATA_Tlm::idents, show_at_level(), and _MEM_LMEMSIUDATA_Tlm::wordCount.

Referenced by test_DumpTlm_Compare(), and TLM_check_no_tlm().

int test_Status_Compare	(	const test_Test_Descriptor *	td_p,
		const unsigned int	expect,
		const unsigned int	actual,
		const char *	func
	)

Check a status value returned from a MEM library function.

Compare actual and expected status values returned from a MEM library function and display a message if they differ.

Parameters:

	td_p	Pointer to test descriptor.
	expect	Expected value.
	actual	Actual value.
	func	Name of the MEM library function that returned the status.

Return values:

	0	Actual value == Expected value
	-1	Actual value != Expected value.

References _test_Test_Descriptor::depth, show_at_level(), show_desc_stack(), and show_status_name().

Referenced by cmd_send(), mem_check_dump_command(), mem_check_null_desc_params(), mem_dumpGetContext_wrap(), mem_dumpGetData_wrap(), mem_dumpGetInfo_wrap(), mem_dumpInit_wrap(), mem_dumpMapAddEntry_wrap(), mem_dumpMapInit_wrap(), mem_DumpPCI_test(), mem_dumpReleaseContext_wrap(), mem_dumpStart_wrap(), mem_loadGetContext_wrap(), mem_loadGetInfo_wrap(), mem_loadInit_wrap(), mem_loadMapAddEntry_wrap(), mem_loadMapInit_wrap(), mem_loadPktMemory_wrap(), mem_loadPktPci_wrap(), mem_loadPktReg_wrap(), mem_loadReleaseContext_wrap(), mem_loadWrite_wrap(), mem_mapAddEntry_wrap(), mem_mapInit_wrap(), mem_ValidateMemoryRange_test(), WRAP_get_info(), WRAP_init(), WRAP_initialize(), and WRAP_shutdown().

int test_Status_Success	(	const test_Test_Descriptor *	td_p,
		const unsigned int	actual,
		const char *	func
	)

Check a MSG status code to make sure it's reporting success.

Parameters:

	td_p	Pointer to test descriptor.
	actual	Actual value.
	func	Name of the function that returned the status.

Return values:

	0	Actual value == Expected value
	-1	Actual value != Expected value.

References _test_Test_Descriptor::depth, show_at_level(), show_desc_stack(), and show_status_name().

Referenced by cmd_send(), POOL_init(), TASK_add_queue(), TASK_init(), TASK_remove_queue(), TASK_shutdown(), TASK_start(), TASK_stop(), test_Delay(), TLM_init(), and TLM_shutdown().

int test_Value32_Compare	(	const test_Test_Descriptor *	td_p,
		const unsigned int	expect,
		const unsigned int	actual,
		const char *	desc
	)

Check a 32-bit value.

Compare actual and expected 32-bit values and display a message if they differ.

Parameters:

	td_p	Pointer to test descriptor.
	expect	Expected value.
	actual	Actual value.
	desc	Description of the value.

Return values:

	0	Actual value == Expected value.
	-1	Actual value != Expected value.

References _test_Test_Descriptor::depth, show_at_level(), and show_desc_stack().

Referenced by mem_dumpGetData_wrap(), POOL_shutdown(), TLM_check_tlm(), and WRAP_read_surom().

WUT_cb_status test_wut_handler	(	void *	prm,
		WUT_tmr *	wut
	)			[static]

Handle wake-up timer expiration.

Parameters:

	prm	Pointer to semaphore to give.
	wut	Pointer to wake-up timer.

Returns:

WUT status.

Referenced by test_Delay().