Target Control Debugging: log Command
Other versions of this page are also available for the following:
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
This command allows you to use several features of the CeLog Event Tracking subsystem, Celog.dll and its related tools. You can use this command to display or modify zones for the event-tracking subsystem, flush the existing CeLog buffer, and set the size of the buffer used to hold events captured by the event tracking engine. This command works only if the event-tracking subsystem is running
Syntax
log [ LogOptions ][ HexWindowsCEZone [ HexUserZone [ HexProcessMask ]]]
Parameters
LogOptions
Specifies how to log collected data, enabling you to manually manage the data that CeLog produces. You can specify the following options:Option Description -buf Size
Determines the size of the data buffer for CeLog.
-clear
Clears the CeLog buffer.
-flush Filename.clg
Flushes the CeLog buffer to the log file specified with Filename.clg.
- HexWindowsCEZone
Specifies a Windows Embedded CE OS zone to log. Default is 0xFFBFFFFF. For more information about setting CeLog zones, see Filtering CeLog Events. For information about predefined zones, see CeLog Zones.
- HexUserZone
Specifies a user-defined zone in hexadecimal notation. Default is 0xFFBFFFFF. For more information about defining your own zones, see Logging Your Own CeLog Events.
- HexProcessMask
Specifies processes to be logged. Default is 0xFFFFFFFF.
Remarks
You can use the log command to control CeLog flushing from the command line. For more information, see Manual Log File Flushing.
The following examples show how to use the log command.
Set the CeLog buffer size to 1MB without changing zones.
log -buf 0x00100000Clear the contents of the CeLog buffer before running a test.
log -clearFlush the contents of the CeLog buffer to a log file in the release directory after you have completed a test.
log -flush \release\myfile.clg
See Also
Tasks
Concepts
Other Resources
Filtering CeLog Events
Command-Line Options with Target Control