mirror of
https://github.com/tiagovignatti/intel-gpu-tools.git
synced 2025-06-10 17:36:11 +00:00
This patch adds support for non-interactive mode, invoked by running with '-o output' switch. In this case, no interactive output is being performed, but the execution statistics are being saved into the output file. The output file is generated in both human and gnuplot-readable format. Unlike interactive mode, where non-supported pipes and non-active registers are skipped, the content of such pipes and registers is recorded into the log file to simplify parsing and standardize the list of columns. Also, unlike interactive mode, the registers are not sorted according to the usage - this way, their variation over time can be analysed offline. Signed-off-by: Eugeni Dodonov <eugeni.dodonov@intel.com>
31 lines
831 B
Groff
31 lines
831 B
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]
|
|
run non-interactively and collect usage statistics to [file]
|
|
.TP
|
|
.B -h
|
|
show usage notes
|
|
.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.
|