Global Options (vtl)

This information applies to command-line interface (vtl) only.

To display and modify the values of default Activity and data collection options, use the global-options command:

vtl global-options

Use the -show (or -s) option to display all global options and associated values. These values are used by default unless you specify other values when configuring an Activity.

You can modify an existing global option value by entering <name>=<value1>.

The following VTune(TM) Performance Environment global options are available:

Option

Description

compress-files

If set to "yes", compresses project files when packing.

If set to "no", keeps the actual size of the packed project.

Note

The previous versions of the product can't open the compressed packed files.

activity-duration

The number of seconds to run an Activity and collect data. The default value is 20 seconds. If you set a different value for the Activity duration, it is only effective if there is no associated application to launch. If there is an Application to Launch associated with the activity, the default duration is 0 regardless of any global option setting. This setting runs the Activity indefinitely, until you stop data collection manually, using the ActivityController tool.

rdc-configuration-file

Specify the path to the rdc configuration file that contains encrypted password information. By default, this is /home/vtune/VTune/.rdcconfiguration.

interactive-authentication

If set to "no", enables the non-interactive mode. In the non-interactive mode, the system searches for the password information in the rdc configuration file.

If set to "yes", enables the interactive mode. In the interactive mode, the system asks you for password when you are connecting to the remote machine.

kill-app-without-prompt

If set to "yes", terminates an application after data collection without asking for confirmation. This could be useful when running vtl using scripts.

If set to "no", asks for confirmation every time before terminating an application. "no" is the default value.

binary_search_dirs

Specify directory/directories to search binary files.

The appropriate values for this option are:

binary_search_dirs=<dir1>;<dir2>;...;<dirN>

Note

If the directory name has a space, specify it in quotes.

symbol_search_dirs

Specify directory/directories to search symbol files.

The appropriate values for this option are:

symbol_search_dirs=<dir1>;<dir2>;...;<dirN>

source_search_dirs

Specify directory/directories to search source files.

The appropriate values for this option are:

symbol_search_dirs=<dir1>;<dir2>;...;<dirN>

Note

The global-options command lists both VTune environment and VTune(TM) Performance Analyzer global options. To modify the VTune analyzer  global options (call graph global options), see the Call Graph Global Options topic.

Command-line example:

>vtl global-options -s

 

compress-files="yes"

activity-duration="20"

interactive-authentication="no"

kill-app-without-prompt="no"

rdc-configuration-file="/home/vtune/VTune/.rdcconfiguration"

binary_search_dirs=""

symbol_search_dirs=""

source_search_dirs=""

...

>vtl global-options activity-duration="15"

This sets the default Activity duration to 15 seconds.