Intel® Advisor Help
You can use the Intel® Advisor command line interface, advixe-cl, to run analysis and data collection. This makes it possible to automate many tasks or analyze an application running on remote hosts. The results can be viewed through the Intel Advisor GUI, or used to generate various kinds of reports.
If you have used the GUI to perform analysis and view results, you will notice a few differences between GUI and command line processes. The most important differences are:
Before using the command line, you must set command line environment variables. For instructions, see Setting Up Your Command Line Environment.
You must specify project directories.
Results cannot be viewed on the command line. You can use the GUI to view a result, or use command line tools to generate one or more reports from the result.
The advixe-cl Command Line Interface documentation assumes that you understand the Intel Advisor workflow and the prerequisites for successfully running each type of analysis, so be sure to consult the workflow documentation before proceeding.
If this is the first time you have used the advixe-cl Command Line Interface, review this chapter for an overview of command line capabilities, including general instructions for collecting analysis data and generating reports.
As you begin to construct commands, you can use the advixe-cl -help command or refer to the advixe-cl Option Reference for information on a specific action, option or argument. Each option reference includes a description of the option, tips to help you use it successfully, and one or more example commands.
Use the advixe-cl tool with the collect action to run each type of analysis in order, annotating your code as instructed in the workflow documentation. The data is collected into a result in your project directory.
After running an analysis and generating a result, you can view the result through the GUI to use the advixe-cl tool with the report action to take full advantage of the tools provided by Intel Advisor, or generate reports as needed. The analysis type used in collection determines which report types can be generated from the result. A variety of formatting options are available.
There are additional commands and options for MPI, and the syntax is somewhat different than regular advixe-cl command syntax. See Analyzing MPI Workloads for more information.