diff options
| author | Faith Ekstrand <faith.ekstrand@collabora.com> | 2025-10-23 15:29:47 -0400 |
|---|---|---|
| committer | Marge Bot <marge-bot@fdo.invalid> | 2025-11-06 15:27:29 +0000 |
| commit | cb7df84430e6b588b469801c3ad9b30931c9f5b6 (patch) | |
| tree | 1686e5c8a84be007e13da9eba22f7f466b94ac9a /docs | |
| parent | 59a89cd762ebb5fa7c2e0da89f79e3baa0d90f97 (diff) | |
vulkan/runtime: Add an environment variable to validate shader binaries
Setting MESA_VK_VALIDATE_SHADER_BINARIES will cause the shader code to
round-trip every shader through [de]serialize and only ever use the
deserialized version. This catches bugs where the driver may drop
things in the [de]serialization process. It also deserializes the new
shader again and compares it against the original to ensure that
deserialize -> serialize is idempotent.
Acked-by: Eric R. Smith <eric.smith@collabora.com>
Reviewed-by: Lars-Ivar Hesselberg Simonsen <lars-ivar.simonsen@arm.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/36647>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/envvars.rst | 5 |
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/envvars.rst b/docs/envvars.rst index 6fbf8e6bc03..22123800ce7 100644 --- a/docs/envvars.rst +++ b/docs/envvars.rst @@ -353,6 +353,11 @@ Core Mesa environment variables lost device. This is extremely useful when testing as it prevents the test suite from continuing on with a lost device. +.. envvar:: MESA_VK_VALIDATE_SHADER_BINARIES + + enables extra validation of shader and pipeline binaries to ensure + consistency of driver binaries. + .. envvar:: MESA_VK_ENABLE_SUBMIT_THREAD for Vulkan drivers which support real timeline semaphores, this forces |