mirror of
https://github.com/tiagovignatti/intel-gpu-tools.git
synced 2025-06-08 16:36:14 +00:00
62c542fd4e
This allows intel_gpu_top to run both in statistics-collecting mode (collecting the per-ring statistics in gnuplot-friendly format) and ncurses top-like mode at the same time. It also allows to output the statistics directly to stdout, by using "-o -", so the results can be parsed directly via a popen() parsing. If you are using intel_gpu_top as previously (without any command-line arguments), it should change nothing for you. If you were using its logging facilities (e.g., the '-o file'), note that the logging will keep running, but the detailed top-like interface will be on the screen at the same time. Signed-off-by: Eugeni Dodonov <eugeni.dodonov@intel.com>
42 lines
1.3 KiB
Groff
42 lines
1.3 KiB
Groff
.\" shorthand for double quote that works everywhere.
|
|
.ds q \N'34'
|
|
.TH intel_gpu_top 1 "intel_gpu_top 1.0"
|
|
.SH NAME
|
|
intel_gpu_top \- Display a top-like summary of Intel GPU usage
|
|
.SH SYNOPSIS
|
|
.nf
|
|
.B intel_gpu_top
|
|
.B intel_gpu_top [ parameters ]
|
|
.SH DESCRIPTION
|
|
.B intel_gpu_top
|
|
is a tool to display usage information of an Intel GPU. It requires root
|
|
privilege to map the graphics device.
|
|
.SS Options
|
|
.TP
|
|
.B -s [samples per second]
|
|
number of samples to acquire per second
|
|
.TP
|
|
.B -o [output file]
|
|
collect usage statistics to [file]. If file is "-", run non-interactively
|
|
and output statistics to stdout.
|
|
.TP
|
|
.B -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.
|
|
.TP
|
|
.B -h
|
|
show usage notes
|
|
.SH EXAMPLES
|
|
.TP
|
|
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.
|
|
.PP
|
|
Note that idle units are not
|
|
displayed, so an entirely idle GPU will only display the ring status and
|
|
header.
|
|
.SH 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.
|