---

GLAST/LAT > DAQ and FSW > FSW > Doxygen Index > TRC / V0-0-0

Constituent: trc     Tag: sun-gcc

---

         

---

TRC_control.c File Reference

Control functions for the TRC package. More...

#include <string.h>
#include "PBS/CACHE.h"
#include "PBS/MBA.h"
#include "PBS/PTS.h"
#include "PBS/RW.ih"
#include "PBS/MTX.h"
#include "MDB/MDB_pubdefs.h"
#include "TRC/TRC_msgs.h"
#include "TRC/TRC_pubdefs.h"
#include "TRC_prvrtos.h"

Include dependency graph for TRC_control.c:

Defines
#define	TRC_L_SEED   (2)
	Length of the task name seed table.
Functions
unsigned int	TRC_advertise ()
	Use a MSG to advertise the location of the trace blob.
unsigned int	TRC_exceptions (unsigned int msk, unsigned int val)
	Initialize the TRC tracing facility.
unsigned int	TRC_initialize (unsigned int rows)
	Initialize the TRC tracing facility.
unsigned int	TRC_shutdown ()
	Shut down the TRC tracing facility.
Variables
TRC_Control *	TRC_tcb
	Control block for TRC trace facility.
static char *	s_seed [TRC_L_SEED] = { "UND>", "ISR>" }
	Array of task seed names.

---

Detailed Description

Control functions for the TRC package.

CVS $Id: TRC_control.c,v 1.1.1.1 2006/12/20 00:44:59 apw Exp $

Author:

A.P.Waite

TRC_control.c provides facilities to initialize the TRC task trace system. These are the very basic task trace facilities and require very little in the way of resources (other than large quantities of memory). The goal is to have this package exist at such a low level in the package hierarchy that nearly all other packages can call the TRC_record() function.

Warning:

Suitable task switch tracing facilities are not available on host systems, so while this facility can be compiled and linked on host systems, it cannot perform a run time trace of task switches. It can still, however, record events generated by TRC_record() calls.

---

Function Documentation

unsigned int TRC_exceptions (  unsigned int  msk, unsigned int  val )

Initialize the TRC tracing facility. Parameters: msk  (in) Mask of exceptions to touch val  (in) Values to set masked bits to TRC_exceptions() initiates exception tracing.

unsigned int TRC_initialize (  unsigned int  rows  )

Initialize the TRC tracing facility. Parameters: rows  (in) Number of rows in trace buffer (default 1024) TRC_initialize() builds up the resources to run the trace facilities.

unsigned int TRC_shutdown (  void   )

Shut down the TRC tracing facility. TRC_shutdown() shuts down the trace facilities.

---