User Guide


Option Descriptions and General Rules

All option descriptions in the
Intel® VTune™
Command Line Interface Reference
follow the general rules and templates described below.

Option Description

Each option description provides the following information:
  • A short description of the option.
  • Products
    : This section lists the names of products supporting this option.
  • GUI Equivalent
    : This section shows the equivalent of the option in the integrated development environment (IDE)/standalone GUI client. If no equivalent is available, None is specified.
  • Syntax
    : This section describes the command line syntax of the option.
  • Arguments
    : This section lists the arguments related to the option. If it has no arguments, None is specified.
  • Default
    : This section shows the default setting for the option.
  • Modifiers
    : This section lists the modifiers for the described action. The section is only available for actions.
  • Actions Modified
    : This section lists the actions modified by the described option. The section is only available for modifiers.
  • Description
    : This section provides the full description for the option.
  • Alternate Options
    : These options can be used instead of the described option. If no alternate options are available, None is specified.
  • Example
    : This is a typical usage example of the option.
  • See Also
    : This section provides links to further information related to the option such as other options or corresponding GUI procedures.

General Rules

  • Options can be preceded by a single dash ("-") or a double dash ("--").
  • Option names and values can be separated with a space (" "), or an equal sign ("=").
  • Options defining the collection are specified before the analyzed target and can appear on the command line in any order. Options related to the target are specified after the target
  • You cannot combine options with a single dash. For example,
    options cannot be specified as -
  • Options may have short and long names. Short names consist of one letter. Long names consist of one or more words separated by dashes. Both short and long names are case-sensitive. Long and short option names can be used interchangeably. For example, you may use
    to generate a report.
  • Long names of the options can be abbreviated. If the option consists of several words you can abbreviate each word, keeping the dash between them. Make sure an abbreviated version unambiguously matches the long name. For example, the
    option can be abbreviated as
    , or
  • If the abbreviation is ambiguous between two available options, a syntax error is reported.
  • You can disable Boolean default options by specifying -
    from the command line. For example, to avoid displaying a summary report after analysis, run
    with the
    option. Conversely, if the default is -
    , you can disable it by specifying -
  • You can specify multiple values for the option by using the option several times, or by using the option once and specifying comma-separated values (make sure there are no spaces around the commas). The examples below are equivalent and specify two filters for the
    result when generating a hotspots report.
    On Linux*:
    -R hotspots -r r001tr -filter module=tachyon -filter module=vmlinux
    -R hotspots -r r001tr -filter module=tachyon,vmlinux
    On Windows*:
    -R hotspots -r r001tr -filter module=ntdll.dll -filter module=main.exe
    -R hotspots -r r001tr -filter module=ntdll.dll,main.exe

Product and Performance Information


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