FreeBSD Manual Pages
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 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 (mem- ory bandwidth). OPTIONS -h Show help text. -J Output JSON formatted data. -l List plain text data. -o <filepath|-> Output to the specified file instead of standard output. '-' can also be specified to explicitly select standard output. -s <ms> Refresh period in milliseconds. -L List available GPUs on the platform. -d Select a specific GPU using supported filter. RUNTIME CONTROL Supported keys: 'q' Exit from the tool. 'h' Show interactive help. '1' Toggle between aggregated engine class and physical engine mode. 'n' Toggle display of numeric client busyness overlay. 's' Toggle between sort modes (runtime, total runtime, pid, client id). 'i' Toggle display of clients which used no GPU time. 'H' Toggle between per PID aggregation and individual clients. 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 JSON OUTPUT To parse the JSON as output by the tool the consumer should wrap its entirety into square brackets ([ ]). This will make each sample point a JSON array element and will avoid "Multiple root elements" JSON valida- tion error. LIMITATIONS • Not all metrics are supported on all platforms. Where a metric is un- supported 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> . AUTHOR IGT Developers <igt-dev@lists.freedesktop.org> COPYRIGHT 2009,2011,2012,2016,2018,2019,2020 Intel Corporation igt-gpu-tools 1.26 2020-03-18 INTEL_GPU_TOP(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | RUNTIME CONTROL | DEVICE SELECTION | JSON OUTPUT | LIMITATIONS | REPORTING BUGS | AUTHOR | COPYRIGHT
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=intel_gpu_top&sektion=1&manpath=FreeBSD+Ports+14.3>