Skip to contentSkip to conversation

docs: split the test program documentation into sections

PATCH New Thomas Wood 1 participant 6 messages Nov 28, 2014

lore
Share & tools
lore
#0 lore raw

PATCH 1/6 docs: split the test program documentation into sections

---
 docs/reference/intel-gpu-tools/.gitignore          |   2 +-
 docs/reference/intel-gpu-tools/Makefile.am         |  77 +++++++++--
 .../intel-gpu-tools/igt_test_programs.xml          | 151 +++++++++++++++++++++
 .../intel-gpu-tools/igt_test_programs.xml.header   |  65 ---------
 .../intel-gpu-tools/intel-gpu-tools-docs.xml       |   5 +-
 5 files changed, 217 insertions(+), 83 deletions(-)
 create mode 100644 docs/reference/intel-gpu-tools/igt_test_programs.xml
 delete mode 100644 docs/reference/intel-gpu-tools/igt_test_programs.xml.header
docs/reference/intel-gpu-tools/.gitignore +1 -1
index 303929b..00c1b02 100644
@@ -3,7 +3,7 @@
 /html-build.stamp
 /html.stamp
 /html/
-/igt_test_programs.xml
+/igt_test_programs_*.xml
 /intel-gpu-tools-decl-list.txt
 /intel-gpu-tools-decl.txt
 /intel-gpu-tools-overrides.txt
docs/reference/intel-gpu-tools/Makefile.am +63 -14

107 lines not on this page · raw message

docs/reference/intel-gpu-tools/igt_test_programs.xml new file +151 -0

151 lines not on this page · raw message

docs/reference/intel-gpu-tools/igt_test_programs.xml.header deleted +0 -65

65 lines not on this page · raw message

docs/reference/intel-gpu-tools/intel-gpu-tools-docs.xml +2 -3
index 07ced05..2115097 100644
@@ -14,7 +14,7 @@
   </bookinfo>
 
   <chapter>
-    <title>Intel GPU Tools</title>
+    <title>API Reference</title>
     <xi:include href="xml/drmtest.xml"/>
     <xi:include href="xml/igt_core.xml"/>
     <xi:include href="xml/igt_debugfs.xml"/>
@@ -25,10 +25,9 @@
     <xi:include href="xml/intel_batchbuffer.xml"/>
     <xi:include href="xml/intel_chipset.xml"/>
     <xi:include href="xml/intel_io.xml"/>
-    <xi:include href="xml/igt_test_programs.xml"/>
     <xi:include href="xml/igt_edid.xml"/>
-
   </chapter>
+  <xi:include href="xml/igt_test_programs.xml"/>
   <index id="api-index-full">
     <title>API Index</title>
     <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
Signature · 6 lines
2.1.0

_______________________________________________
Intel-gfx mailing list
[email protected]
http://lists.freedesktop.org/mailman/listinfo/intel-gfx
#1 lore raw

PATCH 2/6 docs: add subtest lists to test descriptions

---
 docs/reference/intel-gpu-tools/Makefile.am | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)
docs/reference/intel-gpu-tools/Makefile.am +10 -1
index cd9c771..d7ef4df 100644
@@ -39,7 +39,16 @@ xml/igt_test_programs_%_description.xml: $(TESTLISTS)
 			testprog=$(top_srcdir)/tests/$$test; \
 		fi; \
 		 ./$$testprog --help-description >> $@; \
-		echo "</para></refsect2>" >> $@; \
+		echo "</para>" >> $@; \
+		if ./$$testprog --list-subtests > /dev/null ; then \
+			echo "<refsect3><title>Subtests</title>" >> $@; \
+			echo "<simplelist>" >> $@; \
+			for subtest in `./$$testprog --list-subtests`; do \
+				echo "<member>$$subtest</member>" >> $@; \
+			done; \
+			echo "</simplelist></refsect3>" >> $@; \
+		fi; \
+		echo "</refsect2>" >> $@; \
 	done;
 	echo "</refsect1>" >> $@
 
Signature · 6 lines
2.1.0

_______________________________________________
Intel-gfx mailing list
[email protected]
http://lists.freedesktop.org/mailman/listinfo/intel-gfx
#2 lore raw

PATCH 3/6 docs: add exit status documentation

In reply to Thomas Wood
---
 .../intel-gpu-tools/igt_test_programs.xml          | 39 ++++++++++++++++++++++
 1 file changed, 39 insertions(+)
docs/reference/intel-gpu-tools/igt_test_programs.xml +39 -0
index 2969894..07285fe 100644
@@ -57,6 +57,45 @@
         </variablelist>
       </para>
     </refsect1>
