From 9ebf7c93103266d6a648543e00cc1b26213efc83 Mon Sep 17 00:00:00 2001 From: Matt Turner Date: Wed, 6 Sep 2023 15:34:29 -0400 Subject: README.md: Add --- README.md | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..94db353 --- /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 +- [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 + +```sh +mesa-debug configure +nj debug install +``` + +### Run program with local Mesa build + +```sh +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 + +```sh +deqp-run dEQP-VK.graphicsfuzz.spv-stable-pillars-volatile-nontemporal-store +``` + +#### Test suite + +```sh +deqp-run vk +``` + +### Make Markdown table of dEQP test results + +```sh +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| -- cgit v1.2.3