.\" Man page generated from reStructuredText.
.
.TH INTEL_GPU_TOP 1 "2016-03-01" "intel-gpu-tools 1.22" "General Commands Manual"
.SH NAME
intel_gpu_top \- Display a top-like summary of Intel GPU usage
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBintel_gpu_top\fP [\fIOPTIONS\fP]
.SH DESCRIPTION
.sp
\fBintel_gpu_top\fP is a tool to display usage information of an Intel GPU. It
requires root privilege to map the graphics device.
.SH OPTIONS
.INDENT 0.0
.TP
.BI \-s \ SAMPLES
Number of samples to acquire per second.
.TP
.BI \-o \ FILE
Collect usage statistics to FILE. If file is "\-", run non\-interactively
and output statistics to stdout.
.TP
.BI \-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.
.TP
.B \-h
Show usage notes.
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.TP
.B 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.
.UNINDENT
.sp
Note that idle units are not displayed, so an entirely idle GPU will only
display the ring status and header.
.SH BUGS
.sp
Some GPUs report some units as busy when they aren\(aqt, such that even when idle
and not hung, it will show up as 100% busy.
.SH REPORTING BUGS
.sp
Report bugs to \fI\%https://bugs.freedesktop.org\fP\&.
.SH AUTHOR
IGT Developers <igt-dev@lists.freedesktop.org>
.SH COPYRIGHT
2009,2011,2012,2016 Intel Corporation
.\" Generated by docutils manpage writer.
.