QLSW_pubdefs.h File Reference

Public definitions for the QLSW trace dump facilities. More...

#include <TRC/TRC_pubdefs.h>

Defines
#define	QLSW_L_DATE   (29)
#define	QLSW_L_DISPATCH   (256)
#define	QLSW_L_ELAPSED   (23)
Typedefs
typedef unsigned int	QLSW_cb_TraceDispatch (unsigned int mod, const TRC_Buffer *trc, unsigned int tic, unsigned int msg, unsigned int tdb, unsigned int usr, const unsigned int *dat)
	Signature for routine to record a trace entry.
Functions
void	QLSW_dumpCommon (const TRC_Buffer *trc)
	Dump the trace common area.
void	QLSW_dumpDefault (unsigned int dsp, unsigned int msg, unsigned int tdb, unsigned int usr, const unsigned int *dat)
	Routine to a record "raw".
void	QLSW_dumpTrace (const TRC_Buffer *trc, unsigned int qtic, unsigned int qtim)
	Dump the trace body (the real thing).
void	QLSW_dumpTraceHeader (const TRC_Buffer *trc)
	Dump the trace header block.
const char *	QLSW_getTaskName (const TRC_Buffer *trc, unsigned int tdb)
	Translate task ID to name.
WCT_time	QLSW_tics2wct (WCT_time wct, long long tic, long long off, double freq)
	Convert a LAT WCT_time to a date string.
void	QLSW_wct2date (WCT_time wct, char *date)
	Convert a LAT WCT_time to a date string.
void	QLSW_wct2elapsed (WCT_time wct, char *elapsed)
	Convert a LAT WCT_time to an elapsed time.

---

Detailed Description

Public definitions for the QLSW trace dump facilities.

CVS $Id: QLSW_pubdefs.h,v 1.6 2011/03/30 23:33:39 russell Exp $

Author:

A.P.Waite

---

Function Documentation

void QLSW_dumpCommon

(

const TRC_Buffer *

trc

)

Dump the trace common area.

Parameters:

trc

Pointer to the trace header buffer

void QLSW_dumpTrace	(	const TRC_Buffer *	trc,
		unsigned int	qtic,
		unsigned int	qtim
	)

Dump the trace body (the real thing).

Parameters:

	trc	Pointer to the trace header buffer
	qtic	Print the delta tic column
	qtim	Print the absolute timestamp column

References discover(), QLSW_dumpDefault(), QLSW_tics2wct(), and QLSW_wct2date().

void QLSW_dumpTraceHeader

(

const TRC_Buffer *

trc

)

Dump the trace header block.

Parameters:

trc

Pointer to the trace header buffer

References QLSW_tics2wct(), QLSW_wct2date(), and QLSW_wct2elapsed().

const char* QLSW_getTaskName	(	const TRC_Buffer *	trc,
		unsigned int	tdb
	)

Translate task ID to name.

Parameters:

	trc	(in) Trace buffer
	tdb	(in) Task index (in CPU_DB/ITC space)

Return a task name corresponding to the given task index (in CPU_DB/ITC space). Always return a valid pointer (even it's just pointing to a zero length string).

Referenced by QLSW_dispatch_00().

WCT_time QLSW_tics2wct	(	WCT_time	wct,
		long long	tic,
		long long	cnv,
		double	freq
	)

Convert a LAT WCT_time to a date string.

Parameters:

	wct	(in) Correlation time (WCT time)
	tic	(in) Correlation time (timebase register tics)
	cnv	(in) Value to convert (timebase register tics)
	freq	(in) Tic interval in nanoseconds

Referenced by QLSW_dispatch_00_summary(), QLSW_dumpTrace(), and QLSW_dumpTraceHeader().

void QLSW_wct2date	(	WCT_time	wct,
		char *	date
	)

Convert a LAT WCT_time to a date string.

Parameters:

	wct	(in) A WCT time
	date	(out) A date string like '2007-10-23 14:46:21.123456789'

Referenced by QLSW_dispatch_00_summary(), QLSW_dumpTrace(), and QLSW_dumpTraceHeader().

void QLSW_wct2elapsed	(	WCT_time	wct,
		char *	elapsed
	)

Convert a LAT WCT_time to an elapsed time.

Parameters:

	wct	(in) A WCT time
	elapsed	(out) A elapsed time string like ' 2 14:46:21.123456789'

Referenced by QLSW_dumpTraceHeader().