xref: /aosp_15_r20/external/mesa3d/docs/bugs.rst (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1*61046927SAndroid Build Coastguard WorkerReport a Bug
2*61046927SAndroid Build Coastguard Worker============
3*61046927SAndroid Build Coastguard Worker
4*61046927SAndroid Build Coastguard WorkerTo file a Mesa bug, go to `GitLab on
5*61046927SAndroid Build Coastguard Workerfreedesktop.org <https://gitlab.freedesktop.org/mesa/mesa/-/issues>`__.
6*61046927SAndroid Build Coastguard Worker
7*61046927SAndroid Build Coastguard WorkerPlease follow these bug reporting guidelines:
8*61046927SAndroid Build Coastguard Worker
9*61046927SAndroid Build Coastguard Worker-  Check if a new version of Mesa is available which might have fixed
10*61046927SAndroid Build Coastguard Worker   the problem.
11*61046927SAndroid Build Coastguard Worker-  Check if your bug is already reported in the database.
12*61046927SAndroid Build Coastguard Worker-  Monitor your bug report for requests for additional information, etc.
13*61046927SAndroid Build Coastguard Worker-  Attach the output of running glxinfo or wglinfo. This will tell us
14*61046927SAndroid Build Coastguard Worker   the Mesa version, which device driver you're using, etc.
15*61046927SAndroid Build Coastguard Worker-  If you're reporting a crash, try to use your debugger (gdb) to get a
16*61046927SAndroid Build Coastguard Worker   stack trace. Also, recompile Mesa in debug mode to get more detailed
17*61046927SAndroid Build Coastguard Worker   information.
18*61046927SAndroid Build Coastguard Worker-  Describe in detail how to reproduce the bug, especially with games
19*61046927SAndroid Build Coastguard Worker   and applications that the Mesa developers might not be familiar with.
20*61046927SAndroid Build Coastguard Worker-  Provide an `apitrace <https://github.com/apitrace/apitrace>`__ or
21*61046927SAndroid Build Coastguard Worker   simple GLUT-based test program if possible.
22*61046927SAndroid Build Coastguard Worker
23*61046927SAndroid Build Coastguard WorkerThe easier a bug is to reproduce, the sooner it will be fixed. Please do
24*61046927SAndroid Build Coastguard Workereverything you can to facilitate quickly fixing bugs. If your bug report
25*61046927SAndroid Build Coastguard Workeris vague or your test program doesn't compile easily, the problem may
26*61046927SAndroid Build Coastguard Workernot be fixed very quickly.
27