User Guide

Intel® VTune™ Profiler User Guide

ID 766319
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of 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.

TIP:

By default, source view is displayed. Specify group-by address to see disassembly view with associated performance data.

Examples

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