1INTEL_GPU_TOP(1)            General Commands Manual           INTEL_GPU_TOP(1)
2
3
4

NAME

6       intel_gpu_top - Display a top-like summary of Intel GPU usage
7

SYNOPSIS

9       intel_gpu_top [OPTIONS]
10

DESCRIPTION

12       intel_gpu_top is a tool to display usage information on Intel GPU's.
13
14       The  tool gathers data using perf performance counters (PMU) exposed by
15       i915 and other platform drivers like RAPL (power) and Uncore IMC  (mem‐
16       ory bandwidth).
17

OPTIONS

19       -h     Show help text.
20
21       -J     Output JSON formatted data.
22
23       -l     List plain text data.
24
25       -o <filepath|->
26              Output  to  the  specified file instead of standard output.  '-'
27              can also be specified to explicitly select standard output.
28
29       -s <ms>
30              Refresh period in milliseconds.
31
32       -L     List available GPUs on the platform.
33
34       -d     Select a specific GPU using supported filter.
35

RUNTIME CONTROL

37       Supported keys:
38          'q'    Exit from the  tool.   'h'     Show  interactive  help.   '1'
39          Toggle  between  aggregated  engine  class and physical engine mode.
40          'n'    Toggle display  of  numeric  client  busyness  overlay.   's'
41          Toggle  between sort modes (runtime, total runtime, pid, client id).
42          'i'    Toggle display of  clients  which  used  no  GPU  time.   'H'
43          Toggle between per PID aggregation and individual clients.
44

DEVICE SELECTION

46       User  can  select  specific  GPU for performance monitoring on platform
47       where multiple GPUs are available.  A GPU  can  be  selected  by  sysfs
48       path, drm node or using various PCI sub filters.
49
50       Filter types:
51
52          ---
53          filter   syntax
54          ---
55          sys      sys:/sys/devices/pci0000:00/0000:00:02.0
56                   find device by its sysfs path
57
58          drm      drm:/dev/dri/* path
59                   find drm device by /dev/dri/* node
60
61          pci      pci:[vendor=%04x/name][,device=%04x][,card=%d]
62                   vendor is hex number or vendor name
63

LIMITATIONS

65       · Not  all  metrics  are  supported on all platforms. Where a metric is
66         unsupported it's value will be replaced by a dashed line.
67
68       · Non-root   access   to   perf   counters   is   controlled   by   the
69         perf_event_paranoid sysctl.
70

REPORTING BUGS

72       Report bugs to https://bugs.freedesktop.org.
73

AUTHOR

75       IGT Developers <igt-dev@lists.freedesktop.org>
76

78       2009,2011,2012,2016,2018,2019,2020 Intel Corporation
79
80
81
82
83igt-gpu-tools 1.25                2020-03-18                  INTEL_GPU_TOP(1)
Impressum