Target Control Debugging: prof Command (Windows CE 5.0)

  • Article

Send Feedback

This command controls the kernel profiler. This command has an effect only on a Windows CE OS that supports profiling. For more information, see Kernel Profiler.

profon | off [DataType ][ StorageType][OtherOptions]

Options

  • 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 event-tracking subsystem (Celog.lib). 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 LogOptions 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.

Remarks

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

Debugging Resources Overview | Target Control Window

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.