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

loop-mode

Show or hide loops in the stack.

IDE Equivalent

Toolbar: Filter > Loop Mode drop-down menu

Syntax

loop-mode=<value>

Arguments

loop-only

Display loops as regular nodes in the tree. Loop name consists of:

  • start address of the loop

  • number of the code line where this loop is created

  • name of the function where this loop is created

loop-and-function

Display both loops and functions as separate nodes.

function-only

Display data by function with no loop information (default mode).

Default

function-only

vtune reports show no loop data.

Actions Modified

report

Description

Use the loop-mode option when performing data collection, finalization or importation, to set loop view for the result or report. You can also use this option with the report action to override the project-level setting for viewing a hierarchy of the loops in your application call tree.

Example

This command displays the data collected during the Hotspots analysis in the callstack report that is filtered to show loops only:

vtune -R callstacks -loop-mode=loop-only
Function                                Function Stack                          Module        CPU Time:Self
--------------------------------------  --------------------------------------       ------------  	   ------------
[Outside any loop]                                                              [Unknown]               0.009
                                                                                              
[Loop@0x7dea03b7 in func@0x7dea0392]                                            ntdll.dll               0.002
                                        [Loop@0x7dea03a6 in func@0x7dea0392]    ntdll.dll               0.002
                                        [Outside any loop]                      [Unknown]               0
                                                                                              
[Loop@0x1400147f0 in func@0x140014782]                                          mfeapfk.sys             0.001
                                        [Outside any loop]                      [Unknown]               0.001
                                                                                              
[Loop@0x14001a111 in func@0x14001a0c0]                                          mfeapfk.sys             0.001
                                        [Loop@0x14001a100 in func@0x14001a0c0]  mfeapfk.sys             0.001
                                        [Outside any loop]                      [Unknown]               0
                                                                                              
[Loop@0x1402d0329 in func@0x1402d02af]                                          ntoskrnl.exe            0.001
                                        [Outside any loop]                      [Unknown]               0.001