diff options
| -rw-r--r-- | Makefile.am | 2 | ||||
| -rw-r--r-- | configure.ac | 1 | ||||
| -rw-r--r-- | man/Makefile.am | 8 | ||||
| -rw-r--r-- | man/intel_gpu_dump.1 | 22 | ||||
| -rw-r--r-- | man/intel_gpu_top.1 | 18 | ||||
| -rw-r--r-- | man/intel_stepping.1 | 15 | ||||
| -rw-r--r-- | man/intel_upload_blit_large.1 | 18 | ||||
| -rw-r--r-- | man/intel_upload_blit_large_gtt.1 | 18 | ||||
| -rw-r--r-- | man/intel_upload_blit_large_map.1 | 18 | ||||
| -rw-r--r-- | man/intel_upload_blit_small.1 | 18 |
10 files changed, 137 insertions, 1 deletions
diff --git a/Makefile.am b/Makefile.am index 2585393e..c9a7c2d1 100644 --- a/Makefile.am +++ b/Makefile.am @@ -22,7 +22,7 @@ AUTOMAKE_OPTIONS = foreign ACLOCAL_AMFLAGS = -I m4 -SUBDIRS = lib tests tools benchmarks +SUBDIRS = lib man tests tools benchmarks DISTCLEANFILES = \ doltcompile \ doltlibtool diff --git a/configure.ac b/configure.ac index eb746683..b9fb4687 100644 --- a/configure.ac +++ b/configure.ac @@ -67,6 +67,7 @@ AC_OUTPUT([ Makefile benchmarks/Makefile lib/Makefile + man/Makefile tests/Makefile tools/Makefile ]) diff --git a/man/Makefile.am b/man/Makefile.am new file mode 100644 index 00000000..df3aa96e --- /dev/null +++ b/man/Makefile.am @@ -0,0 +1,8 @@ +dist_man1_MANS = \ + intel_gpu_dump.1 \ + intel_gpu_top.1 \ + intel_stepping.1 \ + intel_upload_blit_large.1 \ + intel_upload_blit_large_gtt.1 \ + intel_upload_blit_large_map.1 \ + intel_upload_blit_small.1 diff --git a/man/intel_gpu_dump.1 b/man/intel_gpu_dump.1 new file mode 100644 index 00000000..74db20f6 --- /dev/null +++ b/man/intel_gpu_dump.1 @@ -0,0 +1,22 @@ +.\" shorthand for double quote that works everywhere. +.ds q \N'34' +.TH intel_gpu_dump 1 "intel_gpu_dump 1.0" +.SH NAME +intel_gpu_dump \- Print out debugging information on the state of the +Intel GPU. +.SH SYNOPSIS +.nf +.B intel_gpu_dump +.B intel_gpu_dump [ filename ] +.fi +.SH DESCRIPTION +.B intel_gpu_dump +is a tool to log the current state of an Intel GPU +when it is hung, for later analysis. It requires kernel 2.6.30rc1 or newer, +debugfs mounted on /sys/kernel/debug or /debug, and root privilege for +mapping the device to inspect it. +.SS Options +.TP +.B filename +Decodes just one batchbuffer or ringbuffer dump, rather than dumping all +of the GPU state. diff --git a/man/intel_gpu_top.1 b/man/intel_gpu_top.1 new file mode 100644 index 00000000..79c9c0eb --- /dev/null +++ b/man/intel_gpu_top.1 @@ -0,0 +1,18 @@ +.\" 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 +.B intel_gpu_top +.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. +.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. diff --git a/man/intel_stepping.1 b/man/intel_stepping.1 new file mode 100644 index 00000000..7221b495 --- /dev/null +++ b/man/intel_stepping.1 @@ -0,0 +1,15 @@ +.\" shorthand for double quote that works everywhere. +.ds q \N'34' +.TH intel_stepping 1 "intel_stepping 1.0" +.SH NAME +intel_stepping \- Display the stepping information for an Intel GPU +.SH SYNOPSIS +.B intel_stepping +.SH DESCRIPTION +.B intel_stepping +is a tool to print the stepping information for an Intel GPU, along with +the PCI ID and revision used to determine it. +It requires root privilege to map the graphics device. +.SH BUGS +Not all the known stepping IDs or chipsets are included, so the output +on some devices may not be as specific as possible. diff --git a/man/intel_upload_blit_large.1 b/man/intel_upload_blit_large.1 new file mode 100644 index 00000000..0f7e4aae --- /dev/null +++ b/man/intel_upload_blit_large.1 @@ -0,0 +1,18 @@ +.\" shorthand for double quote that works everywhere. +.ds q \N'34' +.TH intel_upload_blit_large 1 "intel_upload_blit_large 1.0" +.SH NAME +intel_upload_blit_large \- microbenchmark of Intel GPU performance +.SH SYNOPSIS +.nf +.B intel_upload_blit_large +.fi +.SH DESCRIPTION +.B intel_upload_blit_large +is a microbenchmark tool for DRM performance. It should be run with kernel +modesetting enabled, and may require root privilege for correct operation. +It does not require X to be running. +.PP +Given that it is a microbenchmark, its utility is largely for regression +testing of the kernel, and not for general conclusions on graphics +performance. diff --git a/man/intel_upload_blit_large_gtt.1 b/man/intel_upload_blit_large_gtt.1 new file mode 100644 index 00000000..289f8ff7 --- /dev/null +++ b/man/intel_upload_blit_large_gtt.1 @@ -0,0 +1,18 @@ +.\" shorthand for double quote that works everywhere. +.ds q \N'34' +.TH intel_upload_blit_large_gtt 1 "intel_upload_blit_large_gtt 1.0" +.SH NAME +intel_upload_blit_large_gtt \- microbenchmark of Intel GPU performance +.SH SYNOPSIS +.nf +.B intel_upload_blit_large_gtt +.fi +.SH DESCRIPTION +.B intel_upload_blit_large_gtt +is a microbenchmark tool for DRM performance. It should be run with kernel +modesetting enabled, and may require root privilege for correct operation. +It does not require X to be running. +.PP +Given that it is a microbenchmark, its utility is largely for regression +testing of the kernel, and not for general conclusions on graphics +performance. diff --git a/man/intel_upload_blit_large_map.1 b/man/intel_upload_blit_large_map.1 new file mode 100644 index 00000000..b558b85e --- /dev/null +++ b/man/intel_upload_blit_large_map.1 @@ -0,0 +1,18 @@ +.\" shorthand for double quote that works everywhere. +.ds q \N'34' +.TH intel_upload_blit_large_map 1 "intel_upload_blit_large_map 1.0" +.SH NAME +intel_upload_blit_large_map \- microbenchmark of Intel GPU performance +.SH SYNOPSIS +.nf +.B intel_upload_blit_large_map +.fi +.SH DESCRIPTION +.B intel_upload_blit_large_map +is a microbenchmark tool for DRM performance. It should be run with kernel +modesetting enabled, and may require root privilege for correct operation. +It does not require X to be running. +.PP +Given that it is a microbenchmark, its utility is largely for regression +testing of the kernel, and not for general conclusions on graphics +performance. diff --git a/man/intel_upload_blit_small.1 b/man/intel_upload_blit_small.1 new file mode 100644 index 00000000..d3773b55 --- /dev/null +++ b/man/intel_upload_blit_small.1 @@ -0,0 +1,18 @@ +.\" shorthand for double quote that works everywhere. +.ds q \N'34' +.TH intel_upload_blit_small 1 "intel_upload_blit_small 1.0" +.SH NAME +intel_upload_blit_small \- microbenchmark of Intel GPU performance +.SH SYNOPSIS +.nf +.B intel_upload_blit_small +.fi +.SH DESCRIPTION +.B intel_upload_blit_small +is a microbenchmark tool for DRM performance. It should be run with kernel +modesetting enabled, and may require root privilege for correct operation. +It does not require X to be running. +.PP +Given that it is a microbenchmark, its utility is largely for regression +testing of the kernel, and not for general conclusions on graphics +performance. |