diff options
author | Lionel Landwerlin <lionel.g.landwerlin@intel.com> | 2023-01-20 11:30:46 +0200 |
---|---|---|
committer | Marge Bot <emma+marge@anholt.net> | 2023-01-24 15:15:17 +0000 |
commit | 5b79745b045ac6161ba531ca6de3fa78487a6cc7 (patch) | |
tree | c09af98bd94f2529a5fcff1f836c4113fd839023 /docs | |
parent | 31931754bc1496a36dbef9877719897a3828ac08 (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.rst | 19 |
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 |