docs/debugging.html

   1 <HTML>
   2
   3 <TITLE>Debugging Tips</TITLE>
   4
   5 <link rel="stylesheet" type="text/css" href="mesa.css"></head>
   6
   7 <BODY>
   8
   9 <H1>Debugging Tips</H1>
  10
  11 <p>
  12    Normally Mesa (and OpenGL) records but does not notify the user of
  13    errors.  It is up to the application to call
  14    <code>glGetError</code> to check for errors.  Mesa supports an
  15    environment variable, MESA_DEBUG, to help with debugging.  If
  16    MESA_DEBUG is defined, a message will be printed to stdout whenever
  17    an error occurs.
  18 </p>
  19
  20 <p>
  21    More extensive error checking is done when Mesa is compiled with the
  22    DEBUG symbol defined.  You'll have to edit the Make-config file and
  23    add -DDEBUG to the CFLAGS line for your system configuration.  You may
  24    also want to replace any optimization flags with the -g flag so you can
  25    use your debugger.  After you've edited Make-config type 'make clean'
  26    before recompiling.
  27 </p>
  28 <p>
  29    In your debugger you can set a breakpoint in _mesa_error() to trap Mesa
  30    errors.
  31 </p>
  32 <p>
  33    There is a display list printing/debugging facility.  See the end of
  34    src/dlist.c for details.
  35 </p>
  36
  37 </BODY>
  38 </HTML>