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-interactively, 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.