Commit 7126faf3 authored by Elie Tournier's avatar Elie Tournier Committed by Emil Velikov

shader-db: Update the README

Use the binary to run shader-db instead of
Signed-off-by: Elie Tournier's avatarElie Tournier <>
v2: [Emil] s/Depreciated/Deprecated/ (Matt)
Signed-off-by: default avatarEmil Velikov <>
parent 46f7e4ef
=== What ===
A giant pile of shaders from various apps, for whatever purpose. In
A giant pile of shaders from various apps, for whatever purpose. In
particular, we use it to capture assembly output of the shader
compiler for analysis of regressions in compiler behavior.
......@@ -16,10 +16,16 @@ MESA_SHADER_CAPTURE_PATH=dirpath executable
# "fdupes" can be used to remove duplicates
=== Compiling ===
Some libraries are required when building. See section "Dependencies" below.
To build the binary, do:
=== i965 Usage ===
=== Running shaders ===
./run shaders 2> err | tee new-run
# To run just a subset:
......@@ -34,8 +40,8 @@ To compile shaders for an i965 PCI ID different from your system, pass
to run.
=== Analysis ===
./ old-run new-run
./ old-run new-run
=== radeonsi Usage ===
......@@ -46,6 +52,7 @@ to run.
Note that a debug mesa build required (ie. --enable-debug)
=== Analysis ===
./ old-run new-run
=== freedreno Usage ===
......@@ -59,15 +66,22 @@ Note that a debug mesa build required (ie. --enable-debug)
-1 option for disabling multi-threading is required to avoid garbled shader dumps.
=== Analysis ===
./ old-run new-run
=== Dependencies ===
run requires some GNU C extensions, render nodes (/dev/dri/renderD128),
libepoxy, OpenMP, and Mesa configured with --with-egl-platforms=x11,drm
=== jemalloc ===
Since run compiles shaders in different threads, malloc/free locking overhead
from inside Mesa can be expensive. Preloading jemalloc can cut significant
amounts of time:
LD_PRELOAD=/usr/lib64/ ./run shaders 2> err | tee new-run
=== Deprecated === is obsolete. Use the 'run' binary instead.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment