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: amplxe-cl 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 Advanced Hotspots analysis in the callstack report that is filtered to show loops only:

$ amplxe-cl -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