fdo-mirrors/mesa
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/mesa/mesa.git synced 2026-05-05 07:28:11 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

freedreno/docs: Document TU_DEBUG_FILE

Browse source 
Signed-off-by: Mark Collins <mark@igalia.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/32906>
This commit is contained in:
Mark Collins 2025-01-06 18:10:47 +00:00 • committed by Marge Bot
parent a177788f6a
commit aaf8a8d968
2 changed files with 24 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
docs/drivers/freedreno.rst
View file

@ -636,3 +636,26 @@ the cases where stale data is read.
The best way to pinpoint the reg which causes a failure is to bisect the regs
range. In case when a fail is caused by combination of several registers
the ``inverse`` flag may be set to find the reg which prevents the failure.
Runtime toggling of ``TU_DEBUG`` options
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
In some cases, it is useful to toggle ``TU_DEBUG`` options at runtime, such as
when assessing the performance impact of a particular option. This can be done
by setting the ``TU_DEBUG_FILE`` environment variable to a file path, and writing
the desired ``TU_DEBUG`` options to that file. The driver will check the file for
changes and apply them.
The folder containing the file should exist prior to running the application, and
deleting the folder during runtime will result in the driver no longer picking up
any changes even if the folder is recreated.
Additionally, not all ``TU_DEBUG`` options can be toggled at runtime, the following
are supported at the moment: ``nir``, ``nobin``, ``sysmem``, ``gmem``, ``forcebin``,
``layout``, ``nolrz``, ``nolrzfc``, ``perf``, ``flushall``, ``syncdraw``,
``rast_order``, ``unaligned_store``, ``log_skip_gmem_ops``, ``3d_load``, ``fdm``,
``noconcurrentresolves``, ``noconcurrentunresolves``.
Some of these options will behave differently when toggled at runtime, for example:
``nolrz`` will still result in LRZ allocation which would not happen if the option
was set in the environment variable.

1
src/freedreno/vulkan/tu_util.cc
View file

@ -54,6 +54,7 @@ static const struct debug_control tu_debug_options[] = {
* The runtime debug flags are a subset of the debug flags that can be set at
* runtime. Flags which depend on running state of the driver, the application
* or the hardware and would otherwise break when toggled should not be set here.
* Note: Keep in sync with the list of flags in 'docs/drivers/freedreno.rst'.
*/
const uint32_t tu_runtime_debug_flags =
TU_DEBUG_NIR | TU_DEBUG_NOBIN | TU_DEBUG_SYSMEM | TU_DEBUG_GMEM |