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 aDetect Deadlocks and Data Racesanalysis is performed on atarget specified on the command line.
- It uses theC:\myAppProj\My Inspector Results\suppressions\mySup.supsuppression file, filtering out unwanted problems from the results according to rules in the suppressions file.
- Stores the result in the defaultr@@@ti2result 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 asinspxe-cl.txtin the result directory.