User Guide

Contents

target-system

Collect data on a remote machine using SSH/ADB connection.
GUI Equivalent
Configure Analysis
window >
WHERE
pane

Syntax

-target-system=
<string>
Arguments
<string>
Target system for remote collection. Supported values are:
  • android:
    deviceName
    - for Android* systems, where
    deviceName
    is the name of an Android device connected via ADB.
  • ssh:
    username@hostname[:port]
    - for Linux* systems, where you specify a user name, network name of the remote system accessed via SSH (usually IP address), and a port to connect (if required).
  • get-perf-cmd:
    pmuName
    - for Linux* systems. When you specify the target PMU name, this argument displays on the command line the parameters for the
    perf
    driverless collector for a specific analysis. To see a list of available PMUs, type:
    sep -platform-list
    Use this argument when:
    • You do not have an SSH connection to the target machine.
    • You cannot install
      VTune
      Profiler
      on the target machine, for security reasons.
    The Linux Perf* tool (driverless collection) supports complex event names that contain
    .:=
    symbols in v4.18 and newer versions. For example,
    perf record -e cpu/period=0x98968f,event=0xc7,umask=0x20,name=\'FP_ARITH_INST_RETIRED.256B_PACKED_SINGLE\'/uk ./a.out
    Complex names like this example are not necessary for the Perf tool itself. You can replace these symbols for a simpler name.
    perf record -e cpu/period=0x98968f,event=0xc7,umask=0x20,name=\'FP_ARITH_INST_RETIRED_256B_PACKED_SINGLE\'/uk ./a.out
Actions Modified
Description
Intel®
VTune
Profiler
enables you to analyze applications running on a remote Linux system or Android device (
target system
) using the
VTune
Profiler
command line interface (
vtune
) installed on the host system (remote usage mode). Use the
target-system
option to specify your target system and enable remote data collection.
Example
This command runs Hotspots analysis in the hardware event-based mode for the application on a Linux embedded system:
host>./vtune --target-system=ssh:user1@172.16.254.1 –collect hotspots -knob collection-type:hw-events -- /target-system-path/app
This example shows a list of available PMU names and the command for driverless collection for a Linux system:
$sep -platform-list ... Platform: 111, PMU: skylake_server, Signature: 0x50650, CPU name: Intel(R) Xeon(R) Processor code named Skylake ... $ vtune --collect uarch-exploration --target-system=get-perf-cmd:skylake_server
This command runs Hotspots analysis in the user-mode sampling mode for the application on an Android system:
host>./vtune –-collect hotspots –-target-system=android -r quadrant_r@@@ --target-process com.intel.fluid
This command runs Hotspots analysis in the hardware event-based mode for the application on an Android system:
host>./vtune --collect hotspots -knob collection-type:hw-events --target-system=android -r quadrant_r000 --target-process com.intel.fluid

Product and Performance Information

1

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