mirror of
				https://github.com/tiagovignatti/intel-gpu-tools.git
				synced 2025-11-04 03:58:27 +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
 | 
						changes.  Hopefully this can cover the relevant cases we need to
 | 
				
			||||||
	worry about, including backwards compatibility.
 | 
						worry about, including backwards compatibility.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
	Note: The old automake based testrunner had to be scraped due to
 | 
						The test suite can be run using the run-tests.sh script available in
 | 
				
			||||||
	upstream changes which broke dynamic creation of the test list. Of
 | 
						the scripts directory. Piglit is used to run the tests and can either
 | 
				
			||||||
	course it is still possible to directly run tests, even when not always
 | 
						be installed from your distribution (if available), or can be
 | 
				
			||||||
	limiting tests to specific subtests (like piglit does).
 | 
						downloaded locally for use with the script by running:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
	The more comfortable way to run tests is with piglit. First grab piglit
 | 
						./scripts/run-tests.sh -d
 | 
				
			||||||
	from:
 | 
					
 | 
				
			||||||
 | 
						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
 | 
						git://anongit.freedesktop.org/piglit
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@ -38,14 +54,12 @@ tests/
 | 
				
			|||||||
	used for running i-g-t tests.
 | 
						used for running i-g-t tests.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
	Set the IGT_TEST_ROOT environment variable to point to the 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
 | 
						The tests in the i-g-t sources need to have been built already. Then we
 | 
				
			||||||
	piglit-sources/bin $ ln $i-g-t-sources igt -s
 | 
						can run the testcases with (as usual as root, no other drm clients
 | 
				
			||||||
 | 
						running):
 | 
				
			||||||
	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):
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
	piglit-sources # ./piglit run igt <results-file>
 | 
						piglit-sources # ./piglit run igt <results-file>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
				
			|||||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user