Specifying Project Properties Using the Intel Advisor Standalone GUI

Open the Project Properties Dialog Box

After you open a project, to display the Project Properties dialog box, do one of the following:

• Choose File> Project Properties...
• Click the Image may be NSFW.
  Clik here to view. icon on the Intel Advisor toolbar.

After you display the Project Properties dialog box, the Analysis Target tab appears.

Specify Project Properties - Analysis Target Tab

To run your application for analysis, specify the location of the target executable as well as related information in this tab.

Use the Target type drop-down list to select whether the values in this tab apply to either:

• Survey and Suitability tools
• Correctness tool

Because no optimization level is recommended for Correctness tool but moderate optimization is recommended for the Survey and Suitability tools, you need to specify a different target for the Correctness tool.

As shown below, the Analysis Target contains multiple fields, beginning with the Application field:

Image may be NSFW.
Clik here to view.

For the selected Target type, specify:

• When using a Microsoft Visual Studio* project only, Inherit settings from Visual Studio project: decide whether Intel Advisor project properties should be inherited from the Visual Studio Startup project. If checked, the Application, Application parameters, and Working directory fields are pre-filled and cannot be modified.

• The Application (target): either type a path and file name to the target, or click the Browse... button and navigate to and select the application's target. You can specify a target executable or a script file. If you specify a script in the Application field, consider specifying the target executable to be analyzed in the Child application field; this is required for the Correctness tool if a script is specified in the Application field.

• The Application parameters: if your target's main entry point accepts command-line arguments, specify a value in this field. Either type a value, or click the Modify... button.

• Use application directory as working directory: If checked, automatically uses the value in the Application directory as the value for the Working directory.

• Working directory: This is usually filled in from the project settings, but you can specify a different value. Either type a path, or click the Browse... button and navigate to and select a directory.

• Managed code profiling mode: On Windows OS systems, choose the analysis mode to be used by the Intel Advisor. Auto mode automatically detects the type of target executable as Native or Managed, and switches to that mode. Native mode only collects data for native code and does not attribute data to managed code. Mixed mode collects data for both native and managed code, and attributes data to managed code as appropriate. Consider using this option when analyzing a native executable that makes calls to the managed code. Managed mode collects data for both native and managed code, resolves samples attributed to native code, attributes data to managed source only. The call stack in the analysis result displays data for managed code only.

• Use the Child application field to limit the analysis done by Intel Advisor tools. When specifying properties for Correctness tool analysis, if you specify a script file in the Application field, you must specify the target executable to be analyzed in the Child application field.

• Certain Advanced values only apply to either the Correctness Tool or the Survey/Suitability tools:

  • Survey/Suitability: If your target executes in less than one minute or for multiple hours, specify the Duration time estimate. You can specify the Sampling Interval to control result size or specify a Collection Data Limit, such as for large results. You can specify the Resume collection after, ms value, which is like using Start Paused from the GUI. For details about these Advanced options, see Dialog Box Project Properties - Analysis Target.

Specify Project Properties - Binary/Symbol Search Tab

To enable Intel Advisor tool reports to display sources and provide binary-to-source correlation (debug) information, you must specify the location of binary and debug information symbol files associated with your application's source files in this tab. You must build your application with debug information (view the help topic Build Settings for your language - click the link under See Also below).

When using the advixe-cl command line, specify the project properties using the --search-dir option.

As shown below, the Binary/Symbol Search tab allows you to specify multiple locations to search for, such as a local directories or a symbol server URL.

Image may be NSFW.
Clik here to view.

• Select a row containing Add new search location.
• Either click the Image may be NSFW.
  Clik here to view. button on the right of that row, or type directly into that row.
• If you clicked the Image may be NSFW.
  Clik here to view. button, navigate (browse) to and select a directory.
• Click OK to add the row.
• Repeat the above steps if you need to include other locations. You can move the current row up, down, and delete rows using the buttons on the lower-right.

If you must search subdirectories of all specified directory locations, select the Search recursively check box (lower left corner). To use this recursive search, the rows must provide only a directory name and omit a file name. Using a recursive search for multiple directories may slow processing and could lead to unexpected results.

Specify Project Properties - Source Search Tab

To run your target with the Suitability and Correctness tools, you must specify the location(s) of your application's annotated sources when using the Intel Advisor Standalone GUI or if the sources being annotated are not set up correctly in Microsoft Visual Studio*. If you do not successfully provide the locations of the source files in this tab, Intel Advisor will not be able to locate your annotations and you will not be able to run the Suitability and Correctness tools successfully.

When using the advixe-cl command line, specify the project properties using the --search-dir option.

As shown below, the Source Search tab has two major areas:

• An upper area Image may be NSFW.
  Clik here to view. where you specify the location(s) of source files. You must specify at least one directory, including its path name. You can specify multiple directories. To indicate that all subdirectories be searched, select (check) the Search recursively check box. To use recursive search, the lines must provide only a directory name and omit a file name. Using a recursive search for multiple directories may slow processing and could lead to unexpected results.
• A lower area Image may be NSFW.
  Clik here to view. to specify source file(s) to be excluded from the search, either a file name using wildcards (Mask column) or a specific file name (File column). For example, you might specify that a source control subdirectory be excluded.

Image may be NSFW.
Clik here to view.

To add a new row into the upper part of the tab, either type (or paste) a location into the row or:

• Select a row containing Add new search location.
• Either click the Image may be NSFW.
  Clik here to view. button on the right of that row, or type directly into that row.
• If you clicked the Image may be NSFW.
  Clik here to view. button, navigate (browse) to and select a directory.
• Click OK to add the row.
• Repeat the above steps if you need to include other locations. You can move the current row up, down, and delete rows using the buttons on the lower-right.

Similarly, to add rows into the lower (exclude from search) part of this tab, either type or click the Image may be NSFW.
Clik here to view. button to add wildcard file names under the Mask column or specific file names under the File column.

For information about the default source locations and the search order, see Binary/Symbol Search and Source Search Order and Locations.