User Guide

  • 2020
  • 05/04/2020
  • Public Content
Contents

Reporting Result Data from the Command Line

After performing an
Intel Inspector
analysis, data is collected into a result that can be viewed in the GUI or used to generate a report from the command line. By default, a report is written to
stdout
in text format, but the
inspxe-cl
command provides a number of options you can use when generating a report.

Report Types

The
report
action can be used with the following report types:
summary
Brief statement of the total number of problems detected during analysis, with a breakdown by problem type. After each
collect
or
collect-with
action, a summary report is generated by default, sent to
stdout
and also saved as an XML file in the current working directory.
status
Brief statement of the total number of problems detected in the result, with a breakdown by problem state.
problems
Detailed report of detected problem sets, including their location in the source code, such as the problem type, severity, module and line number.
observations
Detailed report of all code locations (observations) included in defined problem sets, such as the allocation site, function, module and line number.

Report Process Summary

  1. Set up the
    inspxe-cl
    command environment.
  2. Invoke the
    inspxe-cl
    command with the
    collect
    or
    collect-with
    action to inspect the application.
  3. Invoke the
    inspxe-cl
    command with the
    report
    action to generate a report of detected problems.

Report Process Example

  1. Add the
    bin64
    (or
    bin32
    ) directory (located in the installation directory) to your PATH environment variable.
    You can open a terminal and use the following commend to run the script that establishes
    Intel Inspector
    environment settings:
    source <install-dir>/inspxe-vars.sh
    For
    Intel® oneAPI HPC Toolkit
    or
    Intel® oneAPI IoT Toolkit
    installations, the script is named
    env\vars
    rather than inspxe-vars.
  2. In a command window, inspect the
    myApp
    application for memory problems and store the result in the
    myRes007mi2
    directory in the current working directory:
    inspxe-cl
    -collect mi2 -result-dir myRes007mi2 -- myApp
    • mi2
      is the short name for the
      Detect Memory Problems
      analysis type.
    • If you do not supply an absolute pathname for the application, system path environment settings are used to locate it.
  3. Print to
    stdout
    a list of new memory problems found in the
    myRes007mi2
    result:
    inspxe-cl
    -report problems -result-dir myRes007mi2
Status Report Example
Generate a status report for the specified result and display it to standard out.
-R
is the short name of the
-report
action, and
-r
is the short name of the
-result-dir
action.
$ inspxe-cl -R status -r myRes007mi2
The output status report:
181 problem(s) found 15 Investigated 166 Not investigated Breakdown by state: 13 Confirmed 2 Fixed 166 New

Next Step

Interpret result data.

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