[Mesa-dev] [PATCH] shader-db: Update the README
Elie Tournier
tournier.elie at gmail.com
Fri Jan 13 18:04:18 UTC 2017
Use the binary to run shader-db instead of run.py
Signed-off-by: Elie Tournier <tournier.elie at gmail.com>
---
README | 18 ++++++++++++++++--
1 file changed, 16 insertions(+), 2 deletions(-)
diff --git a/README b/README
index 5e9bb2d..6f6a7e2 100644
--- a/README
+++ b/README
@@ -1,6 +1,6 @@
=== 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:
+make
=== 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 ===
-./report.py old-run new-run
+./report.py old-run new-run
=== radeonsi Usage ===
@@ -46,6 +52,7 @@ to run.
Note that a debug mesa build required (ie. --enable-debug)
=== Analysis ===
+
./si-report.py 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 ===
+
./fd-report.py 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/libjemalloc.so.1 ./run shaders 2> err | tee new-run
+
+=== Depreciated ===
+
+run.py is obsolete. Use the 'run' binary instead.
--
2.11.0
More information about the mesa-dev
mailing list