Get Started with Intel® Inspector-Windows* OS

Intel® Inspector is a dynamic memory and threading error checking tool for users developing serial and multithreaded applications on Windows* and Linux* operating systems. This topic is part of a Getting Started document that summarizes an end-to-end workflow you can apply to your applications.

Prerequisites

You can use the Intel Inspector to analyze memory and threading errors in both debug and release modes of C++ and Fortran binaries. To build applications that produce the most accurate and complete Intel Inspector analysis results:

  • Build your application in debug mode.

  • Use optimal compiler/linker settings. For more information, see Building Applications in Intel Inspector Help.

  • Ensure your application creates more than one thread before you run threading analyses.

In addition:

  • Verify your application runs outside the Intel Inspector environment.

  • For the Intel Inspector in the Intel Parallel Studio XE, do one of the following to set up your environment. Note: Setting up your environment is necessary only if you plan to use the inspxe-gui command to launch the Intel Inspector standalone GUI interface or the inspxe-cl command to run the command line interface.

    • Run the <inspector-install-dir>\inspxe-vars.bat command.

      The default installation path, <inspector-install-dir>, is below C:\Program Files (x86)\IntelSWTools\ (on certain systems, instead of Program Files (x86), the directory name is Program Files ).

    • Run the <studio-install-dir>\psxevars.bat command.

      The default installation path, <studio-install-dir>, is below C:\Program Files (x86)\IntelSWTools\.

  • For the Intel Inspector in the Intel System Studio, run the <inspector-install-dir>\inspxe-vars.bat command to set up your environment. Note: Setting up your environment is necessary only if you plan to use the inspxe-gui command to launch the Intel Inspector standalone GUI interface or the inspxe-cl command to run the command line interface.

    The default installation path, <inspector-install-dir>, is below C:\Program Files (x86)\IntelSWTools\ (on certain systems, instead of Program Files (x86), the directory name is Program Files ).

For more information, see Building Applications in Intel Inspector Help.

Get Started

Follow these steps to get started using the Intel Inspector.
Intel Inspector workflow

Launch the Intel Inspector

To launch the:

  • Intel Parallel Studio XE/Intel Inspector standalone GUI: Run the inspxe-gui command or from the Microsoft Windows* All Apps screen, select Intel Parallel Studio XE 201n > Intel Inspector 201n.

  • Intel System Studio/Intel Inspector standalone GUI: Select Tools > Intel Inspector > Launch Intel Inspector from the IDE.

  • Intel Inspector plug-in to the Visual Studio* IDE: Open your solution in the Visual Studio* IDE.

To launch the command line interface: Run the inspxe-cl command. (To get help, append -help to the command line.)

Choose/Create Project

Intel Inspector is based on a project paradigm and requires that you create or open a project to enable analysis features.

Think of an analysis project as a:

  • Compiled application

  • Collection of configurable attributes, including suppression rules and search directories

  • Container for analysis results

For more information, see Choosing Projects in Intel Inspector Help.

Configure Project

Data set size and workload have a direct impact on application execution time and analysis speed.

For best results, choose small, representative data sets that create threads with minimal to moderate work per thread.

Your objective: In as short a runtime period as possible, execute as many paths and the maximum number of tasks (parallel activities) as you can afford, while minimizing the redundant computation within each task to the bare minimum needed for good code coverage.

Data sets that run a few seconds are ideal. Create additional data sets to ensure all your code is inspected.

For more information, see Configuring Projects in Intel Inspector Help.

Configure Analysis

Intel Inspector offers a range of preset memory and threading analysis types (as well as custom analysis types) to help you control analysis scope and cost. The narrower the scope, the lighter the load on the system. The wider the scope, the larger the load on the system.

Tip

Use analysis types iteratively. Start with a narrow scope to verify your application is set up correctly and set expectations for analysis duration. Widen the scope only if you need more answers and you can tolerate the increased cost.

For more information, see Configuring Analyses in Intel Inspector Help.

Run Analysis

When you run an analysis, the Intel Inspector:

  • Executes your application.

  • Identifies issues that may need handling.

  • Collects those issues in a result.

  • Converts symbol information into filenames and line numbers.

  • Applies suppression rules.

  • Performs duplicate elimination.

  • Forms problem sets.

  • Depending on your analysis configuration options, may launch an interactive debugging session.

For more information, see Running Analyses in Intel Inspector Help.

Choose Problems

During analysis, the Intel Inspector displays problems in the order detected. After analysis is complete, the Intel Inspector:

  • Groups detected problems into problem sets (but still provides visibility into individual problems and problem occurrences).

  • Prioritizes the problem sets.

  • Offers filtering to help you focus on those problem sets that require your attention.

Summary window

For more information, see Choosing Problems in Intel Inspector Help.

Interpret Result Data and Resolve Issues

Use the following Intel Inspector features to enhance your productivity:

Objective

Feature

During Analysis/After Analysis Is Complete

Interpret result data.

Explain Problem Help

For more information, see Accessing Explain Problem Help in Intel Inspector Help.

  • During analysis

  • After analysis is complete

Focus only on those issues that require your attention.

Severity Levels

For more information, see Severity Levels in Intel Inspector Help.

  • During analysis

  • After analysis is complete

States

For more information, see States in Intel Inspector Help.

After analysis is complete

Suppression rules

For more information, see Suppressions Support in Intel Inspector Help.

After analysis is complete

Resolve issues.

Direct access to a default editor

For more information, see Editing Source Code in Intel Inspector Help.

  • During analysis

  • After analysis is complete

For More Information

Document/Resource

Description

Intel Inspector: Featured Documentation

An excellent overall resource for novice, intermediate, and advanced users, this page includes links to guides, release notes, videos, featured topics, training samples, and more.

Intel Inspector Release Notes and New Features

Contain up-to-date information about the Intel Inspector, including a description, technical support, and known limitations. This document also contains system requirements, installation instructions, and instructions for setting up the command line environment.

Training Samples, ReadMe's, and Tutorials or Tutorials

Help you learn to use the Intel Inspector. After you copy a training sample compressed file to a writable directory, use a suitable tool to extract the contents. To load a training sample into the Visual Studio* environment, double-click the .sln file.

Training samples help you learn to use the Intel Inspector. Training samples are installed as individual compressed files under <inspector-install-dir>\samples\en\. After you copy a training sample compressed file to a writable directory, use a suitable tool to extract the contents. Extracted contents include a short README that describes how to build the training sample and fix issues. To load a training sample into the Visual Studio* environment, double-click the .sln file.

Tutorials show you how to find and fix uninitialized memory access, memory leak, and data race errors using C++ and Fortran training samples.

Intel Inspector User Guide

The User Guide is the primary documentation for the Intel Inspector.

More Resources

Intel Inspector: Home

Intel Inspector Glossary

Explore Our Documentation

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