How to debug Xorg problems
If you are experiencing a problem with Xorg, please see the 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.
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
The following would be useful to attach to your bug report:
- All of the X server log file(s)
- Your smolt profile. You can dump it to
/tmp/smoltprofile.txtwith 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.confbut see "man xorg.conf" for other standard locations.)
/var/log/Xorg.0.logfrom a trial run where you move
/etc/X11/xorg.confaside and let Xorg autodetect your hardware (if you have such a file).
Rendering problems (unreadable text, corrupted display...)
All of the above, with a screenshot showing the problem if at all possible.
KMS problems (most Intel and AMD/Radeon hardware)
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.
drm.debug=1 to the kernel command line, reboot and attach
/var/log/messages to your bug report.
Additionally, please add
to the kernel command line and try to reproduce the problem, and include the following information:
- Whether you were able to reproduce the problem or not
- X server log file(s)
/var/log/Xorg.*.log(these are different in KMS and non-KMS mode, we may need both)
OpenGL / Mesa problems
Add the following to your bug report in addition to the general items:
- Output of the command
- A screenshot
- Indicate 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.
You will need a stack trace if your X server crashes.
See the documentation on the upstream wiki.