User Guide

Intel® VTune™ Profiler User Guide

ID 766319
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

vtune Actions

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

Actions

archive

Archive collected results.

collect

Run the specified analysis type and collect data into a result.

collect-with

Run a custom hardware event-based sampling or user-mode sampling and tracing collection using your settings.

command

Issue a command to a running collect action.

finalize

Perform symbol resolution to finalize or re-resolve a result.

help

Display brief explanations of command line arguments.

import

Import one or more collection data files/directories.

report

Generate a specified type of report from an analysis result.

version

Display version information for the vtune tool.

NOTE:

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.

NOTE:

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.

NOTE:

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