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.