How to debug Xorg problems

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(clean up)
(clean up existing content a bit, re-arrange to include separate 'identifying issues' and 'what info to include' sections, add some new chunks)
Line 1: Line 1:
 
'''Foreword'''
 
'''Foreword'''
  
If you are experiencing a problem with Xorg, please see the [[Common_F11_bugs|Fedora 11 common bugs]] document before filing a bug. Some easy configuration tweaks that fix a wide range of issues are listed there. If the problem you are seeing is not listed there or none of the workarounds seem to help, please consider filing a bug to help us make Fedora run better on your hardware.
+
If you are experiencing a problem with Xorg, please see the [[Bugs/Common|common bugs]] document before filing a bug. Some easy configuration tweaks that fix a wide range of issues are listed there. If the problem you are seeing is not listed there or none of the workarounds seem to help, please consider filing a bug to help us make Fedora run better on your hardware.
  
 
Be prepared to include some information (logs) about your system as well. These should be complete (no snippets please), not in an archive, uncompressed, with MIME type set as text/plain.
 
Be prepared to include some information (logs) about your system as well. These should be complete (no snippets please), not in an archive, uncompressed, with MIME type set as text/plain.
  
== General bug reports ==
+
== Identifying your problem area ==
  
The following would be useful to attach to your bug report:
+
=== What driver am I using? ===
  
