append

Add loops (by file and line number) to the loops selected for deeper analysis.

GUI Equivalent

Survey >

Syntax

--append=<string>

Arguments

<string> is a comma-separated list of files/line numbers in the following format: file1:line1.

Default

No default argument

Actions Modified

mark-up-loops

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

Run a Survey analysis.
Select a loop for deeper analysis.
Add bar.cpp:192 to the selection list.
Run a Dependencies analysis on both loops.

advisor --collect=survey --project-dir=./advi_results -- ./bin/myApplication
advisor --mark-up-loops --select=foo.cpp:34 --project-dir=./advi_results -- ./bin/myApplication
advisor --mark-up-loops --append=bar.cpp:192 --project-dir=./advi_results -- ./bin/myApplication
advisor --collect=dependencies --project-dir=./advi_results -- ./bin/myApplication