QLSW_dump.c File Reference

Dump facilities for a trace block. More...

#include <stdio.h>
#include <string.h>
#include <time.h>
#include <FBS/FBS_pubrtos.h>
#include <PBI/Endianness.h>
#include <MDB/MDB_pubdefs.h>
#include <TRC/TRC_pubdefs.h>
#include <QLSW/QLSW_pubdefs.h>
#include <QLSW/QLSW_msgs.h>
#include <TRC_prvdefs.h>
#include <fcntl.h>
#include <unistd.h>
#include <QLSW_prvdefs.h>
#include <QLSW_dump.c.ux-xxx-xxx>

Functions
static QLSW_cb_TraceDispatch *	discover (unsigned int ddx)
	Try to find a trace line dispatch routine.
void	QLSW_dumpCommon (const TRC_Buffer *trc)
	Dump the trace common area.
void	QLSW_dumpDefault (unsigned int ddx, 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 cnv, 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.
Variables
QLSW_DispatchTable	dispatch [QLSW_L_DISPATCH]
	Trace line dispatch table.
static const char	s_noData [TRC_DATA_ROW_SIZE<< 2] = { TRC_DAT_NODATA }
	Data recorded when the user specifies a NULL data pointer.
static const char	s_misaligned [TRC_DATA_ROW_SIZE<< 2] = { TRC_DAT_MISALIGN }
	Data recorded when the user specifies a misaligned data pointer.
static const char	s_ruleEqual [] = { "======================================" }
	Static string used in formatting dumps.
static const char	s_ruleMinus [] = { "--------------------------------------" }
	Static string used in formatting dumps.
static const char	s_null [] = { "" }
	An empty string.

---

Detailed Description

Dump facilities for a trace block.

CVS $Id: QLSW_dump.c,v 1.7 2011/03/30 23:33:40 russell Exp $

Author:

A.P.Waite

---

Function Documentation

static QLSW_cb_TraceDispatch * discover

(

unsigned int

ddx

)

[static]

Try to find a trace line dispatch routine.

Parameters:

ddx

(in) Dispatch index

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().