Intel® Advisor User Guide

ID 766448
Date 7/13/2023
Public

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

Document Table of Contents

mark-up-list

After running a Survey analysis and identifying loops of interest, select loops (by file and line number or ID) for deeper analysis.

GUI Equivalent

Survey >

Syntax

--mark-up-list=<string>

Arguments

<string> is a comma-separated list (no spaces) of loop IDs, file/line numbers in the format file1:line1, or both.

Default

The existing selection in Survey > , which is persistent.

If there is no GUI selection:

  • For Trip Counts & FLOP and Roofline analyses: all loops

  • loops default

    • For Memory Access Patterns analysis: "loop-height=0,total-time>0.1"

    • For Dependencies analysis: "scalar,loop-height=0,total-time>0.1"

Actions Modified

collect=tripcounts

collect=map

collect=dependencies

collect=roofline

Usage

Do not confuse the mark-up-loops action with the mark-up-list action option. The mark-up-loops action coupled with the select action option enables a GUI checkbox; therefore loop selection persists beyond the duration of the mark-up-loops action and applies to downstream analyses, such as Dependencies and Memory Access Patterns analyses. The collect action coupled with the mark-up-list action option simulates enabling a GUI checkbox; therefore loop selection persists only for the duration of the collect action.

Example

  1. Run a Survey analysis.

  2. Run a Trip Counts & FLOP analysis on Survey analysis loops 1 and 3; and source location my_source.cpp:132.

advisor --collect=survey --project-dir=./advi_results -- ./myApplication
advisor --collect=tripcounts --mark-up-list=1,my_source.cpp:132,3 --search-dir src:=./src --project-dir=./advi_results -- ./myApplication

See Also