README: add quick howto for using piglit as testrunner
authorDaniel Vetter <daniel.vetter@ffwll.ch>
Tue, 4 Dec 2012 09:34:46 +0000 (10:34 +0100)
committerDaniel Vetter <daniel.vetter@ffwll.ch>
Tue, 4 Dec 2012 09:35:21 +0000 (10:35 +0100)
README

diff --git a/README b/README
index 92da60b..789b8c2 100644 (file)
--- a/README
+++ b/README
@@ -36,6 +36,30 @@ tests/
          options to test different kms functionality, again read the source of
          the details.
 
+       The more comfortable way to run tests is with piglit. First grab piglit
+       from
+
+       git://anongit.freedesktop.org/piglit
+
+       and build it (no need to install anything). Then we need to link up the
+       i-g-t sources with piglit
+
+       piglit-sources $ cd bin
+       piglit-sources/bin $ ln $i-g-t-sources igt -s
+
+       The tests in the i-g-t sources need to have been built already. Then we
+       can run the testcases with (as usual as root, no other drm clients
+       running):
+
+       piglit-sources # ./piglit-run.py tests/igt.tests
+
+       The testlist is built at runtime, so no need to update anything in
+       piglit when adding new tests. See
+
+       piglit-sources $ ./piglit-run.py -h
+
+       for some useful options.
+
 lib/
        Common helper functions and headers used by the other tools.