TEX_rtos.c File Reference

Special facilities to aid in tracing exceptions. More...

#include <TEX/TEX_pubdefs.h>

Functions
static void	exceptionDummy (unsigned long long tim, unsigned int fui, unsigned int *dat)
	Dummy routine until real routine can be loaded.
unsigned int	TRC_configureEnables (unsigned int msk, unsigned int val)
	Configure the elements to trace.
TRC_cb_Exception *	TRC_setExceptionRoutine (TRC_cb_Exception *new)
	Change the routine used to trace exceptions.
Variables
TRC_cb_Exception *	TRC_vectorException = exceptionDummy
	Points to the routine providing exception tracing facilities.
unsigned int	TRC_enableMask
	Bit-mask of the trace elements enabled.

---

Detailed Description

Special facilities to aid in tracing exceptions.

CVS $Id: TEX_rtos.c,v 1.2 2011/03/24 22:38:54 apw Exp $

Author:

A.P.Waite

---

Function Documentation

void exceptionDummy	(	unsigned long long	tim,
		unsigned int	fui,
		unsigned int *	dat
	)			[static]

Dummy routine until real routine can be loaded.

Parameters:

	tim	(in) Timestamp to record into the trace
	fui	(in) Record format
	dat	(in) Record data (always 6 longwords = 24 bytes)

unsigned int TRC_configureEnables	(	unsigned int	msk,
		unsigned int	val
	)

Configure the elements to trace.

Parameters:

	msk	(in) Mask of elements to touch
	val	(in) Values to set masked bits to

Returns:

The previous enable mask

TRC_configureEnables() enables/disables the elements that are written to the system trace. The routine functions as a selective set and clear. Bits that the caller wishes to change should be set in the msk parameter. The value to which they should be set should appear in the corresponding position(s) of the val parameter (bit set means enable).

Thus both msk and val should be filled from mask bits. Suitable mask bits are provided as #define macros beginning with the prefix TRC_M_TRC_.

TRC_cb_Exception * TRC_setExceptionRoutine

(

TRC_cb_Exception *

new

)

Change the routine used to trace exceptions.

Parameters:

new

(in) New routine to call for exception tracing

Return values:

x

Routine previously used for exception tracing

When the exception tracing facilities are first initialized, there's no trace in existence. For that reason, these facilities come up with a dummy routine defined for the trace exception routine. At a later point during system initialization, the dummy can be replaced with a functional routine by using this call.