|Deletions are marked like this.||Additions are marked like this.|
|Line 14:||Line 14:|
|<<Include(X/Troubleshooting, , from="=== Troubleshooting Techniques ===")>>||<<Include(X/Troubleshooting, , from="=== Troubleshooting Techniques ===", to="^----')>>|
|Line 17:||Line 17:|
| * [[X/Config|Configuration]] - Configuring input devices, graphics, drivers, and more
* [[X/KernelModeSetting]] - Configuring and using KMS (in Karmic)
* [[X/Rootless]] - Running X as a user process, not as the root user
* [[X/InputCoordinateTransformation]] - How to set the mapping of an input device to a display through X
* [[https://launchpad.net/~xorg-edgers|XorgOnTheEdge]] - for bleeding edge packages
* [[https://help.ubuntu.com/community/BinaryDriverHowto|Binary Driver Howto]]
* [[https://help.ubuntu.com/community/HybridGraphics|Hybrid Graphics Howto]]
|<<Include(X/Config, , from="== Configuration Recipes ==", to="^=")>>|
|Line 41:||Line 35:|
Basic Troubleshooting Resources
X Reporting - How to create good X bug reports
Include: Nothing found for "=== Common Problems ==="!
Include: Nothing found for "=== Troubleshooting Techniques ==="!
Identifying if the issue is a bug or not
If you aren't sure if you have encountered a software bug in Ubuntu, then you would want to seek help in determining if the issue is a bug or not from here.
If you have confirmed the issue is a bug, please read on.
Determining which type of bug you have
Not all bugs where X seems to be the root cause are in fact an X related bug. Hence, here is documentation on potential root causes:
i855 is Unsupported - Explanation of why i845, i855, i865, etc. chips aren't supported
Glossary - Common error messages and terminology
X Transitions - Explanation for "installing xserver-xorg-core would break existing software"
Reporting a confirmed X bug to Launchpad
Initial filing of the report
First, please install the package xdiagnose.
Next, ensure you click the Yes button for attaching additional debugging information after running the following via a terminal:
Include developer information in your report
One will want to answer the following questions in order for a developer to address the issue:
- Does the report include debugging information from the relevant article relating to the reported issue?
- Is this a regression?
- Does this happen in the latest version of Ubuntu?
- Does this happen in the latest version available from upstream?
Non-Graphical Booting - Running X manually, without a display manager (like lightdm, kdm, gdm...)
Wireless Without X - How to get a wireless network connection without X.
Direct Wired Without WAP - How to connect two laptops with direct ethernet cord.
Crashes and Freezes
X Backtracing - How to collect a backtrace for an X crash
Interpreting GPU Dumps - Ringbuffers, batchbuffers, and the meaning of intel_gpu_dump output
Valgrind - Debugging memory leaks
X Bisecting - Using bisection techniques to solve regressions or backport fixes
X/Testing/Touch - Touchscreen and multi-touch testing
Triaging and tagging X bugs
Fixing an X crash
Invalid include arguments "X/Troubleshooting, , from="=== Troubleshooting Techniques ===", to="^----'"!
Session Startup - .xprofile, .xsessionrc, .gnomerc
Rootless X - Running X as a user process, not as the root user
Xorg On The Edge - for bleeding edge packages
X/SwatTeam - Joining the Ubuntu X.org team
X Triaging - How to ensure new X bug reports have enough info to troubleshoot
X/Architecture - High level architectural overview of X.org
X/DriverDevelopment - Developing new Xorg drivers for Ubuntu
X/DriverBuilding - Building debs of upstream drivers
X Glossary - Explanations for confusing terms often seen in logs and error messages
X/Blueprints - Specifications of interest for X
X/GitUsage - Instructions for using git
X/DesktopWishlist - Pending Xorg changes that would benefit Ubuntu Desktop
X/KernelWishlist - Pending/desired kernel changes that would benefit Xorg
https://bugs.edge.launchpad.net/ubuntu/+source/linux/?field.tag=xorg-needs-kernel-fix - Kernel fixes needed for xorg issues
X/BetaReviewChecklist - Things to do / stuff to consider reverting around -beta
X/Tagging - Bug tagging
X/PackageNotes - One of our packaging tools makes use of this