User Guide

  • 2020
  • 06/18/2020
  • Public Content
Contents

group-by

Specify grouping in a report.

Syntax

-group-by
<granularity1>
,
<granularity2>
Arguments
Argument
Description
<granularity>
Grouping level that depends on the report type.
Default
Varies by report;
function
is the most common default.
Actions Modified
Description
Use the
group-by
action-option to group data in your report by your specified criteria. For multiple grouping levels, add arguments separated by commas (no spaces).
For some reports (for example,
top-down
report) you can specify only a single grouping level.
To display a list of available groupings for a particular report, type:
vtune
-report <
report_name
> -r <
result_dir
> group-by=?
. If you do not specify a result directory, the latest result is used by default.
The
function
value groups the result data both by function and by module. To group just by the function, use
function-only
.
Output a hotspots report for the latest result with data grouped by module:
vtune
-report hotspots -group-by module
Output a hotspots report for the latest result with data grouped by thread and function:
vtune
-report hotspots -group-by thread,function
Display all available hotspots report groupings for a Hotspots analysis result on Linux*:
vtune
-R hotspots -r /temp/test/r029hs/r029hs group-by=?
vtune
: Using result path '/temp/test/r029hs/r029hs' Available values for '-group-by' option are: basic-block : Basic Block function : Function function-mangled : Function module : Module module-path : Module Path process : Process thread-id : TID process-id : PID source-file : Source File source-line : Source Line source-file-path : Source File Path thread : Thread callstack : Call Stack cpuid : Logical Core address : Code Location function-start-address : Start Address source-function : Source Function package : Package source-function-stack : Source Function Stack core : Physical Core class : Class cacheline : Cacheline data-address : Data Address tasks-and-interrupts : Task and Interrupt context : Context vcore : VCore The following items can be specified only as the final grouping level: callstack, source-function-stack.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804