result-dir

GUI Equivalent

Analysis Target Setup

Syntax

Arguments

Argument

Description

<PATH>

The PATH/name of a directory where a result is stored. This may be an absolute pathname, or a pathname relative to the current working directory. If the final component of the pathname does not exist, it is created.

Default

If not specified, the default result name and directory are used. If not specified for a collect or collect-with action, a new result directory is created in the current working directory. If not specified when generating a report, the report uses the highest numbered compatible result in the current working directory. The default name for a result directory is r@@@{at}, where @@@ is the incremented number of the result, and {at} is a two- or three-letter abbreviation for the analysis type.

Actions Modified

collect, collect-with, finalize, import, report

Description

Use the result-dir option to specify the result directory. If you specify the result directory for collection or to import results from other projects, you should also specify the result directory for any actions that use this result, such as report.. Specifying the result directory when using the finalize action is highly recommended.

If you want to specify the result directory name, you can use the auto-incremented counter pattern @@@ with a prefix and/or suffix.

For example, you could use the prefix myResult- and the usual analysis type suffix like this: myResult-@@@{at}. If you then perform a memory error analysis, followed by a threading error analysis, specifying -result-dir myResult-@@@{at} each time, the result directories would be assigned the following names: myResult-000mi1 and myResult-001ti2.

Both short names and long names are case-sensitive. For example, -R is the short name of the report action, and -r is the short name of the result-dir action-option.

Alternate Options

The user-data-dir global-option can be used to specify the base directory for results. Result directories created under this base directory would use the default naming conventions unless specified using the result-dir action-option.