pa_trace.h File Reference

Real-time safe event trace logging facility for debugging. More...

Go to the source code of this file.

Macros
#define	PA_TRACE_REALTIME_EVENTS   (0)
#define	PA_MAX_TRACE_RECORDS   (2048)
#define	PaUtil_ResetTraceMessages()   /* noop */
	Clear the trace buffer. More...
#define	PaUtil_AddTraceMessage(msg, data)   /* noop */
#define	PaUtil_DumpTraceMessages()   /* noop */
	Print all messages in the trace buffer to stdout and clear the trace buffer. More...
#define	PaUtil_InitializeHighSpeedLog(phLog, maxSizeInBytes)   (0)
#define	PaUtil_ResetHighSpeedLogTimeRef(hLog)
#define	PaUtil_AddHighSpeedLogMessage(...)   (0)
#define	PaUtil_DumpHighSpeedLog(hLog, fileName)
#define	PaUtil_DiscardHighSpeedLog(hLog)

Detailed Description

Real-time safe event trace logging facility for debugging.

Allows data to be logged to a fixed size trace buffer in a real-time execution context (such as at interrupt time). Each log entry consists of a message comprising a string pointer and an int. The trace buffer may be dumped to stdout later.

This facility is only active if PA_TRACE_REALTIME_EVENTS is set to 1, otherwise the trace functions expand to no-ops.

Macro Definition Documentation

#define PA_MAX_TRACE_RECORDS   (2048)

Maximum number of records stored in trace buffer

#define PA_TRACE_REALTIME_EVENTS   (0)

Set to 1 to enable logging using the trace functions defined below

#define PaUtil_AddHighSpeedLogMessage

(

...

)

(0)

#define PaUtil_AddTraceMessage	(		msg,
			data
	)		/* noop */

#define PaUtil_DiscardHighSpeedLog

(

hLog

)

Referenced by ProcessingThread().

#define PaUtil_DumpHighSpeedLog	(		hLog,
			fileName
	)

Referenced by ProcessingThread().

PaUtil_DumpTraceMessages

(

)

/* noop */

Print all messages in the trace buffer to stdout and clear the trace buffer.

Referenced by Pa_Terminate().

#define PaUtil_InitializeHighSpeedLog	(		phLog,
			maxSizeInBytes
	)		(0)

Referenced by ProcessingThread().

#define PaUtil_ResetHighSpeedLogTimeRef

(

hLog

)

PaUtil_ResetTraceMessages

(

)

/* noop */

Clear the trace buffer.

Referenced by Pa_Initialize().