Compartir a través de


Using Target Control Commands with CeLog (Windows CE 5.0)

Send Feedback

You can change the zone settings during run-time using the log command in the target control window of the Windows CE shell. After the log command sets the zones, it prints them for you. Use the command without any options or zone settings to find out the current CeLog zone settings. For more information, see Target Control Debugging Commands.

The following code shows the syntax for the log command:

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.

    Can only affect the buffer size if CeLog is not already loaded.

    -clear Discard the current contents of the CeLog buffer.
    -flush [ Filename.clg ] Flushes the CeLog buffer.

    If a filename is specified, the data is flushed to that file. Otherwise, the data is flushed to \Release\celog.clg.

    -stopflush Signals CeLogFlush.exe or OSCapture.exe to exit.
  • HexWindowsCEZone
    Specifies a Windows CE OS zone to log. Default is 0xFFFFFFFF.

    To specify several zones, use the bitwise OR of their hexadecimal values.

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

  • HexProcessMask
    Specifies processes to be logged. Default is 0xFFFFFFFF.

Examples

  • log

    Prints the current zone settings.

  • log 0x63 0xFFFFFFFF 0xFFFFFFFF

    -or-

    log 0x63
    

    Gets data from the combined zone 0x63, which is the bitwise OR value of CELZONE_PROCESS + CELZONE_THREAD + CELZONE_RESCHEDULE + CELZONE_INTERRUPT.

    For specific zone values, see CeLog Zones.

  • log 0

    Turns off all CeLog zones.

  • log -buf 0x00100000

    -or-

    log -buf 1048576
    

    Sets CeLog buffer size to 1MB without setting zones.

  • log -buf 1048576 0x63

    Sets buffer size to 1MB and set zones.

  • log -flush \\release\\myfile.clg

    Flushes CeLog buffer contents to myfile.clg.

  • log –stopflush

    Causes CeLogFlush.exe or OSCapture.exe to exit.

See Also

Target Control Debugging Commands | CeLog Zones | CeLogFlush.exe | OSCapture.exe

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.