Scroll to navigation

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 [OPTIONS]

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
Number of samples to acquire per second.
-o FILE
Collect usage statistics to FILE. If file is "-", run non-interactively and output statistics to stdout.
-e COMMAND
Execute COMMAND to profile, 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
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.

REPORTING BUGS

Report bugs to https://bugs.freedesktop.org.

AUTHOR

IGT Developers <igt-dev@lists.freedesktop.org>

COPYRIGHT

2009,2011,2012,2016 Intel Corporation
2016-03-01 intel-gpu-tools 1.22