Intel® Inspector User Guide for Windows* OS

ID 767798
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

Command Syntax

The Intel Inspectorinspxe-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.

TIP:
  • To access the most current command line documentation: Enter inspxe-cl -help

  • To duplicate an analysis performed in the Intel Inspector GUI: Use the Command Line button on the Analysis Type window panes to copy the exact command to the clipboard.

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.