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:- for Android* systems, wheredeviceNameis the name of an Android device connected via ADB.deviceName
- ssh:- 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).username@hostname[:port]
- get-perf-cmd:- for Linux* systems. When you specify the target PMU name, this argument displays on the command line the parameters for thepmuNameperfdriverless collector for a specific analysis. To see a list of available PMUs, type:
Use this argument when:sep -platform-list- You do not have an SSH connection to the target machine.
- You cannot installVTuneon the target machine, for security reasons.Profiler
The Linux Perf* tool (driverless collection) supports complex event names that contain.:=symbols in v4.18 and newer versions. For example,
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.outperf record -e cpu/period=0x98968f,event=0xc7,umask=0x20,name=\'FP_ARITH_INST_RETIRED_256B_PACKED_SINGLE\'/uk ./a.out
Actions Modified
Description
Intel®
)
installed on the host system (remote usage mode). Use the
VTune
enables you to analyze applications running on a remote Linux system or Android
device ( Profiler
target system
) using the
VTune
command line interface ( Profiler
vtune
target-system
option to specify your target system and
enable remote data collection.
For details, see
Linux* System Setup
for Remote Analysis and
Android* System
Setup.
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