Target Control Debugging: prof Command
Other versions of this page are also available for the following:
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
This command controls the kernel profiler. This command has an effect only on a Windows Embedded CE OS that supports profiling. For more information, see Kernel Profiler.
Syntax
prof on | off [DataType ][ StorageType][OtherOptions]
Parameters
- On
Starts the kernel profiler.
- Off
Stops the kernel profiler.
DataType
Specifies the type of data gathered.Only one DataType may be specified in a single command.
The following table shows possible values for the DataType parameter.
Value Description -m
Instructs the kernel profiler to gather data using the Monte Carlo profiling technique. Data is collected periodically based on time. The -m value is the default value for the DataType parameter.
For more information about Monte Carlo profiling, see Monte Carlo Profiling.
-s
Instructs the kernel profiler to gather system call data when system calls are made.
For more information, see System Call Profiling.
-k
Instructs the kernel profiler to gather kernel call data when kernel calls are made.
StorageType
Specifies how to store collected data.Only one StorageType may be specified in a single command.
The following table shows possible values for the StorageType ** parameter.
Value Description -b
Stores data in buffered mode. The -b value is the default value for the StorageType parameter.
-u
Stores data in unbuffered mode.
-l
Sends data to the CeLog Event-Tracking subsystem (Celog.dll). To store the data, the event-tracking subsystem must be running.
For more information, see CeLog Event Tracking.
OtherOptions
Specifies how to log collected data, enabling you to manually manage the data that CeLog produces. The following table shows possible values for the OtherOptions parameter.Value Description -buf Size
Determines the size of the data buffer for CeLog when CeLog is not running. Specify the size in either hexadecimal or decimal format.
-clear
Clears the CeLog buffer, then starts the kernel profiler.
Use only when the prof parameter is set to on.
-flush Filename.clg
Stops the kernel profiler, then flushes the CeLog buffer to the log file specified with Filename.clg. The default location is Celog.clg, in the release directory.
Use only when the prof parameter is set to off.
-i
Controls the profiler sampling interval.
For information about parsing a log file created using the prof command, see Readlog Viewing Tool.
There are two ways to enter the prof command:
- If you use a command prompt window, enter commands at the Windows Embedded CE prompt.
- If you use the Platform Builder IDE, from the Target menu choose CE Target Control to display the Target Control window. Enter commands in the Target Control window.