User Guide

  • 2020
  • 09/09/2020
  • Public Content
Contents

Command Syntax

The
Intel Inspector
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.
  • 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
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
The
inspxe-cl
tool appends a
.sup
extension if no extension is specified.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804