xref: /aosp_15_r20/external/mesa3d/docs/debugging.rst (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1*61046927SAndroid Build Coastguard WorkerDebugging Tips
2*61046927SAndroid Build Coastguard Worker==============
3*61046927SAndroid Build Coastguard Worker
4*61046927SAndroid Build Coastguard WorkerNormally Mesa (and OpenGL) records but does not notify the user of
5*61046927SAndroid Build Coastguard Workererrors. It is up to the application to call ``glGetError`` to check for
6*61046927SAndroid Build Coastguard Workererrors. Mesa supports an environment variable, ``MESA_DEBUG``, to help
7*61046927SAndroid Build Coastguard Workerwith debugging. If ``MESA_DEBUG`` is defined, a message will be printed
8*61046927SAndroid Build Coastguard Workerto stdout whenever an error occurs.
9*61046927SAndroid Build Coastguard Worker
10*61046927SAndroid Build Coastguard WorkerMore extensive error checking is done in DEBUG builds
11*61046927SAndroid Build Coastguard Worker(``--buildtype debug`` for Meson).
12*61046927SAndroid Build Coastguard Worker
13*61046927SAndroid Build Coastguard WorkerIn your debugger you can set a breakpoint in ``_mesa_error()`` to trap
14*61046927SAndroid Build Coastguard WorkerMesa errors.
15*61046927SAndroid Build Coastguard Worker
16*61046927SAndroid Build Coastguard WorkerThere is a display list printing/debugging facility. See the end of
17*61046927SAndroid Build Coastguard Worker``src/mesa/main/dlist.c`` for details.
18