User Guide

  • 2021.2
  • 03/26/2021
  • Public Content
Contents

suppression-file

Use rules defined in a suppression file to exclude known problems during collection.

Syntax

-suppression-file
<PATH>
Arguments
A string containing the PATH/name for the
suppression file.
This may be an absolute path, or a path relative to the current working directory.
Pathname can be either:
directory
The name of a directory containing suppression files.
filename
The name of a suppression file. May be an absolute pathname or name relative to the current working directory.
The
inspxe-cl
tool appends a
.sup
extension if no extension is specified.
For multiple arguments: You may specify this option multiple times in a single command, or specify multiple arguments in a comma-separated list (no spaces). For example, the following are equivalent:
-suppression-file mySup1 -suppression-file mySup2.txt
-suppression-file mySup1,mySup2
Description
Use the
suppression-file
action-option to apply one or more suppression files when performing the
collect
or
collect-with
action. You can use the
create-suppression-file
action to generate a suppression file that contains rules that define which problems should be excluded from the Summary of detected problems.
When
suppression-file
is used with the
collect
action, the process uses all files with a .sup extension in the directory.
Example
This command:
  • Runs a
    Detect Deadlocks and Data Races (ti2)
    analysis on the application
    myApp
    .
  • Uses the short name
    -s-f
    for the
    suppression-file
    option.
  • Uses suppression files for
    myProject
    , found in the
    Microsoft Visual Studio* IDE
    standard location for private suppression files:
    C:\myProject\My Inspector Results-[project name]\suppressions
    .
  • Stores the result in a default-named result directory under the current working directory.
  • Generates a summary report of new or unsuppressed problems, and saves the report as
    inspxe-cl.txt
    in the result directory.
$ inspxe-cl -collect ti2 -s-f "C:\myProject\My Inspector Results\suppressions" -- myApp

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.