intel_gpu_top - like summary of Intel GPU usage
intel_gpu_top intel_gpu_top [ parameters ]
intel_gpu_top(1) General Commands Manual intel_gpu_top(1)
NAME
intel_gpu_top - Display a top-like summary of Intel GPU usage
SYNOPSIS
intel_gpu_top
intel_gpu_top [ parameters ]
DESCRIPTION
intel_gpu_top is a tool to display usage information of an Intel GPU.
It requires root privilege to map the graphics device.
Options
-s [samples per second]
number of samples to acquire per second
-o [output file]
collect usage statistics to [file]. If file is "-", run non-
interactively and output statistics to stdout.
-e ["command to profile"]
execute a command, and leave when it is finished. Note that the
entire command with all parameters should be included as one
parameter.
-h show usage notes
EXAMPLES
intel_gpu_top -o "cairo-trace-gvim.log" -s 100 -e "cairo-perf-trace
/tmp/gvim"
will run cairo-perf-trace with /tmp/gvim trace, non-interac-
tively, saving the statistics into cairo-trace-gvim.log file,
and collecting 100 samples per second.
Note that idle units are not displayed, so an entirely idle GPU will
only display the ring status and header.
BUGS
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.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+--------------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------------------+
|Availability | x11/diagnostic/intel-gpu-tools |
+---------------+--------------------------------+
|Stability | Volatile |
+---------------+--------------------------------+
NOTES
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://www.x.org/releases/individ-
ual/app/intel-gpu-tools-1.3.tar.bz2
Further information about this software can be found on the open source
community website at https://www.x.org.
X Version 11 intel-gpu-tools 1.3 intel_gpu_top(1)