Intel® Inspector User Guide for Linux* OS

User Guide

  • 2021.4
  • 09/27/2021
  • Public Content
Contents

option-file

Specify one or more files containing command line options.

Syntax

-option-file
<PATH>
Arguments
A string containing the PATH/name for the
one or more text files that contain additional command options. This may be absolute, or relative to the current working directory.
Actions Modified
This global option can be used with any action, including:
collect
,
collect-with
,
finalize
,
merge
, and
report
.
Description
Use the
option-file
 global-option to specify one or more text files containing command line arguments, where each line include one or more arguments terminated by a newline character.
  • Arguments specified in an option file are processed before any arguments that may be specified on the command line.
  • If multiple option files are used, they are processed in the order in which they are specified on the command line.
Put commonly used options in a text file to shorten the command line and to create a reusable invocation syntax.
Options specified on the command line can override options in the option file(s), because options in the file(s) are processed prior to options passed in through the command line.
Example
In this example, an option file named
ti2Supp.txt
 specifies the
suppression-file
 option and path to the suppression file. 
-suppression-file "C:\myAppProj\My Inspector Results-[project name]\suppressions\mySup"
This command performs the
collect
 action, passing in the option file
ti2Supp.txt
. 
$inspxe-cl -collect ti2 -option-file ti2Supp.txt -- myApp
When this option file is processed:
  • It runs a
    Detect Deadlocks and Data Races
     analysis is performed on a
    target specified on the command line
    .
  • It uses the
    C:\myAppProj\My Inspector Results\suppressions\mySup.sup
     suppression file, filtering out unwanted problems from the results according to rules in the suppressions file.
  • Stores the result in the default
    r@@@ti2
     result directory in the current working directory, where
    @@@
     represents the next available number.
  • Generates a summary report of new or unsuppressed problems, and saves the report as
    inspxe-cl.txt
     in the result directory.

Product and Performance Information

1

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