User Guide

  • 2020
  • 05/04/2020
  • 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.
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

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