Logging Library (Windows Embedded CE 6.0)
1/5/2010
The logging library provides a single function and zone definitions to trace OAL components in a consistent way. This library provides an interface for consistent tracing of OAL components. For more information, see %_WINCEROOT%\Platform\Common\Src\Inc\Oal_log.h.
You should instrument all function entries and exits with the OAL_FUNC zone using the OALMSG macro, which calls down to the printing routines.
Function entry tracing:
+FuncName( Arg1, Arg2, ... )Function exit tracing:
-FuncName(rc=x)In the function for exit tracing,
rcindicates the return code, if present.
By turning on the OAL_FUNC zone trace mask, you should be able to follow the OAL program flow. Use the following guidelines when tracking OAL components:
- Instrument any error conditions with the OAL_ERROR zones.
The error string should begin with "ERROR: ". - Instrument any warning conditions with the OAL_WARN zones.
The warning string should begin with "WARNING:". - Instrument any informational tracing with the OAL_INFO zone.
The informational string should begin with "INFO:".
The logging library relies on a global OAL trace mask and uses the underlying output methods provided by the kernel. Trace initially uses serial output, and then switches to KITL if it is enabled.