aboutsummaryrefslogtreecommitdiffstats
path: root/docs/debugging.rst
blob: 1e90c52a9cf947dc084970e19305fa96cd3fd17a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Debugging Tips
==============

Normally Mesa (and OpenGL) records but does not notify the user of
errors. It is up to the application to call ``glGetError`` to check for
errors. Mesa supports an environment variable, ``MESA_DEBUG``, to help
with debugging. If ``MESA_DEBUG`` is defined, a message will be printed
to stdout whenever an error occurs.

More extensive error checking is done in DEBUG builds
(``--buildtype debug`` for meson, ``build=debug`` for scons).

In your debugger you can set a breakpoint in ``_mesa_error()`` to trap
Mesa errors.

There is a display list printing/debugging facility. See the end of
``src/dlist.c`` for details.