Home | History | Annotate | Download | only in docs
      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>
     39