X

Differences between revisions 129 and 132 (spanning 3 versions)
Revision 129 as of 2012-04-13 22:57:43
Size: 3453
Editor: static-50-53-79-63
Comment: Merge contents of X/Debugging
Revision 132 as of 2012-04-13 23:46:17
Size: 3906
Editor: static-50-53-79-63
Comment:
Deletions are marked like this. Additions are marked like this.
Line 8: Line 8:
 * [[X/Config]] - How to configure Xorg /* the page being linked to needs to have each of its links checked for currency, accuracy, validity, and if a page passes those, then for readability and phrasing */
Line 10: Line 9:
 * [[https://help.ubuntu.com/community/BinaryDriverHowto|Binary Driver Howto]]
 * [[https://help.ubuntu.com/community/HybridGraphics|Hybrid Graphics Howto]]
Line 13: Line 10:
=== Advanced Topics ===
 * [[X/Triaging|X Triaging]] - How to ensure new X bug reports have enough info to troubleshoot
=== Common Problems ===
 * [[X/Bugs]] - Analysis of collection of similar bugs
 * [[X/Bugs/Transitions]] - Explanation for "installing xserver-xorg-core would break existing software"
 * [[X/i8xxUnsupported]] - Explanation of why i845, i855, i865, etc. chips aren't supported
 * [[X/HybridGraphics]] - How to make the most of your system with hybrid graphics
 * [[X/CommonErrors]]
 * [[X/ErrorMessages]]
 * [[Bugs/AtiDriver]]

=== Troubleshooting Techniques ===
<<Include(X/Troubleshooting)>>
Line 19: Line 26:
 * [[X/Bugs]] - Analysis of collection of similar bugs
 * [[X/Bugs/Transitions]] - Explanation for "installing xserver-xorg-core would break existing software"
 * [[X/i8xxUnsupported - Explanation of why i845, i855, i865, etc. chips aren't supported
 * [[X/NonGraphicalBoot]] - Running X manually, without gdm
 * [[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
 * [[X/HybridGraphics]] - How to make the most of your system with hybrid graphics
Line 31: Line 30:
 * [[X/CommonErrors]]
 * [[X/ErrorMessages]]
 * [[X/NonGraphicalBoot]] - Running X manually, without gdm
Line 35: Line 33:
 * [[Bugs/AtiDriver]]
Line 39: Line 36:
 * [[X/Dev/DeviceTreeHWDetection]]

=== Configuration Tips ===
 * [[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
Line 40: Line 44:
 * [[https://help.ubuntu.com/community/BinaryDriverHowto|Binary Driver Howto]]
 * [[https://help.ubuntu.com/community/HybridGraphics|Hybrid Graphics Howto]]
Line 42: Line 48:
 * [[X/SwatTeam]] - Joining the Ubuntu X.org team /* note that this is the main Ubuntu-X team page...also, it needs to be looked over for possible updates */
 * [[X/Development|Ubuntu X Development Info]]
   * [[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|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/SwatTeam]] - Joining the Ubuntu X.org team
 * [[X/Triaging|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|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
 * [[http://www.bryceharrington.org/X/Reports/ubuntu-x-swat/versions-current.html|Current Package Merge Status]]
 * [[X/Tagging]] - Bug tagging
 * [[X/PackageNotes]] - One of our packaging tools makes use of this

https://launchpadlibrarian.net/10142846/xswat-192.png

Basic Troubleshooting Resources

Common Problems

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:

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

Configuration Tips

Development Foundations

X (last edited 2016-01-10 21:04:44 by penalvch)