User Guide

Intel® VTune™ Profiler User Guide

ID 766319
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

result-dir

Specify the result directory.

GUI Equivalent

Configure Analysis window > WHAT pane

Syntax

-result-dir <PATH>

-r <PATH>

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.

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.

Example

This example starts the Threading analysis of the myApplication application and saves the results in the baseline result directory.

On Linux*:

vtune -collect threading -result-dir /temp/test/baseline  -- /temp/test/myApplication

On Windows*:

vtune -collect threading -result-dir C:\test\baseline  -- C:\test\myApplication.exe