Debugging Tips — The Mesa 3D Graphics Library latest documentation

# 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).

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/mesa/main/dlist.c` for details.