Readlog Utility Options (Windows Embedded CE 6.0)

1/5/2010

The following table shows detailed descriptions of the Readlog utility options.

Utility option	Description
-copy	Generates a new CeLog file with data from events flagged with the -range parameter only.This parameter is useful fir creating a smaller version of the log file that contains only the information of interest. A smaller version of the log file can be shared more easily than a very large log file. For more information, see Creating a New Binary Log File with Events in a Range.
-fixthreads	Generates a new CeLog file with fixed thread names.This parameter is useful for viewing thread names in Kernel Tracker. For more information, see Fixing Thread Names With Readlog.
-fixtime	Generates a new CeLog file where the timestamp does not roll over.This parameter is useful for repairing timestamp problems in the log so that Kernel Tracker displays the data correctly.
-plugin	Generates a new CeLog file with plugin string replacements.This parameter is useful for viewing custom events in Kernel Tracker. For more information, see Writing A Readlog Extension To View Custom Events.
-sync	Generates a new CeLog file with a sync header at the top. This parameter is most useful for repairing a log files that does not have a list of processes, threads and modules at the top. For example, the beginning of a log file might have been deleted, or a thread might have been turned off and then back on.

Examples

The following code example shows a Readlog conversion of Celog.clg data into text without any filters enabled.
```
readlog celog.clg output.txt
```
The following code example shows a Readlog conversion of Celog.clg data into text with the -sync option enabled. Note that this example requires two command-line sequences: the first sequence uses a utility option to output a .clg log file, the second sequence uses a print option to output a .txt file.
```
readlog -sync celog.clg new.clg
readlog new.clg output.txt
```
The following code example shows a Readlog conversion of Celog.clg data into text with several filters enabled. These filter settings remove KCALL, memory tracking, critical section, and synchronization events from the converted data, and then write it to Output.txt.
```
readlog -f KMCS celog.clg output.txt
```