Introduction

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

Problems with mouse detection typically fall into one off 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

Before filing a bug please check the list of known bugs at the end of this document.

Mouse related bugs should initially be filed against xserver-xorg-input-mouse. If the bug turns out to be a kernel bug or a bug in another package, bug triagers can assign the bug additionally to that package and mark the xserver-xorg-input-mouse task as invalid.

General information

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

1. What brand and model is your mouse.
   How is your mouse connected to your PC: serial, PS/2, USB, USB wireless, ...
   What mechanism does your mouse use: ball mouse, optical, trackball, ...
   How many physical buttons and scrollwheels does you mouse have?

2. For a USB mouse enter the following command on a terminal/console:

   $ lsusb -v > ~/lsusb-v 

3. Open a terminal/console and enter the following commands (minimal information as described in KernelTeamBugPolicies):

   $ uname -a > ~/uname-a
   $ cat /proc/version_signature > ~/version_signature
   $ sudo lspci -vvnn > ~/lspci-vvnn 

4. Attach ~/lsusb-v, ~/uname-a, ~/version_signature and ~/lspci-vvnn to the bug report as seperate attachments.

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/console:

   $ dmesg > ~/dmesg 

4. Attach ~/dmesg and your /var/log/Xorg.0.log to the bug report in seperate attachments.

In case your mouse stops working after a while

1. Test if your mouse works in a second computer. Several issues are related to your specific 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 ~/dmesg_boot, ~/dmesg_diff, ~/Xorg.0.log and ~/Xorg.0.log_diff to the bug report in separate attachments.

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 your /var/log/Xorg.0.log and ~/xmodmap-pp to the bug report in seperate attachments.

Known bugs

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

Open

CategoryBugSquad CategoryDebugging