Commit 63f0bf3d authored by Tvrtko Ursulin's avatar Tvrtko Ursulin

intel-gpu-top: Rewrite the tool to be safe to use

intel-gpu-top is a dangerous tool which can hang machines due unsafe mmio
register access. This patch rewrites it to use only PMU.

Only overall command streamer busyness and GPU global data such as power
and frequencies are included in this new version.

For access to more GPU functional unit level data, an OA metric based tool
like gpu-top should be used instead.

 * Sort engines by class and instance.
 * Do not wait for one sampling period to display something on screen.
 * Move code out of the asserts. (Rinat Ibragimov)
 * Continuously adapt to terminal size. (Rinat Ibragimov)

 * Change layout and precision of some field. (Chris Wilson)
 Eero Tamminen:
 * Use more user friendly engine names.
 * Don't error out if a counter is missing.
 * Add IMC read/write bandwidth.
 * Report minimum required kernel version.

 * Really support 4.16 by skipping of missing engines.
 * Simpler and less hacky float printing.
 * Preserve copyright header. (Antonio Argenziano)
 * Simplify engines_ptr macro. (Rinat Ibragimov)

 * Get RAPL unit from sysfs.
 * Consolidate sysfs paths with a macro.
 * Tidy error handling by carrying over and reporting errno.
 * Check against console height on all prints.
 * More readable minimum kernel version message. (Eero Tamminen)
 * Column banner for per engine stats. (Eero Tamminen)

 * Man page update. (Eero Tamminen)
Signed-off-by: Tvrtko Ursulin's avatarTvrtko Ursulin <>
Cc: Chris Wilson <>
Cc: Lionel Landwerlin <>
Cc: Petri Latvala <>
Cc: Eero Tamminen <>
Cc: Rinat Ibragimov <>
Reviewed-by: Lionel Landwerlin <> # v1
Reviewed-by: Chris Wilson <> # v0.5
Reviewed-by: 's avatarMatthew Auld <>
parent 6796a604
......@@ -69,3 +69,9 @@ int igt_perf_open(uint64_t type, uint64_t config)
return _perf_open(type, config, -1,
int igt_perf_open_group(uint64_t type, uint64_t config, int group)
return _perf_open(type, config, group,
......@@ -55,5 +55,6 @@ uint64_t i915_type_id(void);
int perf_i915_open(uint64_t config);
int perf_i915_open_group(uint64_t config, int group);
int igt_perf_open(uint64_t type, uint64_t config);
int igt_perf_open_group(uint64_t type, uint64_t config, int group);
#endif /* I915_PERF_H */
......@@ -7,9 +7,9 @@ Display a top-like summary of Intel GPU usage
.. include:: defs.rst
:Author: IGT Developers <>
:Date: 2016-03-01
:Date: 2018-04-04
:Copyright: 2009,2011,2012,2016 Intel Corporation
:Copyright: 2009,2011,2012,2016,2018 Intel Corporation
:Manual section: |MANUAL_SECTION|
:Manual group: |MANUAL_GROUP|
......@@ -21,42 +21,25 @@ SYNOPSIS
**intel_gpu_top** is a tool to display usage information of an Intel GPU. It
requires root privilege to map the graphics device.
**intel_gpu_top** is a tool to display usage information on Intel GPU's.
The tool gathers data using perf performance counters (PMU) exposed by i915 and other platform drivers like RAPL (power) and Uncore IMC (memory bandwidth).
Number of samples to acquire per second.
Collect usage statistics to FILE. If file is "-", run non-interactively
and output statistics to stdout.
Execute COMMAND to profile, and leave when it is finished. Note that the
entire command with all parameters should be included as one parameter.
-s <ms>
Refresh period in milliseconds.
Show usage notes.
Show help text.
intel_gpu_top -o "cairo-trace-gvim.log" -s 100 -e "cairo-perf-trace /tmp/gvim"
Run cairo-perf-trace with /tmp/gvim trace, non-interactively, saving the
statistics into cairo-trace-gvim.log file, and collecting 100 samples per
Note that idle units are not displayed, so an entirely idle GPU will only
display the ring status and header.
* Not all metrics are supported on all platforms. Where a metric is unsupported it's value will be replaced by a dashed line.
Some GPUs report some units as busy when they aren't, such that even when idle
and not hung, it will show up as 100% busy.
* Non-root access to perf counters is controlled by the *perf_event_paranoid* sysctl.
......@@ -28,6 +28,8 @@ intel_aubdump_la_LDFLAGS = -module -avoid-version -no-undefined
intel_aubdump_la_SOURCES = aubdump.c
intel_aubdump_la_LIBADD = $(top_builddir)/lib/ -ldl
intel_gpu_top_LDADD = $(top_builddir)/lib/
bin_SCRIPTS = intel_aubdump
This diff is collapsed.
......@@ -23,7 +23,6 @@ tools_progs = [
......@@ -117,6 +116,11 @@ shared_library('intel_aubdump', 'aubdump.c',
name_prefix : '',
install : true)
executable('intel_gpu_top', 'intel_gpu_top.c',
install : true,
install_rpath : rpathdir,
dependencies : tool_deps + [ lib_igt_perf ])
conf_data = configuration_data()
conf_data.set('prefix', prefix)
conf_data.set('exec_prefix', '${prefix}')
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment