mirror of
https://github.com/tiagovignatti/intel-gpu-tools.git
synced 2025-06-10 09:26:10 +00:00
README: update the test run instructions
Describe using the new run-tests.sh script and also update the Piglit instructions now that using a symlink is no longer supported. Signed-off-by: Thomas Wood <thomas.wood@intel.com>
This commit is contained in:
parent
ee62ca48e7
commit
d3cfe28a1a
40
README
40
README
@ -24,13 +24,29 @@ tests/
|
||||
changes. Hopefully this can cover the relevant cases we need to
|
||||
worry about, including backwards compatibility.
|
||||
|
||||
Note: The old automake based testrunner had to be scraped due to
|
||||
upstream changes which broke dynamic creation of the test list. Of
|
||||
course it is still possible to directly run tests, even when not always
|
||||
limiting tests to specific subtests (like piglit does).
|
||||
The test suite can be run using the run-tests.sh script available in
|
||||
the scripts directory. Piglit is used to run the tests and can either
|
||||
be installed from your distribution (if available), or can be
|
||||
downloaded locally for use with the script by running:
|
||||
|
||||
The more comfortable way to run tests is with piglit. First grab piglit
|
||||
from:
|
||||
./scripts/run-tests.sh -d
|
||||
|
||||
run-tests.sh has options for filtering and excluding tests from test
|
||||
runs:
|
||||
|
||||
-t <regex> only include tests that match the regular expression
|
||||
-x <regex> exclude tests that match the regular expression
|
||||
|
||||
Useful patterns for test filtering are described in
|
||||
tests/NAMING-CONVENTION and the full list of tests and subtests can be
|
||||
produced by passing -l to the run-tests.sh script.
|
||||
|
||||
Results are written to a JSON file and an HTML summary can also be
|
||||
created by passing -s to the run-tests.sh script. Further options are
|
||||
are detailed by using the -h option.
|
||||
|
||||
|
||||
If not using the script, piglit can be obtained from:
|
||||
|
||||
git://anongit.freedesktop.org/piglit
|
||||
|
||||
@ -38,14 +54,12 @@ tests/
|
||||
used for running i-g-t tests.
|
||||
|
||||
Set the IGT_TEST_ROOT environment variable to point to the tests
|
||||
directory or link up the i-g-t sources with piglit using a symlink:
|
||||
directory, or set the path key in the "igt" section of piglit.conf to
|
||||
the intel-gpu-tools root directory.
|
||||
|
||||
piglit-sources $ cd bin
|
||||
piglit-sources/bin $ ln $i-g-t-sources igt -s
|
||||
|
||||
In both cases, 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):
|
||||
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 igt <results-file>
|
||||
|
||||
|
Loading…
x
Reference in New Issue
Block a user