User Guide

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

source-object

Type of source object to display in a report for source or assembly data.

Syntax

-source-object
<object_type>
[=]
<value>
Arguments
Argument
Description
<object_type>
Application unit for which source or assembly data should be displayed. Possible values are:
module
,
source-file
,
function
.
Actions Modified
report
with either
hw-events
or
hotspots
report type.
Description
Use the
source-object
option to switch report to source or assembly view mode, including associated performance data. To define a particular object, you can specify this option more than once. For example, if two modules each have a function named
foo
,
VTune
Profiler
will throw an error unless you specify both the module and function.
By default, source view is displayed. Specify group-by
address
to see disassembly view with associated performance data.
Generate a hardware events report that displays source data for the
foo
function. Since the result directory is not specified, the most recent hardware analysis result in the current working directory is used.
vtune
-report hw-events -source-object function=foo
This example specifies the object as the function
foo
in
module1
. This would avoid a conflict if there was a second function named
foo
in some other module.
vtune
-report hw-events -source-object module=module1 -source-object function=foo
Generate a hardware events report that displays assembly data for the
foo
function.
vtune
-R hw-events -source-object function=foo -group-by address
Generate a hardware events report that displays assembly data grouped by basic block and then address.
vtune
-R hw-events -source-object function=foo -group-by basic-block,address
Generate a hardware events report that displays assembly data grouped by function-range, then basic block, and then by address.
vtune
-R hw-events -source-object function=foo -group-by function-range,basic-block,address

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