Include(Debugging/Header)

Introduction

If you have a laptop and the hotkeys don't work please follow the steps described here: LaptopTestingTeam/HotkeyResearch.

Problems with keyboard detection typically fall into one off these categories:

1. Your keyboard doesn't work at all.
2. Your USB keyboard stops working after a while.
3. Some keys of your keyboard don't work (as expected).

How to file a bug report

Keyboard related bugs should initially be filed against xserver-xorg-input-keyboard. 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-keyboard task as invalid.

Anchor(generalinfo)

General information

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

1. What brand and model is your keyboard.BRHow is your keyboard connected to your PC: DIN, PS/2, USB, USB wireless, ...

2. For a USB keyboard 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 keyboard doesn't work at all

1. Provide the [#generalinfo general information].
2. If you have a PS/2 keyboard make sure it was connected before booting Ubuntu. To complete the steps below you will need to connect a USB keyboard.
3. If you have a USB keyboard unplug it an replug it to see if it starts working. If it doesn't you should have connected a PS/2 keyboard before booting Ubuntu in addition to your USB keyboard to complete the steps below.

4. Enter the following command in a terminal/console:

   $ dmesg > ~/dmesg 

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

In case your USB keyboard stops working after a while

For debugging this problem you either need a PS/2 keyboard or 2 computers in a network.BRIf the second machine runs Windows you need to install putty.exe from http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html.

1. Provide the [#generalinfo general information].
2. If you don't have a PS/2 keyboard install the openssh-server package on the machine with the keyboard problem. If you have a PS/2 keyboard connect it addition to your USB keyboard before booting Ubuntu.

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 USB keyboard stops working. Try if switching to a Virtual Terminal still works by pressing Ctrl-Alt-F1, are you able to login and enter commands? Try to unplug your USB keyboard and replug it to see if it starts working again.
5. If replugging or the Virtual Terminal works then goto step 6. If it doesn't work you should use either the PS/2 keyboard or the second machine in the LAN to login to your machine of which the keyboard stopped working. If your second machine is Linux use the command ssh user@host, if it is Windows use putty.

6. Type the following commands in the terminal:

   $ 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 keys of your keyboard don't work (as expected)

1. Provide the [#generalinfo general information].

2. Open a terminal/console and enter the following commands:

   $ xprop -root | grep XKB > ~/xkb
   $ gconftool-2 -R /desktop/gnome/peripherals/keyboard/kbd > ~/gconf 

3. Attach ~/xkb and ~/gconf to the bug report in seperate attachments.

CategoryBugSquad CategoryDebugging