Intel® VTune™ Profiler User Guide

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

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.