User Guide

Contents

vtune
Actions

The
vtune
command tool of the
Intel® VTune™
Profiler
supports different command options.

Actions

Run the specified analysis type and collect data into a result.
Run a custom hardware event-based sampling or user-mode sampling and tracing collection using your settings.
Issue a command to a running collect action.
Perform symbol resolution to finalize or re-resolve a result.
Display brief explanations of command line arguments.
Import one or more collection data files/directories.
Generate a specified type of report from an analysis result.
Display version information for the
vtune
tool.
To access the most current command line documentation for an action, enter
vtune
-help <
action
>
, where <
action
> is one of the available actions. To see all available actions, enter
vtune
-help
.

Action Options

Action options define a behavior applicable to the specified action; for example, the
-result-dir
option specifies the result directory path for the
collect
action.
To access the list of available action options for an action, enter
vtune
-help <
action
>
, where <
action
> is one of the available actions. To see all available actions, enter
vtune
-help
.
Action-Option Usage Rules:
  • If opposing action-options are used on the same command line, the last specified action-option applies.
  • An action-option that is redundant or has no meaning in the context of the specified action is ignored.
  • Attempted use of an inappropriate action-option which would lead to unexpected behavior returns a usage error.

Global Options

Global options define a behavior applicable to all actions; for example, the
-quiet
option suppresses non-essential messages for all actions. You may have one or more global options per command.
To access the list of available global options for an action, enter
vtune
-help <
action
>
, where <
action
> is one of the available actions. To see all available actions, enter
vtune
-help
.

Get Information on Analysis Options

VTune
Profiler
offers many ways to get information on analysis options.
  • VTune
    Profiler
    can re-use analysis configuration options set in the GUI version and command line version of such a configuration. You can copy this command line to the clipboard and use it for the command line analysis. To do this, use the
    Command Line...
    button in the
    Configure Analysis
    window. This also works for custom analysis types.
  • To get more information on an action, enter:
    vtune
    -help <
    action
    >
    . For example, this command returns help for the
    collect-with
    action:
    
    
        
    vtune -help collect-with
  • For information on a specific analysis type, enter:
    vtune
    -help collect <
    analysis_type
    >
    or
    vtune
    -help collect-with <
    analysis_type
    >
    . For example, this command returns help for the
    threading
    analysis type:
    
    
        
    vtune -help collect threading
  • For information on a specific report, enter:
    vtune
    -help report <
    report_name
    >
    . For example, this command returns help for the
    callstacks
    report:
    
    
        
    vtune -help report callstacks

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804