Introduction

If you have a laptop and your touchpad is not detected please follow the steps described here: DebuggingTouchpadDetection.

Problems with external mouse detection typically fall into one of these categories:

1. Your mouse doesn't work at all.
2. Your mouse stops working after a while.
3. Some mouse buttons or scrollwheels don't work (as expected).

How to file a bug report

External mouse related bugs should initially be filed with the mouse plugged in, via a terminal:

ubuntu-bug xorg

This is so that the necessary debugging information is automatically attached to the report. Please ensure you have xdiangose installed, and you hit the Yes button in the window asking if you want to include additional debugging information. If the bug turns out to be a kernel bug or a bug in another package, bug triagers can re-assign the bug.

General information

For all bug categories the following general information should be provided:

1. Ensure you report the bug via ubuntu-bug xorg as outlined above.
2. What is the full manufacturer and model of your mouse.
3. How is your mouse connected to your PC: serial, PS/2, USB, USB wireless, etc.
4. What mechanism does your mouse use: roller ball, optical, trackball, etc.
5. How many physical buttons and scrollwheels does you mouse have?

In case your mouse doesn't work at all

1. Provide the general information.

2. If you have a PS/2 mouse make sure it was connected before booting Ubuntu, if you have a USB mouse unplug it and replug it to see if it starts working.

3. Enter the following command in a terminal:

   dmesg > ~/dmesg 

4. Attach as separate attachments to your bug report ~/dmesg and your /var/log/Xorg.0.log.

In case your mouse stops working after a while

1. Test if your mouse works in a second computer, or test a second mouse in your computer. Several issues are related to the specific hardware/Bios configuration, try to disable ACPI.

2. Provide the general information.

3. Direct after logging in to GNOME, KDE or Xfce open a terminal and enter the following commands:

   dmesg > ~/dmesg_boot
   cp /var/log/Xorg.0.log ~/Xorg.0.log 

4. Wait until your mouse stops working. If you have a USB mouse unplug it an replug it to see if it starts working again.
5. Open a Virtual Terminal by pressing Ctrl-Alt-F1.

6. Enter the following commands:

   LANG=C
   dmesg > ~/dmesg
   diff -ns ~/dmesg_boot ~/dmesg > ~/dmesg_diff
   cp /var/log/Xorg.0.log ~/Xorg.0.log_tmp
   diff -ns ~/Xorg.0.log ~/Xorg.0.log_tmp > ~/Xorg.0.log_diff 

7. Attach as separate attachments to your bug report ~/dmesg_boot, ~/dmesg_diff, ~/Xorg.0.log and ~/Xorg.0.log_diff.

In case some mouse buttons or scrollwheels don't work (as expected)

1. Provide the general information.

2. Open a terminal and enter the following commands:

   xmodmap -pp > ~/xmodmap-pp
   xev | grep -i button 

   Put the mouse cursor into the rectangle and push your mouse buttons. Mention in the bug report which button number is reported, e.g. left = 1, scrollwheel up = 4, horizontal scrollwheel left = 6, thumb button = 8, pinkie button = 9, ...

3. Attach as separate attachments to your bug report /var/log/Xorg.0.log and ~/xmodmap-pp.

Known bugs

Description of known issues, how to recognise them and stock responses/actions.

Open

CategoryBugSquad CategoryDebugging