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

JSON OUTPUT

65       To  parse  the  JSON as output by the tool the consumer should wrap its
66       entirety into square brackets ([ ]). This will make each sample point a
67       JSON array element and will avoid "Multiple root elements" JSON valida‐
68       tion error.
69

LIMITATIONS

71       • Not all metrics are supported on all platforms. Where a metric is un‐
72         supported it's value will be replaced by a dashed line.
73
74       • Non-root   access   to   perf   counters   is   controlled   by   the
75         perf_event_paranoid sysctl.
76

REPORTING BUGS

78       Report bugs to https://bugs.freedesktop.org.
79

AUTHOR

81       IGT Developers <igt-dev@lists.freedesktop.org>
82
84       2009,2011,2012,2016,2018,2019,2020 Intel Corporation
85
86
87
88
89igt-gpu-tools 1.26                2020-03-18                  INTEL_GPU_TOP(1)
Impressum