1848b8605Smrg<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2848b8605Smrg<html lang="en">
3848b8605Smrg<head>
4848b8605Smrg  <meta http-equiv="content-type" content="text/html; charset=utf-8">
5848b8605Smrg  <title>Mesa Bug Reporting</title>
6848b8605Smrg  <link rel="stylesheet" type="text/css" href="mesa.css">
7848b8605Smrg</head>
8848b8605Smrg<body>
9848b8605Smrg
10848b8605Smrg<div class="header">
11848b8605Smrg  <h1>The Mesa 3D Graphics Library</h1>
12848b8605Smrg</div>
13848b8605Smrg
14848b8605Smrg<iframe src="contents.html"></iframe>
15848b8605Smrg<div class="content">
16848b8605Smrg
17b8e80941Smrg<h1>Report a bug</h1>
18848b8605Smrg
19848b8605Smrg<p>
20848b8605SmrgThe Mesa bug database is hosted on
21b8e80941Smrg<a href="https://freedesktop.org">freedesktop.org</a>.
22848b8605SmrgThe old bug database on SourceForge is no longer used.
23848b8605Smrg</p>
24848b8605Smrg
25848b8605Smrg<p>
26848b8605SmrgTo file a Mesa bug, go to
27848b8605Smrg<a href="https://bugs.freedesktop.org/enter_bug.cgi?product=Mesa">
28848b8605SmrgBugzilla on freedesktop.org</a>
29848b8605Smrg</p>
30848b8605Smrg
31848b8605Smrg<p>
32848b8605SmrgPlease follow these bug reporting guidelines:
33848b8605Smrg</p>
34848b8605Smrg
35848b8605Smrg<ul>
36848b8605Smrg<li>Check if a new version of Mesa is available which might have fixed
37848b8605Smrgthe problem.
38848b8605Smrg<li>Check if your bug is already reported in the database.
39848b8605Smrg<li>Monitor your bug report for requests for additional information, etc.
40b8e80941Smrg<li>Attach the output of running glxinfo or wglinfo.
41b8e80941SmrgThis will tell us the Mesa version, which device driver you're using, etc.
42848b8605Smrg<li>If you're reporting a crash, try to use your debugger (gdb) to get a stack
43848b8605Smrgtrace. Also, recompile Mesa in debug mode to get more detailed information.
44848b8605Smrg<li>Describe in detail how to reproduce the bug, especially with games
45848b8605Smrgand applications that the Mesa developers might not be familiar with.
46b8e80941Smrg<li>Provide an <a href="https://github.com/apitrace/apitrace">apitrace</a>
47b8e80941Smrgor simple GLUT-based test program if possible.
48848b8605Smrg</ul>
49848b8605Smrg
50848b8605Smrg<p>
51848b8605SmrgBug reports will automatically be forwarded by bugzilla to the Mesa
52848b8605Smrgdeveloper's mailing list.
53848b8605Smrg</p>
54848b8605Smrg
55848b8605Smrg<p>
56848b8605SmrgThe easier a bug is to reproduce, the sooner it will be fixed.
57848b8605SmrgPlease do everything you can to facilitate quickly fixing bugs.
58848b8605SmrgIf your bug report is vague or your test program doesn't compile
59848b8605Smrgeasily, the problem may not be fixed very quickly.
60848b8605Smrg</p>
61848b8605Smrg
62848b8605Smrg</div>
63848b8605Smrg</body>
64848b8605Smrg</html>
65