1=============
2intel_gpu_top
3=============
4
5---------------------------------------------
6Display a top-like summary of Intel GPU usage
7---------------------------------------------
8.. include:: defs.rst
9:Author: IGT Developers <igt-dev@lists.freedesktop.org>
10:Date: 2019-02-08
11:Version: |PACKAGE_STRING|
12:Copyright: 2009,2011,2012,2016,2018,2019 Intel Corporation
13:Manual section: |MANUAL_SECTION|
14:Manual group: |MANUAL_GROUP|
15
16SYNOPSIS
17========
18
19**intel_gpu_top** [*OPTIONS*]
20
21DESCRIPTION
22===========
23
24**intel_gpu_top** is a tool to display usage information on Intel GPU's.
25
26The tool gathers data using perf performance counters (PMU) exposed by i915 and other platform drivers like RAPL (power) and Uncore IMC (memory bandwidth).
27
28OPTIONS
29=======
30
31-h
32    Show help text.
33
34-J
35    Output JSON formatted data.
36
37-l
38    List plain text data.
39
40-o <file path | ->
41    Output to the specified file instead of standard output.
42    '-' can also be specified to explicitly select standard output.
43
44-s <ms>
45    Refresh period in milliseconds.
46
47LIMITATIONS
48===========
49
50* Not all metrics are supported on all platforms. Where a metric is unsupported it's value will be replaced by a dashed line.
51
52* Non-root access to perf counters is controlled by the *perf_event_paranoid* sysctl.
53
54REPORTING BUGS
55==============
56
57Report bugs to https://bugs.freedesktop.org.
58