X
|
Size: 3021
Comment:
|
Size: 1024
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 4: | Line 4: |
| This page is to serve as a gathering point for various X-related specs, howtos, todo lists, and other assorted resources of interest to developers and bleeding-edge users. | |
| Line 6: | Line 5: |
| === Basic Troubleshooting Resources === * [[http://ubuntuforums.org/forumdisplay.php?f=326|Absolute Beginner Talk Forum]] * [[X/Reporting|X Reporting]] - How to create good X bug reports * [[http://ubuntuforums.org/forumdisplay.php?f=332|Hardware & Laptops Support Forum]] |
|
| Line 7: | Line 10: |
| === Using X in Ubuntu === * [[X/Config]] - How to configure Xorg * [[X/InputHotplug]] - Using input devices (keyboards, tablets, mice, etc.) with HAL and input-hotplug * [[X/NonGraphicalBoot]] - Running X manually, without gdm |
=== Common Problems === <<Include(X/Troubleshooting, , from="=== Common Problems ===", to="=== Troubleshooting Techniques ===")>> |
| Line 12: | Line 13: |
| === Development of X for Ubuntu === * [[X/Drivers]] - Current status of X drivers * [[X/DesktopWishlist]] - Pending Xorg changes that would benefit Ubuntu Desktop * [[https://bugs.launchpad.net/~ubuntu-x-swat/+packagebugs|Packages XSwat maintains]] * [[X/Development|Ubuntu X Development]] * [[X/SwatTeam]] - Xorg bug triage team * [[X/Projects]] - Development, triaging and packaging projects * [[X/Blueprints]] - Specifications of interest for X * [[X/GitUsage]] - Instructions for using git * [[X/DriverDevelopment]] - Developing new Xorg drivers for Ubuntu |
=== Troubleshooting Techniques === <<Include(X/Troubleshooting, , from="=== Troubleshooting Techniques ===", to="^----")>> |
| Line 23: | Line 16: |
| === Troubleshooting Resources === * [[X/Debugging|X Debugging]] Handbook * I. [[X/Reporting|X Reporting]] - How to create good X bug reports * II. [[X/CommonErrors|X CommonErrors]] - Explanations for commonly seen error messages * III. [[X/Backtracing|X Backtracing]] - How to collect a backtrace for an X crash * IV. [[X/Triaging|X Triaging]] - How to ensure new X bug reports have enough info to troubleshoot * V. [[X/Troubleshooting|X Troubleshooting]] - How to analyze X bugs to make them solvable * VI. [[X/Quirks|X Quirks]] - Fixes for some common hardware-specific issues * VII. [[X/Upstreaming|X Upstreaming]] - Forwarding X bugs to their upstream project |
=== Configuration Recipes === <<Include(X/Config, , from="== Configuration Recipes ==", to="^=")>> |
| Line 33: | Line 19: |
| == Other Team Resources == * Documentation for developers can be found at [[UbuntuDevelopment|Ubuntu Development]] * The [[FoundationsTeam|Foundations Team]] cares for a variety of critical components needed for building and running the Ubuntu platform * The [[DesktopTeam|Desktop Team]] handles Gnome and related packages which go into the Ubuntu desktop installation * The [[InstallerTeam|Installer Team]] looks after the Ubuntu installer * The [[KernelTeam|Kernel Team]] is tasked with maintaining the Linux kernel in Ubuntu * The [[MobileTeam|Mobile Team]] is tasked with looking after the [[MobileTeam/Mobile|Mobile Project]] * The [[BugSquad|Bug Squad]] heroically handles the stream of bugs reported by Ubuntu users * [[MOTU]] (the Ubuntu Universe packaging team) packages and maintains Ubuntu's massive collection of community-supported software packages * The [[LaptopTestingTeam|Laptop Testing Team]] checks the hardware compatibility of Ubuntu with laptops * The [[AccessibilityTeam|Accessibility Team]] is here to help improve the accessibility technologies available with Ubuntu. |
=== Development Topics === <<Include(X/Dev, , from="== Development Topics ==", to="^=")>> ---- CategoryXTeam<<BR>> CategoryDesktopTeam<<BR>> CategoryUbuntuTeams<<BR>> |
|
Basic Troubleshooting Resources
X Reporting - How to create good X bug reports
Common Problems
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:
Booting
Display Issues
i855 is Unsupported - Explanation of why i845, i855, i865, etc. chips aren't supported
General Issues
Glossary - Common error messages and terminology
X Transitions - Explanation for "installing xserver-xorg-core would break existing software"
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
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
Other Techniques
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 here for more on triaging X bugs, and here for tagging.
Fixing an X crash
Other Resources
Video Resources at help.ubuntu.com
Troubleshooting Techniques
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:
Booting
Display Issues
i855 is Unsupported - Explanation of why i845, i855, i865, etc. chips aren't supported
General Issues
Glossary - Common error messages and terminology
X Transitions - Explanation for "installing xserver-xorg-core would break existing software"
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
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
Other Techniques
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 here for more on triaging X bugs, and here for tagging.
Fixing an X crash
Other Resources
Video Resources at help.ubuntu.com
Configuration Recipes
General Configuration
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
Display Configuration
Development Topics
Ubuntu-X Team - Joining the Ubuntu X.org team
Ubuntu-X Todo List - Tasks and escalated bugs needing attention by X maintainers
X Triaging - How to ensure new X bug reports have enough info to troubleshoot
X Architecture - High level architectural overview of X.org
Driver Development - Developing new Xorg drivers for Ubuntu
X Glossary - Explanations for confusing terms often seen in logs and error messages
X Blueprints - Specifications of interest for X
Using Git - Instructions for using git
X Bug Tags - Bug tagging
CategoryXTeam
CategoryDesktopTeam
CategoryUbuntuTeams
X (last edited 2016-01-10 21:04:44 by penalvch)