Working with Projects and Activities

The VTune(TM) Performance Environment provides several types of analysis to help you understand the performance of your software. It enables you to add one or more Activities and specify the type of performance data you want to collect, using different analysis techniques.

The VTune environment provides wizards to help you create Activities. The Activity is created within a project. Once you create an Activity, it appears in the Tuning Browser.

At the end of data collection, the VTune environment displays the Activity results in the appropriate data collector or static analysis view. It also displays an entry for the results under the respective Activity in the Tuning Browser.

A tuning project (.vpj file) contains tuning Activities and Activity results, both of which may be associated with additional files. You can modify an existing Activity using the Application/Module Profile Configuration dialog box.

Working with Projects and Activities from Command Line

The VTune environment enables you to manipulate and examine the project, Activities, and Activity results from the command line. The following commands are available:

Command Name

Description

project

Opens a project created in the graphical interface of the VTune(TM) Performance Analyzer.

activity

Creates an Activity.

delete

Deletes the project or an Activity.

global-options

Displays or modifies default option values for all Activities in a project.

rdc-config

Controls the remote data collection settings provided in the remote data collection configuration file.

pack

Packs the project's contents into file with the .vxp extension

unpack

Unpacks a packed project (.vxp file) to a project.

import

Imports a file into a project.

query

Provides information about available collectors and views.

run

Runs the Activity defined in the project file.

show

Shows the contents of the project.

version

Shows version information.

view

Shows the Activity result in an ASCII format.

Note

You can enter multiple commands in a single command line.

Command-line example:

>vtl show activity -c sampling show run a1 show

This example enables you to:

1. View the current project state.

2. Create a new Activity with the sampling collector.

3. View the project again.

4. Run the Activity.

5. View the project once again with Activity results.

 

Click the following buttons for more information about working with projects and Activities:

 How do I?

 How does it work?

 Toolbar and Pop-up Menu

 Tips

 Troubleshooting