---

GLAST/LAT > DAQ and FSW > FSW > Doxygen Index > VXW / V6-12-2

Constituent: vxw_tornado     Tag: rad750

---

         

---

TRX_trace.h File Reference

Definitions for the trace-exceptions facility. More...

This graph shows which files directly or indirectly include this file:

Defines
#define	REG_MSR()
	Fetches the value of the current MSR (machine status register).
#define	TRX_L_EXCEPTIONS   (16)
	Maximum number of exceptions accessible.
#define	TRX_F_TRACE_FACILITY   (0x01)
	"Facility" number for exception trace entries
Typedefs
typedef enum _TRX_K_Exception	TRX_K_Exception
	Typedef for enum _TRX_K_Exception.
typedef enum _TRX_M_Exception	TRX_M_Exception
	Typedef for enum _TRX_M_Exception.
typedef unsigned int	TRX_cb_Routine (unsigned int fui, unsigned int *dat)
	Signature for routine to record a trace entry.
Enumerations
enum	_TRX_K_Exception {   TRX_K_EXCEPTION_0 = 0x0,   TRX_K_EXCEPTION_1 = 0x1,   TRX_K_EXCEPTION_2 = 0x2,   TRX_K_EXCEPTION_3 = 0x3,   TRX_K_EXCEPTION_4 = 0x4,   TRX_K_EXCEPTION_5 = 0x5,   TRX_K_EXCEPTION_6 = 0x6,   TRX_K_EXCEPTION_7 = 0x7,   TRX_K_EXCEPTION_8 = 0x8,   TRX_K_EXCEPTION_9 = 0x9,   TRX_K_EXCEPTION_A = 0xA,   TRX_K_EXCEPTION_B = 0xB,   TRX_K_EXCEPTION_C = 0xC,   TRX_K_EXCEPTION_D = 0xD,   TRX_K_EXCEPTION_E = 0xE,   TRX_K_EXCEPTION_F = 0xF }
	Enumeration of excpetions. More...
enum	_TRX_M_Exception {   TRX_M_EXCEPTION_0 = (1 << TRX_K_EXCEPTION_0),   TRX_M_EXCEPTION_1 = (1 << TRX_K_EXCEPTION_1),   TRX_M_EXCEPTION_2 = (1 << TRX_K_EXCEPTION_2),   TRX_M_EXCEPTION_3 = (1 << TRX_K_EXCEPTION_3),   TRX_M_EXCEPTION_4 = (1 << TRX_K_EXCEPTION_4),   TRX_M_EXCEPTION_5 = (1 << TRX_K_EXCEPTION_5),   TRX_M_EXCEPTION_6 = (1 << TRX_K_EXCEPTION_6),   TRX_M_EXCEPTION_7 = (1 << TRX_K_EXCEPTION_7),   TRX_M_EXCEPTION_8 = (1 << TRX_K_EXCEPTION_8),   TRX_M_EXCEPTION_9 = (1 << TRX_K_EXCEPTION_9),   TRX_M_EXCEPTION_A = (1 << TRX_K_EXCEPTION_A),   TRX_M_EXCEPTION_B = (1 << TRX_K_EXCEPTION_B),   TRX_M_EXCEPTION_C = (1 << TRX_K_EXCEPTION_C),   TRX_M_EXCEPTION_D = (1 << TRX_K_EXCEPTION_D),   TRX_M_EXCEPTION_E = (1 << TRX_K_EXCEPTION_E),   TRX_M_EXCEPTION_F = (1 << TRX_K_EXCEPTION_F) }
	Enumeration of excpetions. More...
Functions
void	TRX_enter (unsigned int exc, TRX_cb_Routine *rtn)
void	TRX_exit (unsigned int exc, TRX_cb_Routine *rtn)
void	TRX_select (unsigned int msk, unsigned int val)
	Selective set and clear of exceptions to trace.
void	TRX_setCallback (TRX_cb_Routine *rtn)
	Configure the insert-into-trace callback routine.
TRX_cb_Routine *	TRX_shouldCall (unsigned int exc)
	Determine if this exception should create trace entries.

---

Detailed Description

Definitions for the trace-exceptions facility.

CVS $Id: TRX_trace.h,v 1.2 2006/12/19 23:31:35 apw Exp $

Author:

A.P.Waite

---

Define Documentation

#define REG_MSR (   )

Value: ( \ { \ unsigned int msr; \ asm volatile (" bl 0f \n \ 0: mfmsr %0": "=r"(msr)); \ msr; \ } \ ) Fetches the value of the current MSR (machine status register). Returns: The value of MSR where this macro is called

---

Enumeration Type Documentation

enum _TRX_K_Exception

Enumeration of excpetions. Enumerator: TRX_K_EXCEPTION_0  Exception 0 TRX_K_EXCEPTION_1  Exception 1 TRX_K_EXCEPTION_2  Exception 2 TRX_K_EXCEPTION_3  Exception 3 TRX_K_EXCEPTION_4  Exception 4 TRX_K_EXCEPTION_5  Exception 5 TRX_K_EXCEPTION_6  Exception 6 TRX_K_EXCEPTION_7  Exception 7 TRX_K_EXCEPTION_8  Exception 8 TRX_K_EXCEPTION_9  Exception 9 TRX_K_EXCEPTION_A  Exception A TRX_K_EXCEPTION_B  Exception B TRX_K_EXCEPTION_C  Exception C TRX_K_EXCEPTION_D  Exception D TRX_K_EXCEPTION_E  Exception E TRX_K_EXCEPTION_F  Exception F

enum _TRX_M_Exception

Enumeration of excpetions. Enumerator: TRX_M_EXCEPTION_0  Mask for exception 0 TRX_M_EXCEPTION_1  Mask for exception 1 TRX_M_EXCEPTION_2  Mask for exception 2 TRX_M_EXCEPTION_3  Mask for exception 3 TRX_M_EXCEPTION_4  Mask for exception 4 TRX_M_EXCEPTION_5  Mask for exception 5 TRX_M_EXCEPTION_6  Mask for exception 6 TRX_M_EXCEPTION_7  Mask for exception 7 TRX_M_EXCEPTION_8  Mask for exception 8 TRX_M_EXCEPTION_9  Mask for exception 9 TRX_M_EXCEPTION_A  Mask for exception A TRX_M_EXCEPTION_B  Mask for exception B TRX_M_EXCEPTION_C  Mask for exception C TRX_M_EXCEPTION_D  Mask for exception D TRX_M_EXCEPTION_E  Mask for exception E TRX_M_EXCEPTION_F  Mask for exception F

---

Function Documentation

void TRX_select (  unsigned int  msk, unsigned int  val )

Selective set and clear of exceptions to trace. Parameters: msk  (in) Mask of exceptions to touch val  (in) Values to set masked bits to

void TRX_setCallback (  TRX_cb_Routine *  rtn  )

Configure the insert-into-trace callback routine. Parameters: rtn  (in) The trace insertion routine (usually TRC_record()) Exception tracing can be disabled by setting the callback routine to NULL.

TRX_cb_Routine * TRX_shouldCall (  unsigned int  exc  )

Determine if this exception should create trace entries. Parameters: exc  (in) Exception number to examine Return values: NULL  Exception should not generate trace records x  Exception should generate trace records (using this routine)

---