Partager via

Target Control Debugging: prof Command (Windows Embedded CE 6.0)

  • Article

1/5/2010

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 StorageTypeparameter.

    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.

See Also

Concepts

Target Control Debugging Commands
Debugging Resources Overview

Other Resources

Command-Line Options with Target Control