Trace messages


Functions

void os_trace_err (const char *format,...)
void os_trace_warn (const char *format,...)
void os_trace_info (const char *format,...)
void os_trace_dbg (const char *format,...)

Detailed Description

Trace messages are printf-style messages used for run-time diagnostics. There are four levels of severity for the messages: error, warning, informational, and debug.

How these messages are read is platform specific. Each module that uses tracing may also have to provide additional platform specific information.

Linux

Trace messages are sent to the standard kernel message log (dmesg). If a module defines OS_TRACE_PREFIX then this string is prefixed to all trace messages.

For example,

 #define OS_TRACE_PREFIX "module: "
 #include <oska/trace.h>

Windows KMDF

WPP software tracing is used. Each driver must:

X.org server log

Trace messages from X.org drivers can be sent to the X.org server log. The driver must #define OS_TRACE_USE_XORG before including <oska/trace.h>


Function Documentation

void os_trace_dbg ( const char *  format,
  ... 
)

A debug trace message.

Callable from: any context.

Parameters:
format printf-style format string.
... arguments for format.
See also:
os_trace_err

void os_trace_err ( const char *  format,
  ... 
)

An error trace message.

The printf-style format string must be a constant string literal. The c, d, p, s, and x conversion specifiers and the field length and pad character should be supported (e.g., %08x).

Callable from: any context.

Parameters:
format printf-style format string.
... arguments for format.

void os_trace_info ( const char *  format,
  ... 
)

A informational trace message.

Callable from: any context.

Parameters:
format printf-style format string.
... arguments for format.
See also:
os_trace_err

void os_trace_warn ( const char *  format,
  ... 
)

A warning trace message.

Callable from: any context.

Parameters:
format printf-style format string.
... arguments for format.
See also:
os_trace_err


Generated on Wed Oct 27 15:14:03 2010 for oska by  doxygen 1.5.5