Specify Result Directory from Command Line
It is generally safest to specify a PATH/name for the result directory when working on the command line. When using an action that takes a result as input, it is safer to specify the result directory, even if the result was created using the default directory.
- Be sure to specify the result directory when using an action that takes a result as input, especially thefinalizeorimportaction.
- You want to store the result in a different directory than the current working directory.
- The result is assigned a name other than the default. In this case, you would specify the result name when performing thecollectorcollect-withaction, and also when generating a report or performing any other actions that take this result as input.
Use the
-result-dir | -r
action-option to specify the PATH/name of a result directory. This may be an absolute path, or a path relative to the current working directory.
- To specify the directory path but use the default naming conventions for the directory, just specify the path.
- To specify the name of the result directory, but have the result written to the current working directory, just specify a name for the result directory.
Use the
user-data-dir
action-option to specify the base directory for result paths.
Example
This command runs the Hotspots analysis of
myApplication
in the current working directory, which is named
test
. The result is saved in a default-named directory under the
/home/test/
directory. If this was the first Hotspots analysis run, the result directory would be named
r000hs
.
vtune -collect hotspots -result-dir=/home/test/ -- /home/test/myApplication
To generate a report from this result, you must specify the result directory.
vtune -report hotspots -r=/home/test/ -- /home/test/myApplication