Target Control Debugging: log Command (Compact 2013)

3/26/2014

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.
  LogOptions -stopflush	Flushes the CeLog buffer. If a file name is specified, the data is flushed to that file. Otherwise, the data is flushed to \Release\celog.clg.

• HexWindowsCEZone
  Specifies a Windows Embedded Compact OS zone to log. Default is 0xFFBFFFFF. For information about predefined zones, see CeLog Zones.

• HexUserZone
  Specifies a user-defined zone in hexadecimal notation. Default is 0xFFBFFFFF.

• HexProcessMask
  Specifies processes to log. Default is 0xFFFFFFFF.

Remarks

You can use the log command to control CeLog flushing from the command line.

The following examples show how to use the log command.

• To set the CeLog buffer size to 1MB without changing zones:

  log -buf 0x00100000
  

• To clear the contents of the CeLog buffer before running a test:

  log -clear
  

• To flush the contents of the CeLog buffer to a log file in the release directory after you complete a test:

  log -flush \release\myfile.clg
  

See Also

Reference

Target Control Debugging