+
+    <refsect1>
+      <title>Exit Status</title>
+      <para>
+      The following exit status codes are defined:
+
+      <informaltable pgwide="1" frame="none">
+        <tgroup cols="3" align="left">
+          <thead>
+            <row><entry>Name</entry><entry>Value</entry><entry>Description</entry></row>
+          </thead>
+          <tbody>
+            <row>
+              <entry>#IGT_EXIT_SUCCESS</entry>
+              <entry>0</entry>
+              <entry>The test was succesful</entry>
+            </row>
+            <row>
+              <entry>#IGT_EXIT_SKIP</entry>
+              <entry>77</entry>
+              <entry>The test was skipped</entry>
+            </row>
+            <row>
+              <entry>#IGT_EXIT_TIMEOUT</entry>
+              <entry>78</entry>
+              <entry>The test took longer than expected and was stopped</entry>
+            </row>
+            <row>
+              <entry>#IGT_EXIT_INVALID</entry>
+              <entry>79</entry>
+              <entry>An invalid option or subtest was specified</entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </informaltable>
+
+      Any other exit status indicates a test failure.
+    </para>
+    </refsect1>
   </refentry>
 
   <refentry id="igt-core-tests">
Signature · 6 lines
2.1.0

_______________________________________________
Intel-gfx mailing list
[email protected]
http://lists.freedesktop.org/mailman/listinfo/intel-gfx
#3 lore raw

PATCH 4/6 docs: add a glossary of test name terms

In reply to Thomas Wood

Add a glossary of test name terms based on the details in tests/NAMING-CONVENTION.

---
 docs/reference/intel-gpu-tools/Makefile.am         |  10 +-
 .../intel-gpu-tools/igt_test_programs.xml          | 106 +++++++++++++++++++++
 2 files changed, 114 insertions(+), 2 deletions(-)
docs/reference/intel-gpu-tools/Makefile.am +8 -2
index d7ef4df..53a6224 100644
@@ -1,6 +1,8 @@
 ## Process this file with automake to produce Makefile.in
 
 TESTLISTS = $(top_builddir)/tests/single-tests.txt $(top_builddir)/tests/multi-tests.txt
+KEYWORDS = (hang|swap|thrash|crc|tiled|tiling|normal|uncached|snoop|rte|ctx|exec|rpm)
+
 xml/igt_test_programs_%_programs.xml: $(TESTLISTS)
 	mkdir -p `dirname $@`
 	echo "<?xml version=\"1.0\"?>" > $@
@@ -32,7 +34,9 @@ xml/igt_test_programs_%_description.xml: $(TESTLISTS)
 	echo "<refsect1>" >> $@
 	echo "<title>Description</title>" >> $@
 	for test in `cat $(TESTLISTS) | tr ' ' '\n' | grep "^$*" | sort`; do \
-		echo "<refsect2 id=\"$$test\"><title>$$test</title><para>" >> $@; \
+		echo "<refsect2 id=\"$$test\"><title>" >> $@; \
+		echo "$$test" | perl -pe 's/(?<=_)$(KEYWORDS)(?=(_|\W))/<acronym>\1<\/acronym>/g' >> $@; \
+		echo "</title><para>" >> $@; \
 		if [ -x $(top_builddir)/tests/$$test ]; then \
 			testprog=$(top_builddir)/tests/$$test; \
 		else \
@@ -44,7 +48,9 @@ xml/igt_test_programs_%_description.xml: $(TESTLISTS)
 			echo "<refsect3><title>Subtests</title>" >> $@; \
 			echo "<simplelist>" >> $@; \
 			for subtest in `./$$testprog --list-subtests`; do \
-				echo "<member>$$subtest</member>" >> $@; \
+				echo "<member>" >> $@; \
+				echo "$$subtest" | perl -pe 's/\b$(KEYWORDS)\b/<acronym>\1<\/acronym>/g' >> $@; \
+				echo "</member>" >> $@; \
 			done; \
 			echo "</simplelist></refsect3>" >> $@; \
 		fi; \
docs/reference/intel-gpu-tools/igt_test_programs.xml +106 -0

110 lines not on this page · raw message

Signature · 6 lines
2.1.0

_______________________________________________
Intel-gfx mailing list
[email protected]
http://lists.freedesktop.org/mailman/listinfo/intel-gfx
#4 lore raw

PATCH 5/6 docs: treat the test description as cdata

In reply to Thomas Wood

Enclose the test description in cdata tags since the test descriptions come from the tests themselves and may not be escaped for use in xml.

---
 docs/reference/intel-gpu-tools/Makefile.am | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
docs/reference/intel-gpu-tools/Makefile.am +2 -2
index 53a6224..898abc9 100644
@@ -36,14 +36,14 @@ xml/igt_test_programs_%_description.xml: $(TESTLISTS)
 	for test in `cat $(TESTLISTS) | tr ' ' '\n' | grep "^$*" | sort`; do \
 		echo "<refsect2 id=\"$$test\"><title>" >> $@; \
 		echo "$$test" | perl -pe 's/(?<=_)$(KEYWORDS)(?=(_|\W))/<acronym>\1<\/acronym>/g' >> $@; \
