summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Makefile.am2
-rw-r--r--configure.ac1
-rw-r--r--man/Makefile.am8
-rw-r--r--man/intel_gpu_dump.122
-rw-r--r--man/intel_gpu_top.118
-rw-r--r--man/intel_stepping.115
-rw-r--r--man/intel_upload_blit_large.118
-rw-r--r--man/intel_upload_blit_large_gtt.118
-rw-r--r--man/intel_upload_blit_large_map.118
-rw-r--r--man/intel_upload_blit_small.118
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.