X

Differences between revisions 2 and 132 (spanning 130 versions)
Revision 2 as of 2007-06-01 02:07:49
Size: 4241
Editor: 71
Comment:
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 1: Line 1:
This page is to serve as a gathering point for various X-related specs, howtos, todo lists, and other assorted resources. #title Ubuntu-X Team
<<Include(X/MenuBar)>>
||<tablestyle="float:right; background: #FFFFFF; margin: 0 0 1em 1em;" style="padding:2.0em;"> {{https://launchpadlibrarian.net/10142846/xswat-192.png}} ||
Line 3: Line 5:
== Upcoming Features == === 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 5: Line 10:
 * dbus events to notify about input devices (no /dev/input/mice needed anymore)
 * X plans to move to fontconfig eventually, the core fonts stuff is planned to be more dynamic. X will start with an empty fontpath
=== 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]]
Line 8: Line 19:
== Driver Info == === Troubleshooting Techniques ===
<<Include(X/Troubleshooting)>>
Line 10: Line 22:
Intel
 * -intel - This new driver replaces -i810 and other intel drivers. We are including both -i810 and -intel in gutsy for now. Needs more testing before we drop -i810.
 * [[X/Troubleshooting|X Troubleshooting]] - How to analyze X bugs to make them solvable
 * [[X/Backtracing|X Backtracing]] - How to collect a backtrace for an X crash
 * [[X/Bisecting]] - Using bisection techniques to solve regressions or backport fixes
 * [[X/Testing/Touch]] - Touchscreen and multi-touch testing
 * [[X/Quirks|X Quirks]] - Fixes for some common hardware-specific issues
 * [[X/FixingCrashes|X Crash Fixing]] - How to fix X crashes
 * [[X/InterpretingIntelGpuDump]] - Ringbuffers, batchbuffers, and the meaning of `intel_gpu_dump` output
 * [[X/DebuggingWithValgrind]]
 * [[X/NonGraphicalBoot]] - Running X manually, without 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.
 * [[https://help.ubuntu.com/community/BootOptions|BootOptions]]
   * [[http://wiki.cchtml.com/index.php/Ubuntu_Feisty_Installation_Guide|fglrx installation on Ubuntu]]
 * DebuggingUsplash
 * [[X/Dev/DeviceTreeHWDetection]]
Line 13: Line 38:
NVidia
 * [http://nouveau.freedesktop.org/wiki/ nouveau] - the new, upcoming open source nvidia driver. Said to already have better 2D support than -nv, but needs integration and much testing.
=== 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
 * [[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]]
Line 16: Line 47:
Radeon/ATI
 * [https://bugs.launchpad.net/ubuntu/+source/linux-restricted-modules-2.6.22/+bug/115188 fglrx unavailable in gutsy] - the fglrx is confused by xserver 1.3's version number. A patch exists, but we don't think we can legally distribute a patched fglrx. This needs to be resolved for Gutsy.

== Teams ==

 * ["XSwat"] - Xorg bug triage team

== Blueprints ==

=== Current Specifications ===

These specifications are likely to be included in an upcoming Ubuntu release.

 * ["Xorg7.3Integration"] - Integrate Xorg 7.3 components, adopt config autodetection
 * ["DisplayConfigGTK"] - New GUI utility for configuring Xorg
 * ["BulletProofX"] - Failsafe mode when X doesn't start, with displayconfig-gtk to configure
 * ["CompositeByDefault"] - Switch default window manager from Metacity to Compiz, use Beryl effects
 * ["XorgCtrlAltBackspace"] - Disable the Ctrl-Alt-Bksp shortcut
 * ["compiz-mag"] - Compiz-based magnifying glass for low vision users

=== Unfinished Specifications ===

These specifications need further discussion and drafting, but could be acceptable for future Ubuntu releases if this is done.

 * ["MouseExtraButtons"] - Enable extra buttons present on Microsoft Explorer mice
 * [https://blueprints.launchpad.net/ubuntu/+spec/915resolutions-by-default 915resolutions by default] - 915resolutions should be automatically installed and configured when -intel is installed
 * ["UbuntuAutomaticKeyboardLayout"] - autoconfigure keyboard layout based on network information using Wheretero
 * [https://blueprints.launchpad.net/ubuntu/+spec/compiz-switch-on-panel compiz-switch-on-panel] - Panel button to turn compiz on/off
 * ["FglrxLegacySpec"] - provide legacy fglrx driver for older hardware
 * ["LaptopVideoOutputControl"] - automatic plug-and-play projector support
 * [https://blueprints.launchpad.net/ubuntu/+spec/logitech-g15-keyboard-drivers logitech-g15-keyboard-drivers] - G15 debs for Dapper exist; need added to universe
 * [https://blueprints.launchpad.net/ubuntu/+spec/multi-monitor-config multi-monitor-config] - ["DisplayConfigGTK"] provides Dual-head, this would extend it to three or more monitors.

=== Duplicate/Obsolete Specifications ===

These X-related specifications are either superseded by other specs, have already been implemented, or are otherwise no longer relevant and need to be marked as such:

 * [https://blueprints.launchpad.net/ubuntu/+spec/xorg-config-ui xorg-config-ui] - superseded by ["DisplayConfigGTK"] and ["UbuntuAutomaticKeyboardLayout"]
 * [https://blueprints.launchpad.net/ubuntu/+spec/autoconfigure-monitor-frequency autoconfigure-monitor-frequency] - superseded by ["DisplayConfigGTK"]
 * [https://blueprints.launchpad.net/ubuntu/+spec/dual-head-display-settings-gui dual-head-display-settings-gui] - superseded by ["DisplayConfigGTK"]
 * [https://blueprints.launchpad.net/ubuntu/+spec/dual-head-support dual-head-support] - superseded by ["DisplayConfigGTK"]
 * [https://blueprints.launchpad.net/ubuntu/+spec/laptop-docking] - superseded by ["DisplayConfigGTK"] and ["dbus/hal monitor notification"]
 * [https://blueprints.launchpad.net/ubuntu/+spec/monitor-detect-adjust monitor-detect-adjust] - superseded by ["DisplayConfigGTK"]


=== Historical Specifications ===

 * ["XRoadmap"] - Xorg 7.0, discusses the X modularization and XKB work (for Warty?)
 * ["XRoadmapDapper"] - Plans for continuing maintenance of X, Mesa packaging in Dapper
=== Development Foundations ===
 * [[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)