Share via


Capturing CeLog Data During Boot (Windows Embedded CE 6.0)

1/5/2010

There are two options for capturing data during boot.

  • Configure the run-time image to launch CeLog event tracking during boot.
  • Configure the registry to launch CeLogFlush.exe early during boot

Configuring the run-time image to launch CeLog event tracking during boot allows you to start capturing data very early in boot, before most of the kernel and file system initialization has occurred. However, this option requires modification of the run-time image, which is not always possible.

To capture CeLog data during boot by configuring the run-time image

  1. Enable CeLog event tracking in your run-time image.

    For more information, see Enabling CeLog Event Tracking in a Run-Time Image.

  2. Change the CeLog collection zones to collect only the events you want to see.

  3. Registry settings in the development workstation settings affect collection from the moment CeLog data collection begins, while the target device settings affect collection only after CeLogFlush.exe starts running, which does not occur until after kernel and file system initialization is complete.

    If necessary, change the size of the RAM buffer that CeLog uses by setting the dwCeLogLargeBuf OAL variable. You cannot use CeLogFlush registry settings to control the buffer size in this case, because the buffer size is set before CeLogFlush.exe starts running.

Capturing Data by Configuring the Registry

You can also change the size of the RAM buffer by configuring the registry of the target device to launch CeLogFlush.exe early during boot. This option does not record system activity during kernel and file system initialization, but does record all activity after that point.

To capture CeLog data during boot by configuring the registry to launch CeLogFlush.exe early during boot

  1. Copy CeLog.dll and CeLogFlush.exe into the \Windows directory of the target device.

  2. Configure the registry to launch CeLogFlush.exe early during boot by adding the following value to the registry of the target device:

    [HKEY_LOCAL_MACHINE\init]
            "Launch05"="CeLogFlush.exe"
    

    For more information, see Configuring the Process Boot Phase.

  3. If the device is not connected to a development workstation, set the name of the log file that CeLogFlush.exe will flush to by setting the FileName value in the device registry. For more information, see CeLogFlush Registry Settings.

  4. To change CeLogFlush settings, such as the CeLog collection zones or the size of the RAM buffer that CeLog uses, use the CeLogFlush registry settings.

    CeLog logs events that pertain to device boot if you enable the zone CELZONE_BOOT_TIME. For information on how to view these events after you have collected them, see Viewing Boot Events With Readlog

See Also

Other Resources

CeLogFlush.exe
CeLog Zones