Command Syntax

The inspxe-cl command syntax is:

$ inspxe-cl <-action> [-action-options] [-global-options] [-- application [application options]]

inspxe-cl

The name of the Intel® Inspector command line tool.

<-action>

The action to perform, such as collect or report. There must be only one action per command. So you cannot, for example, collect data and generate a report with the same command.

[-action-option]

Action-options modify behavior specific to the action. You can have multiple action-options per action. Using an action-option that does not apply to the action results in a usage error.

[-global-option]

Global-options modify behavior in the same manner for all actions. You can have multiple global-options per action.

[-- application]

The target application to analyze.

[application-options]

Options for the application.

Note

To access help through the command line, enter: inspxe-cl -help

Example #1

Display product version information.

$ inspxe-cl -version

Example #2

This example:

  • Runs a Detect Deadlocks and Data Races (ti2) analysis on the application myApp.

  • Stores the collected data in a result in the specified myRes result directory, which is created in the current working directory by default.

$ inspxe-cl -collect ti2 -result-dir .\myResult -- myApp.exe

where:

  • -collect = action

  • ti2 = argument of action

  • -result-dir = action-option

  • myResult = argument of action-option

  • myApp.exe = target application

Note

If you do not supply an absolute pathname for the application, system path environment settings are used to locate it.

Example #3

This example generates a mySup.sup suppression file for all problems in the specified myRes result directory.

$ inspxe-cl -create-suppression-file .\mySupFile -result-dir .\myRes

where:

  • -create-suppression-file = action

  • mySup = argument of action

  • -result-dir = action-option

  • myRes = argument of action-option

Note

The inspxe-cl tool appends a .sup extension if no extension is specified.

See Also


Supplemental documentation specific to a particular Intel Studio may be available at <install-dir>\<studio>\documentation\ .

For more complete information about compiler optimizations, see our Optimization Notice.