Target Control Debugging: prof Command (Compact 2013)

  • Article

3/26/2014

This command controls the kernel profiler. This command has an effect only on a Windows Embedded Compact 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 can 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.

    -s

    Instructs the kernel profiler to gather system call data when system calls are made.

    -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 can 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, and then starts the kernel profiler.

    Use only when the prof parameter is set to on.

    -flush Filename.clg

    Stops the kernel profiler, and 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.

    -t

    Causes the profiler to record a sample on every tick interrupt (SYSINTR_NOP or SYSINTR_RESCHEDULE) when collecting Monte Carlo data.

    If the OAL does not support profiling, the kernel automatically selects this option.

    If the OAL supports profiling, you can use this flag to force Monte Carlo profiling to ignore the OAL profiling implementation and use the tick interrupt to record profiler samples.

For information about parsing a log file created using the prof command, see Readlog Viewing Tool.

You can enter the prof command in two ways:

  • If the OS on your device supports the console window, you can bring up the Target Control window on your device by running shell -c. You can then enter the prof command at the shell command prompt on your device.
  • If you use Platform Builder, you can enter the prof command from the Visual Studio Target Control window.

See Also

Reference

Target Control Debugging