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.
#define	PaUtil_AddTraceMessage(msg, data)   /* noop */
#define	PaUtil_DumpTraceMessages()   /* noop */
	Print all messages in the trace buffer to stdout and clear the trace buffer.

---

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_AddTraceMessage	(		msg,
			data
	)		/* noop */

PaUtil_DumpTraceMessages

(

)

/* noop */

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

Referenced by Pa_Terminate().

PaUtil_ResetTraceMessages

(

)

/* noop */

Clear the trace buffer.

Referenced by Pa_Initialize().