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.

Tip

Put commonly used options in a text file to shorten the command line and to create a reusable invocation syntax.

CAUTION

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.

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