diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..b400975 --- /dev/null +++ b/README.md @@ -0,0 +1,63 @@ +# mesa-run + +A collection of scripts to build and test [Mesa](https://www.mesa3d.org/) without installing it. + +## Scripts + +- [nj](nj) - Run [ninja](https://github.com/ninja-build/ninja) from anywhere in the project git repository. (upstream: [nj repo](gitlab.freedesktop.org/kwg/nj)) +- [mesa-run](mesa-run) - helper script. Not used directly. Requires [jq](https://github.com/jqlang/jq) +- [mesa-debug](mesa-debug) - Debug build +- [mesa-debug-asan](mesa-debug-asan) - Debug build with [AddressSanitizer](https://github.com/google/sanitizers/wiki/AddressSanitizer) +- [mesa-debug-optimized](mesa-debug-optimized) - Debug build with optimization +- [mesa-release](mesa-release) - Release build +- [mesa-gdb](mesa-gdb) - Wrapper around `mesa-debug` that invokes `gdb` +- [deqp-run](deqp-run) - Run dEQP test suites +- [deqp-results-to-markdown](deqp-results-to-markdown) - Generate Markdown table of dEQP test suite results + +## Examples + +### Configure and build debug build + +```console +$ mesa-debug configure +$ nj debug install +``` + +### Run program with local Mesa build + +```console +$ 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](https://github.com/KhronosGroup/VK-GL-CTS/) with a build configured with `-DDEQP_TARGET=surfaceless` in `build/`. + +#### Single test + +```console +$ deqp-run dEQP-VK.graphicsfuzz.spv-stable-pillars-volatile-nontemporal-store +``` + +#### Test suite + +```console +$ deqp-run vk +``` + +### Make Markdown table of dEQP test results + +```console +$ 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| |