-		echo "</title><para>" >> $@; \
+		echo "</title><para><![CDATA[" >> $@; \
 		if [ -x $(top_builddir)/tests/$$test ]; then \
 			testprog=$(top_builddir)/tests/$$test; \
 		else \
 			testprog=$(top_srcdir)/tests/$$test; \
 		fi; \
 		 ./$$testprog --help-description >> $@; \
-		echo "</para>" >> $@; \
+		echo "]]></para>" >> $@; \
 		if ./$$testprog --list-subtests > /dev/null ; then \
 			echo "<refsect3><title>Subtests</title>" >> $@; \
 			echo "<simplelist>" >> $@; \
Signature · 6 lines
2.1.0

_______________________________________________
Intel-gfx mailing list
[email protected]
http://lists.freedesktop.org/mailman/listinfo/intel-gfx
#5 lore raw

PATCH 6/6 tests: add more test descriptions

In reply to Thomas Wood

Add more test descriptions based on exiting comments.

---
 tests/drm_vma_limiter.c                | 2 ++
 tests/gem_bad_length.c                 | 4 +++-
 tests/gem_bad_reloc.c                  | 3 +++
 tests/gem_caching.c                    | 3 +++
 tests/gem_concurrent_blit.c            | 3 +++
 tests/gem_cpu_reloc.c                  | 2 ++
 tests/gem_cs_prefetch.c                | 2 ++
 tests/gem_cs_tlb.c                     | 2 ++
 tests/gem_ctx_bad_destroy.c            | 2 ++
 tests/gem_ctx_bad_exec.c               | 3 +++
 tests/gem_ctx_basic.c                  | 2 ++
 tests/gem_ctx_exec.c                   | 2 ++
 tests/gem_double_irq_loop.c            | 2 ++
 tests/gem_dummy_reloc_loop.c           | 1 +
 tests/gem_evict_alignment.c            | 3 +++
 tests/gem_evict_everything.c           | 3 +++
 tests/gem_exec_bad_domains.c           | 3 +++
 tests/gem_exec_big.c                   | 3 +++
 tests/gem_exec_faulting_reloc.c        | 3 +++
 tests/gem_exec_lut_handle.c            | 5 ++++-
 tests/gem_fenced_exec_thrash.c         | 2 ++
 tests/gem_flink_race.c                 | 2 ++
 tests/gem_gtt_cpu_tlb.c                | 3 +++
 tests/gem_hangcheck_forcewake.c        | 3 +++
 tests/gem_linear_blits.c               | 3 +++
 tests/gem_lut_handle.c                 | 5 ++++-
 tests/gem_madvise.c                    | 3 +++
 tests/gem_media_fill.c                 | 3 +++
 tests/gem_mmap_offset_exhaustion.c     | 3 +++
 tests/gem_multi_bsd_sync_loop.c        | 2 ++
 tests/gem_non_secure_batch.c           | 2 ++
 tests/gem_partial_pwrite_pread.c       | 3 +++
 tests/gem_persistent_relocs.c          | 2 ++
 tests/gem_pin.c                        | 2 ++
 tests/gem_pipe_control_store_loop.c    | 2 ++
 tests/gem_pread_after_blit.c           | 3 +++
 tests/gem_reloc_overflow.c             | 2 ++
 tests/gem_reloc_vs_gpu.c               | 2 ++
 tests/gem_render_copy.c                | 2 ++
 tests/gem_render_copy_redux.c          | 2 ++
 tests/gem_ring_sync_copy.c             | 2 ++
 tests/gem_ring_sync_loop.c             | 2 ++
 tests/gem_seqno_wrap.c                 | 3 +++
 tests/gem_set_tiling_vs_blt.c          | 3 +++
 tests/gem_set_tiling_vs_gtt.c          | 2 ++
 tests/gem_set_tiling_vs_pwrite.c       | 2 ++
 tests/gem_storedw_loop_blt.c           | 2 ++
 tests/gem_storedw_loop_bsd.c           | 2 ++
 tests/gem_storedw_loop_render.c        | 2 ++
 tests/gem_storedw_loop_vebox.c         | 2 ++
 tests/gem_stress.c                     | 2 ++
 tests/gem_threaded_access_tiled.c      | 2 ++
 tests/gem_tiled_blits.c                | 3 +++
 tests/gem_tiled_partial_pwrite_pread.c | 3 +++
 tests/gem_tiled_pread.c                | 4 ++++
 tests/gem_tiled_pread_pwrite.c         | 5 ++++-
 tests/gem_tiled_swapping.c             | 2 ++
 tests/gem_tiled_wb.c                   | 4 ++++
 tests/gem_tiling_max_stride.c          | 2 ++
 tests/gem_unfence_active_buffers.c     | 2 ++
 tests/gem_unref_active_buffers.c       | 2 ++
 tests/gem_write_read_ring_switch.c     | 2 ++
 tests/gen7_forcewake_mt.c              | 3 +++
 tests/kms_flip_tiling.c                | 3 +++
 tests/kms_force_connector.c            | 3 +++
 tests/prime_self_import.c              | 3 +++
 66 files changed, 167 insertions(+), 4 deletions(-)
