CeLogFlush Registry Settings (Windows CE 5.0)

Send Feedback

You can modify the behavior of the CeLogFlush application that flushes the CeLog log by changing specific registry values.

The CeLog registry settings are located under the HKEY_LOCAL_MACHINE\System\CeLog key.

The following list shows ways in which you can change the registry settings:

  • Typically, to create a run-time image with predefined settings, add registry settings to the projects file before building the run-time image.
  • You can also use the Remote Registry Editor in Platform Builder to add the settings to a device. However, changes made from the Remote Registry Editor are not persistent to the registry files. Therefore, the next time that you download the image, you must configure the registry again. For more information, see Remote Registry Editor.

The following table shows the named values you can set for the CeLog key.

Value: type Default Description
BufferSize: REG_DWORD 0x00020000 = 131072, or 128KB Specifies the size, in bytes, of the CeLog RAM buffer that stores event activity before flushing.
FileFlags: REG_DWORD 0 Specifies flags for file management. Choose one of the following:
  • 0

    Auto-close the log file if no data has been lost recently

  • 1

    Never close the log file (best performance but keeps file handle open)

  • 2

    Always close the log file

FileName: REG_SZ \Release\celog.clg Name of log file to store the data in.
FlushTimeout: REG_DWORD 0x00002710 = 10000, or 10 seconds Sets the timeout, in milliseconds, between successive flushes.
ThreadPriority: REG_DWORD 0x000000F8 = 248, the lowest real-time priority Sets the priority of the flushing thread (0-255).
Transport: REG_SZ LocalFile Transport to use. This value must be one of the following:
  • LocalFile

    Stores data in log file on the local file system

  • CESH

    Stores data in log file on the remote host at \Release\LocalFile

UseUI: REG_DWORD 0 Boolean value that indicates type of messages.

1=use popup messages

0=debug messages only

ZoneCE: REG_DWORD Previous zone setting Specifies the CeLog zone settings.

If this value is present, CeLogFlush will call CeLogSetZones to pass the zones to CeLog.

Examples

The following examples show how to set common registry values that control CeLogFlush behavior.

  • Default

    These settings store the data in a log file called celog.clg in the release directory on the host PC.

    [HKEY_LOCAL_MACHINE\System\CeLog]
        "Transport"="LocalFile"
        "FileName"="\\release\\celog.clg"
    

    The default file name, \release\celog.clg, requires the release file system, relfsd, to transport the data. Because of this, the default settings for CeLogFlush require a KITL connection to Platform Builder on the development workstation.

  • Log file stored at root directory.

    This example stores the log file in the root of the file system on the device. It does not require a connection to the development workstation.

    [HKEY_LOCAL_MACHINE\System\CeLog]
        "Transport"="LocalFile"
        "FileName"="celog.clg"
    
  • Log file on a storage card.

    This method requires a storage card on a device.

    [HKEY_LOCAL_MACHINE\System\CeLog]
        "Transport"="LocalFile"
        "FileName"="\\Storage Card\\celog.clg"
    
  • Flush every second

    [HKEY_LOCAL_MACHINE\System\CeLog]
        "FlushTimeout"=dword:3E8
    
  • Low priority of flush thread

    This method lowers the thread priority for log flush from the default of 248 to 251, which corresponds to THREAD_PRIORITY_NORMAL**.**

    [HKEY_LOCAL_MACHINE\System\CeLog]
        "ThreadPriority"=dword:FB
    

See Also

Real-time Priority System Levels | CeLogFlush Command-Line Overrides

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.