Visible to Intel only — GUID: GUID-8FAC2B61-FBDD-4497-92B7-A5AF1BB25769
Visible to Intel only — GUID: GUID-8FAC2B61-FBDD-4497-92B7-A5AF1BB25769
source-object
Type of source object to display in a report for source or assembly data.
GUI Equivalent
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.
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