tests/drm_vma_limiter.c +2 -0
index e1381fe..bb7102f 100644
@@ -50,6 +50,8 @@ struct intel_batchbuffer *batch;
  * this checks whether they actually work.
  */
 
+IGT_TEST_DESCRIPTION("Check whether the libdrm vma limiter works.");
+
 /* we do both cpu and gtt maps, so only need half of 64k to exhaust */
 #define BO_ARRAY_SIZE 35000
 drm_intel_bo *bos[BO_ARRAY_SIZE];
tests/gem_bad_length.c +3 -1
index 11cc197..29b3925 100644
@@ -38,8 +38,10 @@
 #include "ioctl_wrappers.h"
 #include "drmtest.h"
 
+IGT_TEST_DESCRIPTION("Test minimal bo_create and batchbuffer exec.");
+
 /*
- * Testcase: Minmal bo_create and batchbuffer exec
+ * Testcase: Minimal bo_create and batchbuffer exec
  *
  * Originally this caught an kernel oops due to the unchecked assumption that
  * objects have size > 0.
tests/gem_bad_reloc.c +3 -0
index df0100f..cf1f2fa 100644
@@ -42,6 +42,9 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Simulates SNA behaviour using negative self-relocations"
+		     " for STATE_BASE_ADDRESS command packets.");
+
 #define USE_LUT (1 << 12)
 
 /* Simulates SNA behaviour using negative self-relocations for
tests/gem_caching.c +3 -0
index b7f4bfb..2fad0ec 100644
@@ -45,6 +45,9 @@
 #include "intel_chipset.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test snoop consistency when touching partial"
+		     " cachelines.");
+
 /*
  * Testcase: snoop consistency when touching partial cachelines
  *
tests/gem_concurrent_blit.c +3 -0
index 7d8d628..4ce5ef0 100644
@@ -55,6 +55,9 @@
 #include "intel_chipset.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test of pread/pwrite behavior when writing to active"
+		     " buffers.");
+
 int fd, devid, gen;
 struct intel_batchbuffer *batch;
 
tests/gem_cpu_reloc.c +2 -0
index 1413ebf..c67907a 100644
@@ -64,6 +64,8 @@
 #include "intel_chipset.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test the relocations through the CPU domain.");
+
 static uint32_t use_blt;
 
 static void copy(int fd, uint32_t batch, uint32_t src, uint32_t dst)
tests/gem_cs_prefetch.c +2 -0
index e64b224..700883c 100644
@@ -54,6 +54,8 @@
 #include "intel_chipset.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test the CS prefetch behaviour on batches.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 
tests/gem_cs_tlb.c +2 -0
index c203e31..5b8b993 100644
@@ -54,6 +54,8 @@
 #include "intel_io.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Check whether we correctly invalidate the cs tlb.");
+
 #define LOCAL_I915_EXEC_VEBOX (4<<0)
 #define BATCH_SIZE (1024*1024)
 
tests/gem_ctx_bad_destroy.c +2 -0
index 7709131..d848265 100644
@@ -36,6 +36,8 @@
 #include "ioctl_wrappers.h"
 #include "drmtest.h"
 
+IGT_TEST_DESCRIPTION("Negative test cases for destroy contexts.");
+
 struct local_drm_i915_context_destroy {
 	__u32 ctx_id;
 	__u32 pad;
tests/gem_ctx_bad_exec.c +3 -0
index f0bb0fc..36afd7d 100644
@@ -45,6 +45,9 @@
 #include "ioctl_wrappers.h"
 #include "drmtest.h"
 
+IGT_TEST_DESCRIPTION("Test that context cannot be submitted to unsupported"
+		     " rings.");
+
 /* Copied from gem_exec_nop.c */
 static int exec(int fd, uint32_t handle, int ring, int ctx_id)
 {
tests/gem_ctx_basic.c +2 -0
index b8b01c0..2d866b3 100644
@@ -47,6 +47,8 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Basic test for memory and refcount leaks.");
+
 /* options */
 int num_contexts = 10;
 int uncontexted = 0; /* test only context create/destroy */
tests/gem_ctx_exec.c +2 -0
index da7412c..7a6ed9b 100644
@@ -48,6 +48,8 @@
 #include "igt_aux.h"
 #include "igt_debugfs.h"
 
+IGT_TEST_DESCRIPTION("Test basic context switch functionality.");
+
 struct local_drm_i915_gem_context_destroy {
 	__u32 ctx_id;
 	__u32 pad;
tests/gem_double_irq_loop.c +2 -0
index f9dab7c..a43fd1a 100644
@@ -53,6 +53,8 @@ static drm_intel_bo *target_buffer, *blt_bo;
  * on the second batch. This hopefully catches races in our irq acknowledgement.
  */
 
+IGT_TEST_DESCRIPTION("Basic check for missed IRQs on blt ring.");
+
 
 #define MI_COND_BATCH_BUFFER_END	(0x36<<23 | 1)
 #define MI_DO_COMPARE			(1<<21)
tests/gem_dummy_reloc_loop.c +1 -0
index 7a97140..335700d 100644
@@ -62,6 +62,7 @@ static drm_intel_bo *mbuffer[NUM_FD];
  * at hitting the missed irq bug that's worked around with the HWSTAM irq write.
  */
 
+IGT_TEST_DESCRIPTION("Check ring<->cpu sync using a dummy reloc.");
 
 #define MI_COND_BATCH_BUFFER_END	(0x36<<23 | 1)
 #define MI_DO_COMPARE			(1<<21)
tests/gem_evict_alignment.c +3 -0
index 86676b0..43d39ed 100644
@@ -49,6 +49,9 @@
 #include "intel_chipset.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Run a couple of big batches to force the unbind on"
+		     " misalignment code.");
+
 #define HEIGHT 256
 #define WIDTH 1024
 
tests/gem_evict_everything.c +3 -0
index fae8903..f108da3 100644
@@ -48,6 +48,9 @@
 
 #include "eviction_common.c"
 
+IGT_TEST_DESCRIPTION("Run a couple of big batches to force the eviction"
+		     " code.");
+
 #define HEIGHT 256
 #define WIDTH 1024
 
tests/gem_exec_bad_domains.c +3 -0
index 9901281..818e585 100644
@@ -46,6 +46,9 @@
  * If it does not, it'll oops somewhen later on because we don't expect that.
  */
 
+IGT_TEST_DESCRIPTION("Test whether the kernel rejects relocations with non-gpu"
+		     " domains.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 
tests/gem_exec_big.c +3 -0
index b82774f..652c8f1 100644
@@ -47,6 +47,9 @@
 #include "ioctl_wrappers.h"
 #include "drmtest.h"
 
+IGT_TEST_DESCRIPTION("Run a large nop batch to stress test the error capture"
+		     " code.");
+
 #define BATCH_SIZE		(1024*1024)
 
 static void exec(int fd, uint32_t handle, uint32_t reloc_ofs)
tests/gem_exec_faulting_reloc.c +3 -0
index acd703b..9f12112 100644
@@ -48,6 +48,9 @@
  * To be really evil, use a gtt mmap for them.
  */
 
+IGT_TEST_DESCRIPTION("Submit patches with relocations in memory that will"
+		     " fault.");
+
 #define OBJECT_SIZE 16384
 
 #define COPY_BLT_CMD_NOLEN	(2<<29|0x53<<22)
tests/gem_exec_lut_handle.c +4 -1
index 6ee7527..c2d490f 100644
@@ -25,7 +25,7 @@
  *
  */
 
-/* Exercises the basic execbuffer using theh andle LUT interface */
+/* Exercises the basic execbuffer using the handle LUT interface */
 
 #include <stdlib.h>
 #include <stdio.h>
@@ -39,6 +39,9 @@
 #include "ioctl_wrappers.h"
 #include "drmtest.h"
 
+IGT_TEST_DESCRIPTION("Exercises the basic execbuffer using the handle LUT"
+		     " interface.");
+
 #define BATCH_SIZE		(1024*1024)
 
 #define LOCAL_I915_EXEC_NO_RELOC (1<<11)
tests/gem_fenced_exec_thrash.c +2 -0
index 85ead30..75f251c 100644
@@ -43,6 +43,8 @@
 #include "intel_io.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test execbuf fence accounting.");
+
 #define WIDTH 1024
 #define HEIGHT 1024
 #define OBJECT_SIZE (4*WIDTH*HEIGHT)
tests/gem_flink_race.c +2 -0
index a1dc85d..c2a5d81 100644
@@ -38,6 +38,8 @@
 #include "intel_bufmgr.h"
 #include "igt_debugfs.h"
 
+IGT_TEST_DESCRIPTION("Check for flink/open vs. gem close races.");
+
 /* Testcase: check for flink/open vs. gem close races
  *
  * The gem flink open ioctl had a little race with gem close which could result
tests/gem_gtt_cpu_tlb.c +3 -0
index 953070c..a019061 100644
@@ -44,6 +44,9 @@
 #include "drmtest.h"
 #include "intel_io.h"
 
+IGT_TEST_DESCRIPTION("Check whether gtt tlbs for cpu access are correctly"
+		     " invalidated.");
+
 #define OBJ_SIZE (1024*1024)
 
 #define PAGE_SIZE 4096
tests/gem_hangcheck_forcewake.c +3 -0
index ec74c51..f274fab 100644
@@ -41,6 +41,9 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Provoke the hangcheck timer on an otherwise idle"
+		     " system.");
+
 /*
  * Testcase: Provoke the hangcheck timer on an otherwise idle system
  *
tests/gem_linear_blits.c +3 -0
index cbd1156..13c2ab7 100644
@@ -50,6 +50,9 @@
 #include "intel_io.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test doing many blits with a working set larger than the"
+		     " aperture size.");
+
 #define WIDTH 512
 #define HEIGHT 512
 
tests/gem_lut_handle.c +4 -1
index d3f6f73..7fc72f1 100644
@@ -25,7 +25,7 @@
  *
  */
 
-/* Exercises the basic execbuffer using theh andle LUT interface */
+/* Exercises the basic execbuffer using the handle LUT interface */
 
 #include <stdlib.h>
 #include <stdio.h>
@@ -39,6 +39,9 @@
 #include "ioctl_wrappers.h"
 #include "drmtest.h"
 
+IGT_TEST_DESCRIPTION("Exercises the basic execbuffer using the handle LUT"
+		     " interface.");
+
 #define BATCH_SIZE		(1024*1024)
 
 #define LOCAL_I915_EXEC_HANDLE_LUT (1<<12)
tests/gem_madvise.c +3 -0
index f95fbda..58ab629 100644
@@ -39,6 +39,9 @@
 #include "ioctl_wrappers.h"
 #include "drmtest.h"
 
+IGT_TEST_DESCRIPTION("Checks that the kernel reports EFAULT when trying to use"
+		     " purged bo.");
+
 #define OBJECT_SIZE (1024*1024)
 
 /* Testcase: checks that the kernel reports EFAULT when trying to use purged bo
tests/gem_media_fill.c +3 -0
index b06a556..a3c53e2 100644
@@ -49,6 +49,9 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Basic test for the media_fill() function, a very simple"
+		     " workload for the Media pipeline.");
+
 #define WIDTH 64
 #define STRIDE (WIDTH)
 #define HEIGHT 64
tests/gem_mmap_offset_exhaustion.c +3 -0
index 914fe6e..b031050 100644
@@ -38,6 +38,9 @@
 #include "ioctl_wrappers.h"
 #include "drmtest.h"
 
+IGT_TEST_DESCRIPTION("Checks whether the kernel handles mmap offset exhaustion"
+		     " correctly.");
+
 #define OBJECT_SIZE (1024*1024)
 
 /* Testcase: checks whether the kernel handles mmap offset exhaustion correctly
tests/gem_multi_bsd_sync_loop.c +2 -0
index dec738b..0766eb6 100644
@@ -43,6 +43,8 @@
 #include "i830_reg.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Basic check of ring<->ring sync using a dummy reloc.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 static drm_intel_bo *target_buffer;
tests/gem_non_secure_batch.c +2 -0
index a1e875d..d00ce45 100644
@@ -42,6 +42,8 @@
 #include "intel_io.h"
 #include "i830_reg.h"
 
+IGT_TEST_DESCRIPTION("Basic check of non-secure batches.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 
tests/gem_partial_pwrite_pread.c +3 -0
index b9ffeec..0be749c 100644
@@ -42,6 +42,9 @@
 #include "intel_io.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test pwrite/pread consistency when touching partial"
+		     " cachelines.");
+
 /*
  * Testcase: pwrite/pread consistency when touching partial cachelines
  *
tests/gem_persistent_relocs.c +2 -0
index 585eda8..cab52a8 100644
@@ -46,6 +46,8 @@
 #include "igt_debugfs.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test persistent relocations as used by uxa/libva.");
+
 /*
  * Testcase: Persistent relocations as used by uxa/libva
  *
tests/gem_pin.c +2 -0
index 91e1456..b35496e 100644
@@ -44,6 +44,8 @@
 #include "intel_io.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Exercises pinning of small buffer objects.");
+
 #define COPY_BLT_CMD            (2<<29|0x53<<22|0x6)
 #define BLT_WRITE_ALPHA         (1<<21)
 #define BLT_WRITE_RGB           (1<<20)
tests/gem_pipe_control_store_loop.c +2 -0
index 86681f2..86ee405 100644
@@ -47,6 +47,8 @@
 #include "intel_chipset.h"
 #include "intel_io.h"
 
+IGT_TEST_DESCRIPTION("Test (TLB-)Coherency of pipe_control QW writes.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 uint32_t devid;
tests/gem_pread_after_blit.c +3 -0
index 0b8bfa6..a56e6fe 100644
@@ -51,6 +51,9 @@
 #include "intel_io.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test pread behavior when getting values out of"
+		     " just-drawn-to buffers.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 static const int width = 512, height = 512;
tests/gem_reloc_overflow.c +2 -0
index 06a315f..ea59171 100644
@@ -48,6 +48,8 @@
 #include "drmtest.h"
 #include "intel_io.h"
 
+IGT_TEST_DESCRIPTION("Check that kernel relocation overflows are caught.");
+
 /*
  * Testcase: Kernel relocation overflows are caught.
  */
tests/gem_reloc_vs_gpu.c +2 -0
index e249757..cc1b954 100644
@@ -46,6 +46,8 @@
 #include "igt_debugfs.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test kernel relocations vs. gpu races.");
+
 /*
  * Testcase: Kernel relocations vs. gpu races
  *
tests/gem_render_copy.c +2 -0
index 094816c..006b6f5 100644
@@ -52,6 +52,8 @@
 #include "intel_chipset.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Basic test for the render_copy() function.");
+
 #define WIDTH 512
 #define STRIDE (WIDTH*4)
 #define HEIGHT 512
tests/gem_render_copy_redux.c +2 -0
index 6fc82df..43d4c5a 100644
@@ -54,6 +54,8 @@
 #include "intel_chipset.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Advanced test for the render_copy() function.");
+
 #define WIDTH 512
 #define STRIDE (WIDTH*4)
 #define HEIGHT 512
tests/gem_ring_sync_copy.c +2 -0
index 4a732d2..16b4edf 100644
@@ -55,6 +55,8 @@
 #include "intel_batchbuffer.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Ensure inter-ring dependencies are respected.");
+
 #define WIDTH	512
 #define HEIGHT	512
 
tests/gem_ring_sync_loop.c +2 -0
index fc510e4..4b88530 100644
@@ -42,6 +42,8 @@
 #include "i830_reg.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Basic check of ring<->ring sync using a dummy reloc.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 static drm_intel_bo *target_buffer;
tests/gem_seqno_wrap.c +3 -0
index 51fd88c..be4ab3d 100644
@@ -51,6 +51,9 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Runs blitcopy -> rendercopy with multiple buffers over"
+		     " wrap boundary.");
+
 static int devid;
 static int card_index = 0;
 static uint32_t last_seqno = 0;
tests/gem_set_tiling_vs_blt.c +3 -0
index 4de325c..ab2f811 100644
@@ -61,6 +61,9 @@
 #include "intel_chipset.h"
 #include "intel_io.h"
 
+IGT_TEST_DESCRIPTION("Check for proper synchronization of tiling changes vs."
+		     " tiled gpu access.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 uint32_t devid;
tests/gem_set_tiling_vs_gtt.c +2 -0
index e0ef2b7..006f50a 100644
@@ -40,6 +40,8 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Check set_tiling vs gtt mmap coherency.");
+
 #define OBJECT_SIZE (1024*1024)
 #define TEST_STRIDE (1024*4)
 
tests/gem_set_tiling_vs_pwrite.c +2 -0
index cf5aaeb..a4bdc64 100644
@@ -39,6 +39,8 @@
 #include "drmtest.h"
 #include "intel_io.h"
 
+IGT_TEST_DESCRIPTION("Check set_tiling vs pwrite coherency.");
+
 #define OBJECT_SIZE (1024*1024)
 #define TEST_STRIDE (1024*4)
 
tests/gem_storedw_loop_blt.c +2 -0
index 43750cc..44e46a8 100644
@@ -42,6 +42,8 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Basic blitter MI check using MI_STORE_DATA_IMM.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 static drm_intel_bo *target_buffer;
tests/gem_storedw_loop_bsd.c +2 -0
index d5451be..e534c16 100644
@@ -42,6 +42,8 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Basic bsd MI check using MI_STORE_DATA_IMM.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 static drm_intel_bo *target_buffer;
tests/gem_storedw_loop_render.c +2 -0
index e1d3dad..48fb6d4 100644
@@ -42,6 +42,8 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Basic render MI check using MI_STORE_DATA_IMM.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 static drm_intel_bo *target_buffer;
tests/gem_storedw_loop_vebox.c +2 -0
index 5e5536f..8643dd3 100644
@@ -41,6 +41,8 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Basic vebox MI check using MI_STORE_DATA_IMM.");
+
 #define LOCAL_I915_EXEC_VEBOX (4<<0)
 
 static drm_intel_bufmgr *bufmgr;
tests/gem_stress.c +2 -0
index ab2cd0e..6e3a64c 100644
@@ -69,6 +69,8 @@
 #include "intel_chipset.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("General gem coherency test.");
+
 #define CMD_POLY_STIPPLE_OFFSET       0x7906
 
 #define DUCTAPE 0xdead0001
tests/gem_threaded_access_tiled.c +2 -0
index 3752a1f..3a5921f 100644
@@ -34,6 +34,8 @@
 #include "ioctl_wrappers.h"
 #include "intel_bufmgr.h"
 
+IGT_TEST_DESCRIPTION("Check parallel access to tiled memory.");
+
 /* Testcase: check parallel access to tiled memory
  *
  * Parallel access to tiled memory caused sigbus
tests/gem_tiled_blits.c +3 -0
index 0f88328..3fceb81 100644
@@ -58,6 +58,9 @@
 #include "intel_io.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test doing many tiled blits, with a working set larger"
+		     " than the aperture size.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 static int width = 512, height = 512;
tests/gem_tiled_partial_pwrite_pread.c +3 -0
index cf8f48d..8dea82e 100644
@@ -42,6 +42,9 @@
 #include "intel_io.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test pwrite/pread consistency when touching partial"
+		     " cachelines.");
+
 /*
  * Testcase: pwrite/pread consistency when touching partial cachelines
  *
tests/gem_tiled_pread.c +4 -0
index d99b4ea..fdc5173 100644
@@ -50,6 +50,10 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+
+IGT_TEST_DESCRIPTION("Test pread behavior on tiled objects with respect to the"
+		     " reported swizzling value.");
+
 #define WIDTH 512
 #define HEIGHT 512
 static uint32_t linear[WIDTH * HEIGHT];
tests/gem_tiled_pread_pwrite.c +4 -1
index 5ab4678..3d8fdc9 100644
@@ -36,7 +36,7 @@
  */
 
 /*
- * Testcase: Test swizzling by testing pwrite does the invers of pread
+ * Testcase: Test swizzling by testing pwrite does the inverse of pread
  *
  * Together with the explicit pread testcase, this should cover our swizzle
  * handling.
@@ -61,6 +61,9 @@
 #include "intel_io.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Test swizzling by testing pwrite does the inverse of"
+		     " pread.");
+
 #define WIDTH 512
 #define HEIGHT 512
 static uint32_t linear[WIDTH * HEIGHT];
tests/gem_tiled_swapping.c +2 -0
index 11bb245..3fac52f 100644
@@ -62,6 +62,8 @@
 #include "intel_io.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Exercise swizzle code for swapping.");
+
 #define WIDTH 512
 #define HEIGHT 512
 #define LINEAR_DWORDS (4 * WIDTH * HEIGHT)
tests/gem_tiled_wb.c +4 -0
index fdf79e3..b6efd6e 100644
@@ -47,6 +47,10 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("This is a test of write-combining mmap's behavior on"
+		     " tiled objects with respect to the reported swizzling"
+		     " value.");
+
 #define WIDTH 512
 #define HEIGHT 512
 #define SIZE (WIDTH*HEIGHT*sizeof(uint32_t))
tests/gem_tiling_max_stride.c +2 -0
index 4d0553d..fce1ac7 100644
@@ -41,6 +41,8 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Check that max fence stride works.");
+
 static void do_test_invalid_tiling(int fd, uint32_t handle, int tiling, int stride)
 {
 	igt_assert(__gem_set_tiling(fd, handle, tiling, tiling ? stride : 0) == -EINVAL);
tests/gem_unfence_active_buffers.c +2 -0
index fffe3a7..125568e 100644
@@ -55,6 +55,8 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Check for use-after-free in the fence stealing code.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 uint32_t devid;
tests/gem_unref_active_buffers.c +2 -0
index 7a1bc93..8c8efaa 100644
@@ -48,6 +48,8 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Test unreferencing of active buffers.");
+
 static drm_intel_bufmgr *bufmgr;
 struct intel_batchbuffer *batch;
 static drm_intel_bo *load_bo;
tests/gem_write_read_ring_switch.c +2 -0
index f3407f9..da579da 100644
@@ -43,6 +43,8 @@
 #include "i830_reg.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Check read/write syncpoints when switching rings.");
+
 #define LOCAL_I915_EXEC_VEBOX (4<<0)
 
 static drm_intel_bufmgr *bufmgr;
tests/gen7_forcewake_mt.c +3 -0
index e974807..01299c5 100644
@@ -41,6 +41,9 @@
 #include "intel_io.h"
 #include "intel_chipset.h"
 
+IGT_TEST_DESCRIPTION("Exercise a suspect workaround required for"
+		     " FORCEWAKE_MT.");
+
 #define FORCEWAKE_MT 0xa188
 
 struct thread {
tests/kms_flip_tiling.c +3 -0
index 5c67398..9bc085b 100644
@@ -34,6 +34,9 @@
 #include "igt_kms.h"
 #include "ioctl_wrappers.h"
 
+IGT_TEST_DESCRIPTION("Test that a page flip from a tiled buffer to a linear"
+		     " one works correctly.");
+
 typedef struct {
 	int drm_fd;
 	igt_display_t display;
tests/kms_force_connector.c +3 -0
index 34c33b0..d481dbf 100644
@@ -27,6 +27,9 @@
 #include "drmtest.h"
 #include "igt_edid.h"
 
+IGT_TEST_DESCRIPTION("Check the debugfs force connector/edid features work"
+		     " correctly.");
+
 int
 main (int argc, char **argv)
 {
tests/prime_self_import.c +3 -0
index dd9c293..9cb0780 100644
@@ -48,6 +48,9 @@
 #include "drmtest.h"
 #include "igt_debugfs.h"
 
+IGT_TEST_DESCRIPTION("Check whether prime import/export works on the same"
+		     " device.");
+
 #define BO_SIZE (16*1024)
 
 static char counter;
Signature · 6 lines
2.1.0

_______________________________________________
Intel-gfx mailing list
[email protected]
http://lists.freedesktop.org/mailman/listinfo/intel-gfx