User Guide

  • 2020
  • 06/18/2020
  • Public Content
Contents

import

Import one or more collection data files/directories.

Syntax

-import
<PATH>
Arguments
A string containing the
PATH
of the data files to import. To import several files, make sure to use the
import
option for each path.
Description
Use the
import
action to import one or more collection data files into the
VTune
Profiler
. You may import the following formats:
  • .tb6
    or
    .tb7
    with event-based sampling data. To import the files, use the
    -result-dir
    option and specify the name for a new directory you want to create for the imported data. If you do not use the
    -result-dir
    option, the
    VTune
    Profiler
    creates a new directory with the default name.
  • .perf
    files with event-based sampling data collected by Linux* Perf tool. To ensure accurate data representation in the
    VTune
    Profiler
    , make sure to run the Perf collection with the predefined command line options:
    • For application analysis:
      perf record -o <
      trace_file_name
      >.perf --call-graph dwarf -e cpu-cycles,instructions <
      application_to_launch
      >
    • For process analysis:
      perf record -o <
      trace_file_name
      >.perf --call-graph dwarf -e cpu-cycles,instructions <
      application_to_launch
      > -p <
      PID
      > sleep 15
    where the
    -e
    option is used to specify a list of events to collect as
    -e <
    list of events
    >
    ;
    --call-graph
    option (optional) configures samples to be collected together with the thread call stack at the moment a sample is taken. See Linux Perf documentation on possible call stack collection options (for example,
    dwarf
    ) and its availability in different OS kernel versions.
    The Linux kernel exposes Perf API to the Perf tool starting from version 2.6.31. Any attempts to run the Perf tool on kernels prior to this version lead to undefined results or even crashes. See Linux Perf documentation for more details.
  • To import a
    csv
    file
    , use the
    -result-dir
    option and specify the name of an existing directory of the result that was collected by the
    VTune
    Profiler
    in parallel with the external data collection.
    VTune
    Profiler
    adds the externally collected statistics to the result and provides integrated data in the
    Timeline
    pane.
    Importing a
    csv
    file to the
    VTune
    Profiler
    result does not affect symbol resolution in the result. For example, you can safely import a
    csv
    file to a result located on a system where module and debug information is not available.
  • *.pwr
    processed Intel SoC Watch files with energy analysis data
This example imports the
sample_data.tb7
file into a
VTune
Profiler
project and creates the result directory
r000hs
:
vtune
–import sample_data.tb7 –result-dir r000hs
This example imports a trace file collected with the Linux Perf tool into a
VTune
Profiler
project and creates a default result directory
r000
(since no result directory is specified from the command line):
vtune
-import perf_trace.perf

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