============= intel_gpu_top ============= --------------------------------------------- Display a top-like summary of Intel GPU usage --------------------------------------------- .. include:: defs.rst :Author: IGT Developers :Date: 2020-03-18 :Version: |PACKAGE_STRING| :Copyright: 2009,2011,2012,2016,2018,2019,2020 Intel Corporation :Manual section: |MANUAL_SECTION| :Manual group: |MANUAL_GROUP| SYNOPSIS ======== **intel_gpu_top** [*OPTIONS*] DESCRIPTION =========== **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). OPTIONS ======= -h Show help text. -J Output JSON formatted data. -l List plain text data. -o Output to the specified file instead of standard output. '-' can also be specified to explicitly select standard output. -s Refresh period in milliseconds. -L List available GPUs on the platform. -d Select a specific GPU using supported filter. DEVICE SELECTION ================ User can select specific GPU for performance monitoring on platform where multiple GPUs are available. A GPU can be selected by sysfs path, drm node or using various PCI sub filters. Filter types: :: --- filter syntax --- sys sys:/sys/devices/pci0000:00/0000:00:02.0 find device by its sysfs path drm drm:/dev/dri/* path find drm device by /dev/dri/* node pci pci:[vendor=%04x/name][,device=%04x][,card=%d] vendor is hex number or vendor name LIMITATIONS =========== * Not all metrics are supported on all platforms. Where a metric is unsupported it's value will be replaced by a dashed line. * Non-root access to perf counters is controlled by the *perf_event_paranoid* sysctl. REPORTING BUGS ============== Report bugs to https://bugs.freedesktop.org.