Troubleshooting

Differences between revisions 46 and 63 (spanning 17 versions)
Revision 46 as of 2012-04-13 21:32:36
Size: 1619
Editor: static-50-53-79-63
Comment:
Revision 63 as of 2016-01-11 15:40:28
Size: 4749
Editor: penalvch
Comment: Shortened sect. text as stretched ToC.
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
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: <<Include(X/MenuBar)>>
||<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 3: Line 5:
 * [[X/Troubleshooting/Resolution|Resolution issues]]
 * [[X/Troubleshooting/HighCPU|High CPU issues]]
= 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]]
Line 6: Line 23:
 * [[X/i8xxUnsupported|i855 is Unsupported]] - Explanation of why i845, i855, i865, etc. chips aren't supported
 * [[X/Troubleshooting/HugeFonts|Fonts displayed way too big]]
Line 7: Line 26:
 * [[X/Troubleshooting/SingleColorScreen|Single color (brown/blue/etc.) screen on startup]]
 * [[X/Troubleshooting/HugeFonts|Fonts displayed way too big]]
 * [[X/Troubleshooting/XServerCrashOnResume|xserver crash on resume]]
 * [[X/Troubleshooting/OnlyLoadsVesa|Only loads vesa instead of correct driver]]
 * [[X/Troubleshooting/FglrxInteferesWithRadeonDriver|Switching between -fglrx and -ati drivers]]
 * [[X/Troubleshooting/NvidiaDriverSwitching|Switching between -nvidia and -nouveau drivers]]
Line 14: Line 27:
 * [[X/Troubleshooting/HalBreaksKeyboardAndMouse|Keyboard and mouse quit working]]  * [[X/MonitorDetection|Monitor detection]]
 * [[X/Troubleshooting/Resolution|Resolution detection]]
 * [[X/Troubleshooting/VideoDriverDetection|Video driver detection]]

General Issues
 * [[X/Glossary|Glossary]] - Common error messages and terminology
 * [[X/Troubleshooting/HighCPU|High CPU usage issues]]
 * [[X/Troubleshooting/HighMemory|High memory usage issues]]
 * [[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]]
 * [[DebuggingKernelSuspend|Suspend and Resume issues]]

Input Issues
 * [[DebuggingKeyboardDetection|Keyboard detection]]
Line 16: Line 42:
 * [[X/Troubleshooting/XError|Program received an X Window System error]]
 * [[X/Troubleshooting/NvidiaDriverMissingKernelDriver]]
 * [[X/MonitorDetection|Monitor Detection problems]]
 * [[DebuggingTouchpadDetection|Touchpad detection]]
Line 20: Line 44:
 * [[X/Troubleshooting/Other|Other common issues...]] = Reporting a confirmed X bug to Launchpad =
Line 22: Line 46:
== Troubleshooting Kernel Modesetting Issues == == Initial filing of the report ==
Line 24: Line 48:
The {{{drm.debug=0x04}}} kernel option can be used to get additional debugging data included in your {{{dmesg}}} output. First, one will want to familiarize themselves with how to report bugs effectively as per [[https://wiki.ubuntu.com/ReportingBugs|here]].

Once this is reviewed, please file a new bug report with Ubuntu via a terminal:
{{{
ubuntu-bug xorg
}}} Please ensure you have the package xdiagnose installed, and that you click the Yes button for attaching additional debugging information.

== Include developer information ==

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...)
 * [[X/Debugging/WirelessWithoutX|Wireless Without X]] - How to get a wireless network connection without X.
 * [[X/Debugging/WiredWithoutRouter|Direct Wired Without WAP]] - How to connect two laptops with direct ethernet cord.

Crashes and Freezes
 * [[X/Backtracing|X Backtracing]] - How to collect a backtrace for an X crash
 * [[X/InterpretingIntelGpuDump|Interpreting GPU Dumps]] - Ringbuffers, batchbuffers, and the meaning of `intel_gpu_dump` output
 * [[X/DebuggingWithValgrind|Valgrind]] - Debugging memory leaks

Other Techniques
 * [[X/Dev/DeviceTreeHWDetection|Device Tree]]
 * [[X/Bisecting|X Bisecting]] - Using bisection techniques to solve regressions or backport fixes
 * [[X/Testing/Touch]] - Touchscreen and multi-touch testing

= 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, one will want to familiarize themselves with how to report bugs effectively as per here.

Once this is reviewed, please file a new bug report with Ubuntu via a terminal:

ubuntu-bug xorg

Please ensure you have the package xdiagnose installed, and that you click the Yes button for attaching additional debugging information.

Include developer information

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)