Troubleshooting

Differences between revisions 57 and 64 (spanning 7 versions)
Revision 57 as of 2012-04-14 02:29:15
Size: 2909
Editor: bryce
Comment:
Revision 64 as of 2017-11-18 18:25:00
Size: 4582
Editor: penalvch
Comment: 1) Mention xdiagnose install. 2) Reorder as folks may stop reading once reported. 3) RM general reporting as its distracting.
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
For hard bugs the analysis phase is the most important, and most challenging part of bug work. Depending on how the bug is behaving, there are multiple directions to investigate the issue. Here's some different approaches: ||<tablestyle="float:right; background: #FFFFFF; margin: 0 0 1em 1em;" style="padding:2.0em;"> {{https://launchpadlibrarian.net/10142846/xswat-192.png}} ||
||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents>>||
Line 4: Line 5:
=== Common Problems === = 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 [[https://help.ubuntu.com/community/ReportingBugs|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:

Booting
 * [[https://help.ubuntu.com/community/BootOptions|Boot Options]]
 * [[DebuggingKernelBoot|Debugging Kernel Boot Problems]]

Display Issues
 * [[X/Troubleshooting/3D|3D / GLX corruption and other issues]]
 * [[Kernel/Debugging/Backlight|Backlight issues]]
 * [[X/Troubleshooting/BlankScreen|Blank Screen on startup issues]]
 * [[X/i8xxUnsupported|i855 is Unsupported]] - Explanation of why i845, i855, i865, etc. chips aren't supported
 * [[X/Troubleshooting/HugeFonts|Fonts displayed way too big]]
 * [[X/Troubleshooting/Freeze|Freeze issues]]
 * [[X/Troubleshooting/IntelPerformance|Intel graphics performance issues]]
 * [[X/MonitorDetection|Monitor detection]]
 * [[X/Troubleshooting/Resolution|Resolution detection]]
 * [[X/Troubleshooting/VideoDriverDetection|Video driver detection]]
Line 9: Line 35:
 * [[X/Bugs/Transitions|X Transitions]] - Explanation for "installing xserver-xorg-core would break existing software"
 * [[X/Troubleshooting/XError|Program received an X Window System error]]
Line 10: Line 38:
 * [[X/Troubleshooting/XError|Program received an X Window System error]]
 * [[X/Bugs/Transitions|X Transitions]] - Explanation for "installing xserver-xorg-core would break existing software"

Display Issues
 * [[X/Troubleshooting/VideoDriverDetection|Video driver detection]]
 * [[X/MonitorDetection|Monitor detection]]
 * [[X/Troubleshooting/Resolution|Resolution detection]]
 * [[X/Troubleshooting/Freeze|Freeze issues]]
 * [[Kernel/Debugging/Backlight|Backlight issues]]
 * [[X/Troubleshooting/BlankScreen|Blank Screen on startup issues]]
 * [[X/Troubleshooting/HugeFonts|Fonts displayed way too big]]
 * [[X/Troubleshooting/IntelPerformance|Intel graphics performance issues]]
 * [[X/i8xxUnsupported|i855 is Unsupported]] - Explanation of why i845, i855, i865, etc. chips aren't supported
 * [[X/HybridGraphics|Hybrid Graphics is Unsupported]] - Not officially supported, but the community has workarounds
Line 26: Line 40:
 * [[X/Troubleshooting/HalBreaksKeyboardAndMouse|Keyboard and mouse quit working]]  * [[DebuggingKeyboardDetection|Keyboard detection]]
Line 28: Line 42:
 * [[DebuggingKeyboardDetection|Keyboard detection]]
Line 31: Line 44:
=== Troubleshooting Techniques ===
Booting
 * [[https://help.ubuntu.com/community/BootOptions|Boot Options]]
 * [[DebuggingKernelBoot|Debugging Kernel Boot Problems]]
 * [[X/NonGraphicalBoot|Non-Graphical Booting]] - Running X manually, without gdm
= 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:
{{{
ubuntu-bug xorg
}}}

== 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?

= Debugging techniques =

 * [[X/NonGraphicalBoot|Non-Graphical Booting]] - Running X manually, without a display manager (like lightdm, kdm, gdm...)
Line 39: Line 69:
Crashes and Freezes  Crashes and Freezes
Line 41: Line 71:
 * [[X/FixingCrashes|X Crash Fixing]] - How to fix X crashes
Line 46: Line 75:
 * [[X/Dev/DeviceTreeHWDetection|Device Tree]]
Line 48: Line 78:
 * [[X/Quirks|X Quirks]] - Fixes for some common hardware-specific issues
 * [[X/Dev/DeviceTreeHWDetection|Device Tree]]

= Triaging and tagging X bugs =

Please see [[https://wiki.ubuntu.com/X/Triaging|here]] for more on triaging X bugs, and [[https://wiki.ubuntu.com/X/Tagging|here]] for tagging.

= Fixing an X crash =

 * For more on this, please see [[https://wiki.ubuntu.com/X/FixingCrashes|here]].
 * [[X/Quirks|X Quirks]] - Fixes for some common hardware-specific issues.

= Other Resources =

 * [[https://help.ubuntu.com/community/Video|Video Resources]] at help.ubuntu.com
 * For installing [[https://help.ubuntu.com/community/BinaryDriverHowto/AMD|fglrx]] or [[https://help.ubuntu.com/community/BinaryDriverHowto/Nvidia|nvidia]] proprietary drivers.

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:

Booting

Display Issues

General Issues

Input Issues

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:

ubuntu-bug xorg

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?

Debugging techniques

Crashes and Freezes

Other Techniques

Triaging and tagging X bugs

Please see here for more on triaging X bugs, and here for tagging.

Fixing an X crash

  • For more on this, please see here.

  • X Quirks - Fixes for some common hardware-specific issues.

Other Resources


CategoryDebugging

X/Troubleshooting (last edited 2017-11-18 18:25:00 by penalvch)