Hotspots by Function

To display the percentage of samples collected for each active function or method in the module, use the -hotspot-function (or -hf) option and specify module name(s) with the -mn option.

Example:

>vtl view -hf -mn vtundemo.exe

Grouping hotspots by function provides the names of the functions sorted by maximum samples and percentage of samples collected for each function.

Percentage of samples means the percentage calculated using the number of samples collected for a specific function and the total number of samples collected for your entire selection.

This is the table structure for the hotspots by functions view:

Column Heading

Description

on Linux*

on Microsoft* Windows*

Function

Name of the function.

Module

Module in which the function resides.

Size

Size of the function in bytes.

Event

-

Name of the monitored event.

Events%

-

Percentage of total events collected in run.

Samples

<Event name> samples

Number of samples collected for the event in this function.

Events

-

The event count is based on the number of samples collected X Sample After value.

Address

 

Relative Virtual Address of the function.

Segment

Segment used by the function.

Offset

Offset of segment.

Full Name

Name of the function as it appears in your code.

-

<Event ratio name>

The dynamically calculated sample count for the event ratios. These values depend on the event counts for the selected events.

-

Resolved Module Path

The path of your module.

CPU

-

Logical CPU where the samples were collected.

-

Class

Class to which the function belongs.

-

Source File

Source file of the function.

Note

The command line VTuneTM Performance Analyzer can display function names only if the symbol information is available in the executable. It does not support other symbol files, such as .map and .pdb. If you cannot provide this information, only the group by address option is available.

On the Linux operating system, you may use the -symbol-dir (or -sd) option to specify the directory/directories where to have the VTune analyzer search for the symbol file. For more details, see the Specifying the Symbol Directory topic.