* All of the X server log file(s) {{filename|/var/log/Xorg.*.log}}
+
If you do not know already, try to find out what video driver you are using. Examine the file {{filename|/var/log/Xorg.0.log}}. Quite early on, you will see some lines like this:
* Your [http://smolts.org/ smolt profile]. You can dump it to {{filename|/tmp/smoltprofile.txt}} with the following command:
+
<pre>
smoltSendProfile -p > /tmp/smoltprofile.txt
+
(II) VESA(0): initializing int10
* If you use a xorg.conf, please include it in the bug report, otherwise, please specify in the bug report that it does not exist.  (Usually {{filename|/etc/X11/xorg.conf}} but see "man xorg.conf" for other standard locations.)
+
(II) VESA(0): Bad V_BIOS checksum
* {{filename|/var/log/Xorg.0.log}} from a trial run where you move {{filename|/etc/X11/xorg.conf}} aside and let Xorg autodetect your hardware (if you have such a file).
+
</pre>
 +
The word in capital letters after (II) is the name of the driver in use (so, in this case, the word is VESA, indicating the ''vesa'' driver is in use). Drivers are packaged with the name {{package|xorg-x11-drv-''name''}}, so the ''vesa'' driver is in the package {{package|xorg-x11-drv-vesa}}.
  
== Rendering problems (unreadable text, corrupted display...) ==
+
If you are using a driver with the name ''nvidia'' (not ''nv'' or ''nouveau'') or ''fglrx'', you are using a proprietary third-party video driver (respectively, the proprietary drivers provided by NVIDIA and AMD/ATI). Please do not report any bugs in these drivers to Fedora, as we do not provide or support these drivers. Report bugs either to the place where you got these drivers, or to NVIDIA or AMD.
 +
 
 +
=== What area might the problem be in? ===
 +
 
 +
* If the problem in question occurs when using 3D-accelerated applications - for instance, Blender, or 3D-accelerated games - the problem is a ''3D acceleration issue'', and you should include the information outlined in the [[Xorg/Debugging#3DInfo|appropriate section]] further down this page.
 +
 
 +
* Several drivers in Fedora use kernel mode setting (whereby the detection and selection of the output resolution and refresh rate is done in the kernel rather than the video card driver) by default. As of Fedora 11, these drivers are ''intel'' and ''radeon''. If you are using one of these drivers, test if the problem is related to kernel mode setting by disabling it: boot with the parameter <tt>nomodeset</tt> added to the kernel command line. If this affects the problem, it is a ''KMS-related issue'', and you should include the information outlined in the [[Xorg/Debugging#KMS|appropriate section]] further down this page.
 +
 
 +
== Information to include in your report ==
 +
 
 +
{{Anchor|AllInfo}}
 +
=== All bug reports ===
 +
 
 +
In all cases, the following should be attached to your bug report:
 +
 
 +
* All of the X server log file(s): {{filename|/var/log/Xorg.*.log}}
 +
* Your [http://smolts.org/ smolt profile]. You can dump it to {{filename|/tmp/smoltprofile.txt}} with the following command:
 +
{{command|smoltSendProfile -p > /tmp/smoltprofile.txt}}
 +
* If you use a {{filename|xorg.conf}}, please include it in the bug report, otherwise, please specify in the bug report that it does not exist.  (Usually {{filename|/etc/X11/xorg.conf}} but see "man xorg.conf" for other standard locations.)
 +
* {{filename|/var/log/Xorg.0.log}} from a trial run where you move your {{filename|xorg.conf}} aside and let Xorg autodetect your hardware (if you have such a file).
  
All of the above, with a screenshot showing the problem if at all possible.
+
=== Rendering problems (unreadable text, corrupted display...) ===
  
== KMS problems (most Intel and AMD/Radeon hardware) ==
+
* Also include a screenshot showing the problem if at all possible.
  
Try modifying the kernel command line as described below; instructions are on the [[Xorg/KMS]] page if you don't know how to do that.
+
{{Anchor|KMSInfo}}
 +
=== KMS-related issues ===
  
Please add <code>drm.debug=1</code> to the kernel command line, reboot and attach {{filename|/var/log/messages}} to your bug report.
+
As well as the information from [[Xorg/Debugging#AllInfo|the 'all bug reports' section]], include the following information:
  
Additionally, please add <code>nomodeset</code>
+
* Boot with the parameter <code>drm.debug=1</code> added to the kernel command line, reboot and attach {{filename|/var/log/messages}} and {{filename|/var/log/Xorg.0.log}} to your bug report.
to the kernel command line and try to reproduce the problem, and include the following information:
+
* Also, boot with the parameter <code>nomodeset</code> added to the kernel command line and attach {{filename|/var/log/Xorg.0.log}} to your bug report.
* Whether you were able to reproduce the problem or not
+
* Explain how the behaviour differs when KMS is disabled, and whether both cases are problematic (but different), or whether the non-KMS case is what you consider to be the correct behavior.
* X server log file(s) {{filename|/var/log/Xorg.*.log}} (these are different in KMS and non-KMS mode, we may need both)
+
  
== OpenGL / Mesa problems ==
+
{{Anchor|3DInfo}}
 +
=== 3D acceleration issues ===
  
Add the following to your bug report in addition to the general items:
+
As well as the information from [[Xorg/Debugging#AllInfo|the 'all bug reports' section]], include the following information:
  
* Output of the command <code>glxinfo</code>
+
* Output of the command {{command|glxinfo}} (if this is not installed, install the package {{package|glx-utils}})
* A screenshot
+
* A screenshot, if possible (if the system has crashed but the display on screen is something other than just blank, take a picture with a digital camera and attach that)
* Indicate whether or not other OpenGL applications are able to run without problems.
+
* Information as to whether or not other OpenGL applications are able to run without problems.
  
 
== Creating a xorg.conf ==
 
== Creating a xorg.conf ==

Revision as of 09:58, 26 June 2009

Foreword

If you are experiencing a problem with Xorg, please see the common bugs document before filing a bug. Some easy configuration tweaks that fix a wide range of issues are listed there. If the problem you are seeing is not listed there or none of the workarounds seem to help, please consider filing a bug to help us make Fedora run better on your hardware.

Be prepared to include some information (logs) about your system as well. These should be complete (no snippets please), not in an archive, uncompressed, with MIME type set as text/plain.

Contents

Identifying your problem area

What driver am I using?

If you do not know already, try to find out what video driver you are using. Examine the file /var/log/Xorg.0.log. Quite early on, you will see some lines like this:

(II) VESA(0): initializing int10
(II) VESA(0): Bad V_BIOS checksum

The word in capital letters after (II) is the name of the driver in use (so, in this case, the word is VESA, indicating the vesa driver is in use). Drivers are packaged with the name Package-x-generic-16.pngname xorg-x11-drv-name, so the vesa driver is in the package Package-x-generic-16.pngxorg-x11-drv-vesa.

If you are using a driver with the name nvidia (not nv or nouveau) or fglrx, you are using a proprietary third-party video driver (respectively, the proprietary drivers provided by NVIDIA and AMD/ATI). Please do not report any bugs in these drivers to Fedora, as we do not provide or support these drivers. Report bugs either to the place where you got these drivers, or to NVIDIA or AMD.

What area might the problem be in?

  • If the problem in question occurs when using 3D-accelerated applications - for instance, Blender, or 3D-accelerated games - the problem is a 3D acceleration issue, and you should include the information outlined in the appropriate section further down this page.
  • Several drivers in Fedora use kernel mode setting (whereby the detection and selection of the output resolution and refresh rate is done in the kernel rather than the video card driver) by default. As of Fedora 11, these drivers are intel and radeon. If you are using one of these drivers, test if the problem is related to kernel mode setting by disabling it: boot with the parameter nomodeset added to the kernel command line. If this affects the problem, it is a KMS-related issue, and you should include the information outlined in the appropriate section further down this page.

Information to include in your report

All bug reports

In all cases, the following should be attached to your bug report:

  • All of the X server log file(s): /var/log/Xorg.*.log
  • Your smolt profile. You can dump it to /tmp/smoltprofile.txt with the following command:
smoltSendProfile -p > /tmp/smoltprofile.txt
  • If you use a xorg.conf, please include it in the bug report, otherwise, please specify in the bug report that it does not exist. (Usually /etc/X11/xorg.conf but see "man xorg.conf" for other standard locations.)
  • /var/log/Xorg.0.log from a trial run where you move your xorg.conf aside and let Xorg autodetect your hardware (if you have such a file).

Rendering problems (unreadable text, corrupted display...)

  • Also include a screenshot showing the problem if at all possible.

KMS-related issues

As well as the information from the 'all bug reports' section, include the following information:

  • Boot with the parameter drm.debug=1 added to the kernel command line, reboot and attach /var/log/messages and /var/log/Xorg.0.log to your bug report.
  • Also, boot with the parameter nomodeset added to the kernel command line and attach /var/log/Xorg.0.log to your bug report.
  • Explain how the behaviour differs when KMS is disabled, and whether both cases are problematic (but different), or whether the non-KMS case is what you consider to be the correct behavior.

3D acceleration issues

As well as the information from the 'all bug reports' section, include the following information:

  • Output of the command glxinfo (if this is not installed, install the package Package-x-generic-16.pngglx-utils)
  • A screenshot, if possible (if the system has crashed but the display on screen is something other than just blank, take a picture with a digital camera and attach that)
  • Information as to whether or not other OpenGL applications are able to run without problems.

Creating a xorg.conf

If you need to make manual changes to X configuration, you will need to create a xorg.conf file if it doesn't already exist.

Stack traces

You will need a stack trace if your X server crashes.

See the documentation on the upstream wiki.