.\" Man page generated from reStructuredText.
.
.TH INTEL_GPU_TOP 1 "2019-02-08" "igt-gpu-tools 1.25" "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 on Intel GPU\(aqs.
.sp
The tool gathers data using perf performance counters (PMU) exposed by i915 and other platform drivers like RAPL (power) and Uncore IMC (memory bandwidth).
.SH OPTIONS
.INDENT 0.0
.TP
.B \-h
Show help text.
.TP
.B \-J
Output JSON formatted data.
.TP
.B \-l
List plain text data.
.TP
.BI \-o \ <file path | \->
Output to the specified file instead of standard output.
\(aq\-\(aq can also be specified to explicitly select standard output.
.TP
.BI \-s \ <ms>
Refresh period in milliseconds.
.UNINDENT
.SH LIMITATIONS
.INDENT 0.0
.IP \(bu 2
Not all metrics are supported on all platforms. Where a metric is unsupported it\(aqs value will be replaced by a dashed line.
.IP \(bu 2
Non\-root access to perf counters is controlled by the \fIperf_event_paranoid\fP sysctl.
.UNINDENT
.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,2018,2019 Intel Corporation
.\" Generated by docutils manpage writer.
.