mesa-run

A collection of scripts to build and test Mesa without installing it.

Scripts

• nj - Run ninja from anywhere in the project git repository. (upstream: nj repo)
• mesa-run - helper script. Not used directly.
• mesa-debug - Debug build
• mesa-debug-asan - Debug build with AddressSanitizer
• mesa-debug-optimized - Debug build with optimization
• mesa-release - Release build
• mesa-gdb - Wrapper around mesa-debug that invokes gdb
• deqp-run - Run dEQP test suites
• deqp-results-to-markdown - Generate Markdown table of dEQP test suite results

Examples

Configure and build debug build

$ mesa-debug configure
$ nj debug install

Run program with local Mesa build

$ mesa-debug glxinfo

Run dEQP

On ChromeOS, deqp-run uses the system-provided media-gfx/deqp package. The script should be run from a directory that has space to store the output such as /mnt/stateful_partition/home/root/.

On desktop Linux, deqp-run should be run from a git checkout of VK-GL-CTS with a build configured with -DDEQP_TARGET=surfaceless in build/.

Single test

$ deqp-run dEQP-VK.graphicsfuzz.spv-stable-pillars-volatile-nontemporal-store

Test suite

$ deqp-run vk

Full command

$ deqp-run --cmd vk
deqp-runner run --caselist [...]

Particularly useful for running a single test under gdb:

$ mesa-gdb $(deqp-run --cmd dEQP-VK.graphicsfuzz.spv-stable-pillars-volatile-nontemporal-store)

Make Markdown table of dEQP test results

$ deqp-results-to-markdown

Example output

	Pass	Fail	Skip	Warn	Timeout	Flake
dEQP-GLES2	14243		26
dEQP-GLES3	42687		113	2
dEQP-GLES31	37576		55
dEQP-VK	486602	2	590787	6	2	1