summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorLionel Landwerlin <lionel.g.landwerlin@intel.com>2023-01-20 11:30:46 +0200
committerMarge Bot <emma+marge@anholt.net>2023-01-24 15:15:17 +0000
commit5b79745b045ac6161ba531ca6de3fa78487a6cc7 (patch)
treec09af98bd94f2529a5fcff1f836c4113fd839023 /docs
parent31931754bc1496a36dbef9877719897a3828ac08 (diff)
intel/common: add a INTEL_DECODE variable to parameter decoder at runtime
Sometimes you want to diff 2 runs with INTEL_DEBUG=bat, but a tiny allocation change can mess quite badly with offsets printed in the decoding, making it hard to look at the diff with meld. Fortunately our decoder can avoid printing offsets. We just need a variable to specify that. We still use the defaults specified by the driver but you can turn things on/off with : INTEL_DECODE=+color,-offsets,-floats INTEL_DEBUG=bat ./my_app Signed-off-by: Lionel Landwerlin <lionel.g.landwerlin@intel.com> Reviewed-by: Marcin Ĺšlusarz <marcin.slusarz@intel.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/20874>
Diffstat (limited to 'docs')
-rw-r--r--docs/envvars.rst19
1 files changed, 19 insertions, 0 deletions
diff --git a/docs/envvars.rst b/docs/envvars.rst
index 26186cc789b..e65e362adcc 100644
--- a/docs/envvars.rst
+++ b/docs/envvars.rst
@@ -518,6 +518,25 @@ Intel driver environment variables
``wm``
dump shader assembly for fragment shaders (same as ``fs``)
+.. envvar:: INTEL_DECODE
+
+ a comma-separated list of enable/disable flags configuring the
+ output produced by ``INTEL_DEBUG=bat`` (use with
+ ``INTEL_DECODE=+color,-floats``) :
+
+ ``color``
+ print colored output
+
+ ``floats``
+ try to decode floating point data in buffers
+
+ ``full``
+ print additional custom information for instructions (usually
+ pulling more information by inspecting memory)
+
+ ``offsets``
+ print offsets of instructions
+
.. envvar:: INTEL_MEASURE
Collects GPU timestamps over common intervals, and generates a CSV report