Share via


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