ThinkWiki - User contributions [en]

Problem with APS harddisk parking

2008-11-12T08:11:14Z

Koniu: drive list +1

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
When trying to [[How to protect the harddisk through APS|enable APS functionality]] by installing <tt>hdaps_protect</tt> and <tt>hdapsd</tt>, the following problems might occur.
|}

==Problem with unload capabilities check==
You may get the following kernel message when the disk is protected (e.g., via {{cmdroot|echo 1 > /sys/block/sda/queue/protect}}):

ata_scsi_issue_protect_fn(): unload support NOT reported..
scsi_protect_queue(): head park not requested, used standby!..

or

idedisk_issue_protect_fn(): unload support NOT reported..
ide_protect_queue(): head park not requested, used standby!..

{{WARN|Using HDAPS in the above state may cause frequent drive spin downs, thereby wearing out your hard disk.}}

If you see this, and you are sure that your drive actually does support unloading (all original drives sold with HDAPS-equipped ThinkPads do), one of the following solutions might help.

=== Drives which have this problem ===
* [[Hitachi Travelstar 7K60]] HTS726060M9AT00 on ThinkPad {{T43}}
* Fujitsu MHT2040AH (846C) on ThinkPad {{T41}} or {{R51}}

=== Solution for kernel 2.6.16 or later ===
The <tt>hdaps_protect</tt> patch for 2.6.16 now accepts the {{bootparm|protect_method|}} module parameter to override the
parking capability detection, which accepts the following numeric values:
*<tt>0</tt>: autodetect capability
*<tt>1</tt>: "unload the head even if the drive doesn't report it has this capability"
*<tt>2</tt>: "standby even if unload is supported"

Hence, depending on your machine type, and whether the module is built into the kernel or not, you can use one of the following options:

If disk driver is built into kernel, add the following to your kernel boot parameters (e.g. {{path|/boot/grub/menu.lst}}):
libata.protect_method=1
ide-disk.protect_method=1

If disk driver is built as module, add the following to your modprobe configuration (e.g., {{path|/etc/modprobe.conf}}):
options libata protect_method=1
options ide-disk protect_method=1

In both cases, if you know whether you use <tt>ide-disk</tt> or <tt>libata</tt>, you can drop the other line.

=== Solution for kernel 2.6.15 and older ===
The following patch overrides automatic protect capability detection.
<pre>
diff -u linux-2.6.15.hdaps/drivers/ide/ide-disk.c linux-2.6.15.hdaps/drivers/ide/ide-disk.c
--- linux-2.6.15.hdaps/drivers/ide/ide-disk.c 2006-01-18 07:11:54.000000000 +0000
+++ linux-2.6.15.hdaps/drivers/ide/ide-disk.c 2006-01-18 07:11:54.000000000 +0000
@@ -869,7 +869,7 @@
else
printk(KERN_DEBUG "idedisk_issue_protect_fn(): unload support NOT reported..\n");

- return ide_protect_queue(q, (drive->id->cfsse & (1 << 13)) ? 1: 0);
+ return ide_protect_queue(q, 1);
}

int idedisk_issue_unprotect_fn(request_queue_t *q)
diff -u linux-2.6.15.hdaps/drivers/scsi/libata-scsi.c linux-2.6.15.hdaps/drivers/scsi/libata-scsi.c
--- linux-2.6.15.hdaps/drivers/scsi/libata-scsi.c 2006-01-18 07:15:31.000000000 +0000
+++ linux-2.6.15.hdaps/drivers/scsi/libata-scsi.c 2006-01-18 07:15:31.000000000 +0000
@@ -661,7 +661,7 @@
printk(KERN_DEBUG "ata_scsi_issue_protect_fn(): unload support NOT reported..\n");

/* call scsi_protect_queue, requesting either unload or standby */
- return scsi_protect_queue(q, ata_id_has_unload(dev->id) ? 1 : 0);
+ return scsi_protect_queue(q, 1);
}

static int ata_scsi_issue_unprotect_fn(request_queue_t *q)
</pre>

==Problem with hard drive firmware==
Drivers other than those sold by IBM for APS-equipped ThinkPads may lack the head unload command.

===Detection===
If you see the following message in {{cmdroot|dmesg}} output after you have started the hdaps daemon, your drive lacks the unload feature (the converse is not true).

ide_protect_queue(): head NOT parked!..
ide_unprotect_queue(): No pending I/O, re-enabling power management..

You can also directly test for the head unload function by running the following Perl script:

<pre>
#!/usr/bin/perl
# Unload disk head on drives that support IDLE IMMEDIATE with the UNLOAD feature.
$dev="$ARGV[0]" or die "Specify device as argument.\n";
$HDIO_DRIVE_TASK=0x031e;
$args=pack("ccccccc",0xe1,0x44,0,0x4C,0x4E,0x55,0);
open(DEV,"<",$dev) or die "open(\"$dev\"): $!\n";
ioctl(DEV,$HDIO_DRIVE_TASK,$args) or die "Unload failed: $!\n";
</pre>

Due to a limitation of the Linux kernel libata system, it is not possible for this program to check if the unload worked. You'll have to listen for the characteristic sound (a faint click and a change in spinning sound) to learn if the unload worked.

===Solutions===
A firmware upgrade of your harddisk might add the missing function.

Go to the [http://www-307.ibm.com/pc/support/site.wss/document.do?lndocid=MIGR-62282 IBM harddrive firmware update utility page] and check if a firmware upgrade is available for your harddisk. IBM/Lenovo provides a bootdisk for easy firmware upgrade (~17MB download).

===Supported/unsupported harddrive firmwares===
Use {{cmdroot| hdparm -i /dev/hda}} to get your harddisk model name and firmware version (replace <tt>/dev/hda</tt> with the actual device for your hard drive).
On newer models, you need {{cmdroot| sdparm -i /dev/sda}} (or {{cmdroot| hdparm -I /dev/sda}} ) because of the SATA controller.

The following line is the important one in the output:

Model=HTS726060M9AT00, FwRev=MH4O'''A6GA''', SerialNo=MRHXXXXXXXXX

The last four characters of the '''FwRev''' actually marks the firmware version.

The table lists known working / not working firmware versions with [[HDAPS]]

{| cellspacing="0" cellpadding="2" border="1"
|- style="text-align:left;"
!Drive!!firmware!!park command output!!Source
|- style="text-align:left;vertical-align:top;"
| IC25N040ATCS04-0 || CA40'''A71A''' || not parked
|- style="text-align:left;vertical-align:top;"
| IC25N040ATMR04-0 || MO2O'''AD4A''' || not parked
|- style="text-align:left;vertical-align:top;"
| IC25N040ATMR04-0 || MO2O'''ADEA''' || not parked
|- style="text-align:left;vertical-align:top;"
| HTC426040G9AT00 || 00P4'''A0B4''' || parked
|- style="text-align:left;vertical-align:top;"
| HTC426060G9AT00 || 00P3'''A0B4''' || parked (method=1)
|- style="text-align:left;vertical-align:top;"
| HTS548040M9AT00 || MG20'''A5BA''' || not parked
|- style="text-align:left;vertical-align:top;"
| HTS548040M9AT00 || MG20'''A5HA''' || parked
|- style="text-align:left;vertical-align:top;"
| HTS548080M9AT00 || (TBA) || parked
|- style="text-align:left;vertical-align:top;"
| HTS541060G9AT00 || MB3I'''A60A''' || parked
|- style="text-align:left;vertical-align:top;"
| HTS726060M9AT00 || MH4O'''A6GA''' || parked
|- style="text-align:left;vertical-align:top;"
| Fujitsu MHT2040AH || 846C || parked, and specs mention UNLOAD capability
|- style="text-align:left;vertical-align:top;"
| Fujitsu MHT2040AH || 8471 || parked, and specs mention UNLOAD capability
|- style="text-align:left;vertical-align:top;"
| Fujitsu MHV2060AH/MHV2100AH/MHV2120AH || || specs mention UNLOAD capability
|- style="text-align:left;vertical-align:top;"
| Fujitsu MHV2120BH PL || 0084'''002A''' || parked || Lenovo
|- style="text-align:left;vertical-align:top;"
| Fujitsu MHY2250BH || 0084'''000D''' || parked (work fine) || Lenovo
|- style="text-align:left;vertical-align:top;"
| Fujitsu MHY2320BH G1 || || parked
|- style="text-align:left;vertical-align:top;"
| Seagate ST9160821A (160GB PATA) || 5MAA'''TJHL''' || parked (and reports UNLOAD capability)
|}

Installing Ubuntu 6.06 Flight 6 on a ThinkPad X60s

2007-02-17T16:49:16Z

Koniu:

= Installation of Ubuntu 6.06 Flight 6 on X60s (model 1705-24U) =
== Summary ==
=== What works out of the box ===

* Graphics adapter and accelerator (Intel GMA 950)
* USB
* Firewire
* Lid switch (LCD off when lid closed)
* Volume control, keyboard light and screen brightness control
* Hard disk laptop-mode (/proc/sys/vm/laptop-mode)
* LCD brightness auto-adjusts depending on AC or battery operation
* Fn buttons generate ACPI events (/var/log/acpid)
* EVDO device

=== What needs to be fixed ===

* Network adapter (Intel PRO/1000)
* Dual core processor
* Wireless
* Processor frequency scaling
* Suspend to RAM
* Suspend to disk
* SD card reader
* Sound
* Fingerprint scanner

== Installing Ubuntu 6.06 Flight 6 ==

IBM Rescue and Recovery disks (seven CDs) can be created using preinstalled Windows: All programs→ThinkVantage→Create Recovery Media. However, as long as recovery partition (called ''predesktop'' in BIOS) is left intact, system '''can be restored to factory default without having recovery CDs'''.

Ubuntu Flight 6 installer boots normally using external (USB) IBM DVD-ROM/CD-RW. SATA disk is recognised, Xorg 7.0, gdm and Gnome start normally. Xorg is configured with i810. DRI works (glxinfo|grep rendering). Networking works, eth0 uses e1000. ALSA sound worked after original installation, but at some point it stopped working as Dapper instantly had numerous updates, including kernel.

If you get garbled audio, try adding "options snd-hda-intel position_fix=3" to the module settings (eg. /etc/modprobe.d/alsa-base).

== Fixes after installation ==

=== SMP kernel ===
Flight 6 installs 2.6.15-*-386 kernel without SMP support. After installation of -686 kernel (which appears to be SMP) {{path|/proc/cpuinfo}} reports CPU0 and CPU1.

=== Wi-Fi ===
Intel 3945ABG wireless driver is available from http://ipw3945.sourceforge.net/. Wireless works after following QUICK INSTALL STEPS in provided INSTALL file. Automating driver loading works as described too, except that {{path|/etc/modprobe.d/ipw3945}} has to be used instead of the proposed {{path|/etc/modules.d/ipw3945}}.

=== CPU frequency scaling ===
After installation CPU0 switches between 1.5 GHz (full speed) and 1 GHz depending on load, but CPU1 stays at full speed. This is caused by a bug in <code>powernowd</code>, which is resolved in <code>powernowd</code> 0.97. By defaqult Flight 6 uses <code>powernowd</code> with the <code>userspace</code> governor. Changing to <code>ondemand</code> governor ({{path|/sysfs/devices/system/cpu/cpu0,1/cpufreq/scaling_governor}}) and thus using kernel part for frequency scaling (modules <code>speedstep_centrino</code> and <code>freq_table</code>) fixes this. To keep the change between reboots, install <code>sysfsutils</code> package and add the following lines to {{path|/etc/sysfs.conf}}:

devices/system/cpu/cpu0/cpufreq/scaling_governor=ondemand
devices/system/cpu/cpu1/cpufreq/scaling_governor=ondemand

<code>powernowd</code> can then be disabled from auto-starting by <code>rcconf</code>. It can also be <code>apt-get remove</code>'d, but that also wants to remove <code>ubuntu-desktop</code> metapackage.

If you do not want to change governers, uprading <code>powernowd</code> from 0.96 to 0.97 also resolves the problem. Simply download <code>powernowd</code> 0.97 [http://www.deater.net/john/powernowd.html], compile it and replace the <code>/usr/sbin/powernowd</code> executable with the version that you have just compiled, then restart powernowd:

/etc/init.d/powernowd stop
/etc/init.d/powernowd start

However be careful if the powernowd package is upgraded and the original faulty executable is replaced.

=== High pitch noise while on battery ===
X60s CPU produces the [[Problem_with_high_pitch_noises#Limit_ACPI_CPU_power_states|infamous high pitch noise]] when in lower-power ACPI states (a.k.a. C-states). To eliminate the noise maximum (i.e. lowest power) C-state had to be limited to C2. In {{path|/etc/sysfs.conf}}:

module/processor/parameters/max_cstate=2

Alternatively upgrade the BIOS to 1.06

== Unsolved ==
* Suspend to RAM (suspends, but crashes on resume)
* Suspend to disk (suspends, but crashes on resume)
* Sound
* SD card reader (driver in Linux kernel >=2.6.17)

== Not tested ==
* PCMCIA slots
* Embeded Security Subsystem (TCPA)
* Active Protection System (HDAPS)
* Modem

= Installation of Ubuntu 6.06 Flight 6 on X60s (model 170466U) =
== Specifications ==

* Processor - Intel Core Duo 1.66GHZ
* Hard Drive - SATA 80GB - HTS541080
* Networking - Integrated Wireless (Atheros)
* Sound - Intel

<pre>
0000:00:00.0 Host bridge: Intel Corporation Mobile Memory Controller Hub (rev 03)
0000:00:02.0 VGA compatible controller: Intel Corporation Mobile Integrated Graphics Controller (rev 03)
0000:00:02.1 Display controller: Intel Corporation Mobile Integrated Graphics Controller (rev 03)
0000:00:1b.0 0403: Intel Corporation 82801G (ICH7 Family) High Definition Audio Controller (rev 02)
0000:00:1c.0 PCI bridge: Intel Corporation 82801G (ICH7 Family) PCI Express Port 1 (rev 02)
0000:00:1c.1 PCI bridge: Intel Corporation 82801G (ICH7 Family) PCI Express Port 2 (rev 02)
0000:00:1c.2 PCI bridge: Intel Corporation 82801G (ICH7 Family) PCI Express Port 3 (rev 02)
0000:00:1c.3 PCI bridge: Intel Corporation 82801G (ICH7 Family) PCI Express Port 4 (rev 02)
0000:00:1d.0 USB Controller: Intel Corporation 82801G (ICH7 Family) USB UHCI #1 (rev 02)
0000:00:1d.1 USB Controller: Intel Corporation 82801G (ICH7 Family) USB UHCI #2 (rev 02)
0000:00:1d.2 USB Controller: Intel Corporation 82801G (ICH7 Family) USB UHCI #3 (rev 02)
0000:00:1d.3 USB Controller: Intel Corporation 82801G (ICH7 Family) USB UHCI #4 (rev 02)
0000:00:1d.7 USB Controller: Intel Corporation 82801G (ICH7 Family) USB2 EHCI Controller (rev 02)
0000:00:1e.0 PCI bridge: Intel Corporation 82801 Mobile PCI Bridge (rev e2)
0000:00:1f.0 ISA bridge: Intel Corporation 82801GBM (ICH7-M) LPC Interface Bridge (rev 02)
0000:00:1f.1 IDE interface: Intel Corporation 82801G (ICH7 Family) IDE Controller (rev 02)
0000:00:1f.2 0106: Intel Corporation 82801GBM/GHM (ICH7 Family) Serial ATA Storage Controllers cc=AHCI (rev 02)
0000:00:1f.3 SMBus: Intel Corporation 82801G (ICH7 Family) SMBus Controller (rev 02)
0000:02:00.0 Ethernet controller: Intel Corporation 82573L Gigabit Ethernet Controller
0000:03:00.0 Ethernet controller: Atheros Communications, Inc. AR5212 802.11abg NIC (rev 01)
0000:15:00.0 ffff: Ricoh Co Ltd RL5c476 II (rev ff)
0000:15:00.1 ffff: Ricoh Co Ltd R5C552 IEEE 1394 Controller (rev ff)
0000:15:00.2 ffff: Ricoh Co Ltd R5C822 SD/SDIO/MMC/MS/MSPro Host Adapter (rev ff)
</pre>

== Summary ==

=== What works out of the box ===
* Graphics adapter and accelerator (Intel GMA 950)
* USB
* Lid switch (LCD off when lid closed)
* Volume control, keyboard light and screen brightness control
* LCD brightness auto-adjusts depending on AC or battery operation
* Fn buttons generate ACPI events (/var/log/acpid)
* Sound, using the snd_hda_intel driver

=== What doesn't work out of the box===

* Network adapter (Intel PRO/1000)
* Suspend to ram
* Suspend to disk
* Wireless
** ''atheros driver in linux-restricted-modules-2.6.15-20-686 will not work, see below for instructions''

=== Sound ===
* The sound is very clean, loud enough and there doesn't appear to be any backround machine noise escaping through the card.

=== Annoyances ===
* '''Battery life''' - With the 8 cell battery Lenovo boasts that it gets about 8 hours of battery life. So far in Linux it is getting about 5-6. Need to mess around with more power saving options. To improve battery life rmmod uhci_hcd (disable USB).
* The Hitachi serial ATA harddrive makes a faint but noticeable high pitched clicking sound when running off the battery.
* The e1000 network driver currently has issues with the x60s. If you're having issues with eth0 appearing, give this bug report a read:
http://sourceforge.net/tracker/index.php?func=detail&aid=1474679&group_id=42302&atid=447449

== What works after installation ==

=== Wireless ===

* The X60s comes with an EVDO modem in the USA model of the laptop. The device seems to register correctly with usbserial (when given the correct options).
* The X60s comes with Bluetooth support it appears to work out of box.
* Unlike the earlier versions of the X60s this one uses the Atheros driver.
* The LED wireless indicator light does not switch on when wireless is enabled (unless you use ndiswrapper)
* The wireless toggle switch does nothing (although it appears to turn the led on momentarily)

==== EVDO ====

[[Verizon_1xEV-DO_WWAN|Some general EVDO info here]].

First we detect the device with lsusb. It should be the Sierra Wireless device unless IBM/Lenova changes it mid-stream:
<pre>
Bus 005 Device 003: ID 17ef:1000
Bus 005 Device 001: ID 0000:0000
Bus 002 Device 003: ID 1199:0218 Sierra Wireless, Inc.
Bus 002 Device 001: ID 0000:0000
Bus 003 Device 001: ID 0000:0000
Bus 001 Device 001: ID 0000:0000
Bus 004 Device 002: ID 0a5c:2110 Broadcom Corp.
Bus 004 Device 003: ID 0483:2016 SGS Thomson Microelectronics Fingerprint ReaderBus 004 Device 001: ID 0000:0000
</pre>

Then we modprobe the driver with the previously discovered values:
<pre>
modprobe usbserial vendor=0x1199 product=0x0218
</pre>

dmesg should show something like this:
<pre>
[17187980.292000] drivers/usb/serial/usb-serial.c: USB Serial support registered for generic
[17187980.292000] usbserial_generic 2-1:1.0: generic converter detected
[17187980.292000] usb 2-1: generic converter now attached to ttyUSB0
[17187980.292000] usb 2-1: generic converter now attached to ttyUSB1
[17187980.292000] usb 2-1: generic converter now attached to ttyUSB2
[17187980.292000] usbcore: registered new driver usbserial_generic
[17187980.292000] drivers/usb/serial/usb-serial.c: USB Serial Driver core
</pre>

You can have the driver automatically load by adding the following line to your /etc/modules file:
<pre>
usbserial vendor=0x1199 product=0x0218
</pre>

Your modem is now loaded and ready to go on /dev/ttyUSB0. Call your service provider for details.

==== Bluetooth ====
Bluetooth should work out of box. Ensure that you have the 'bluez-utils' package installed and then you can query your device with 'hciconfig -a':
<pre>
hci0: Type: USB
BD Address: 00:16:EC:B2:D1:90 ACL MTU: 1017:8 SCO MTU: 64:8
UP RUNNING PSCAN ISCAN
RX bytes:375 acl:0 sco:0 events:17 errors:0
TX bytes:319 acl:0 sco:0 commands:17 errors:0
Features: 0xff 0xff 0x8d 0xfe 0x9b 0xfd 0x00 0x80
Packet type: DM1 DM3 DM5 DH1 DH3 DH5 HV1 HV2 HV3
Link policy: RSWITCH HOLD SNIFF PARK
Link mode: SLAVE ACCEPT
Name: 'makho-0'
Class: 0x3e0100
Service Classes: Networking, Rendering, Capturing
Device Class: Computer, Uncategorized
HCI Ver: 2.0 (0x3) HCI Rev: 0x206c LMP Ver: 2.0 (0x3) LMP Subver: 0x415c Manufacturer: Broadcom Corporation (15)
</pre>

Note:
Bringing the device down with 'hciconfig hci0 down' will not disable the bluetooth light on the laptop. However you can disable the device entirely with the fn-f5 key combo. The device will vanish from hciconfig and the light will go out.

==== compiling the madwifi drivers from source - WORKS :) ====

* untar the latest drivers from teh madwifi website - http://sourceforge.net/projects/madwifi/
* prepare build environment
apt-get install build-essential
apt-get install linux-headers-`uname -r`
apt-get install sharutils
* in the madwifi directory build and install the module
make
make install
modprobe ahc_pci

==== WPA1 encryption - WORKS :) ====
* In order for this to work you '''must''' compile the wpa_supplicant from source.
** follow these instructions carefully - http://madwifi.org/wiki/UserDocs/802.11i

==== ndiswrapper - WORKS :) ====
* Why use ndiswrapper instead? Madwifi would not allow me to connect to 5+ wireless networks I had access to. So, if you too have this problem, try ndiswrapper, if not, support open source and use madwifi.
* Download and install ndiswrapper
* Download the driver and use wine to extract it (or another machine):
** http://www-307.ibm.com/pc/support/site.wss/document.do?lndocid=MIGR-52527
* Goto the WINXP_2K directory where the driver is and do the following:
ndiswrapper -i NET5211.INF
modprobe ndiswrapper
* Your wireless card should now be the wlan0 interface, and the wireless light should light up!

== Fingerprint reader ==
The X60s comes with a small USB fingerprint reader attached below the mouse buttons. It appears as a USB device. Here's the relevant output of lsusb:
<pre>
Bus 004 Device 003: ID 0483:2016 SGS Thomson Microelectronics Fingerprint Reader
</pre>

It may be possible to use this device with the instructions found on the following two websites:
http://pavelmachek.livejournal.com/25060.html
http://66.102.7.104/search?q=cache:9VkP3DzVdoYJ:linuxbiometrics.com/modules/newbb/viewtopic.php%3Fviewmode%3Dflat%26order%3DASC%26topic_id%3D66%26forum%3D1%26move%3Dnext%26topic_time%3D1122861328%26PHPSESSID%3D677fd91c80089e4ba3edd25fbbbbc2f8+SGS+Thomson+Microelectronics+Fingerprint+Reader+Bus&hl=en&gl=us&ct=clnk&cd=5&client=firefox

== Special Keys ==

{|
|+ Post-install support for special keys in Ubuntu Linux 6.06 Flight 6
! Keys !! function !! status

|-
| {{key|Fn}}{{key|F2}} || lock screen || does not work
|-
| {{key|Fn}}{{key|F3}} || blank screen || does not work
|-
| {{key|Fn}}{{key|F4}} || suspend to ram || does not work
|-
| {{key|Fn}}{{key|F5}} || switch bluetooth || works
|-
| {{key|Fn}}{{key|F7}} || switch display || does not work
|-
| {{key|Fn}}{{key|F8}} || switch between touchpoint and touchpad || not applicable
|-
| {{key|Fn}}{{key|F9}} || eject from dock || not tested
|-
| {{key|Fn}}{{key|F12}} || suspend to disk || does not work
|-
| {{key|Fn}}{{key|END}} || reduce brightness || works
|-
| {{key|Fn}}{{key|HOME}} || increase brightness || works
|-
| {{key|Fn}}{{key|PGUP}} || keyboard light || works
|}

=Links=
*This guide is listed at the [http://tuxmobil.org/ibm.html TuxMobil Linux laptop and notebook installation survey (IBM/Lenovo)].

[[Category:X60s]]

How to get special keys to work

2007-02-12T11:14:42Z

Koniu: x60s multimedia keys

==Overview==
{| {{prettytable}}
! key !! standard function !! tools supporting key{{footnote|1}} !! configurability{{footnote|2}} !! remarks
|-
| {{key|Fn}} || - || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]] || full || on release without completed key combination
|-
| {{key|Fn}}{{key|F1}} || - || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| {{key|Fn}}{{key|F2}} || lock screen || [[#ibm-acpi events|ibm-acpi]] || full || in models from T/X/Z 60 onwards
|-
| {{key|Fn}}{{key|F3}} || blank screen || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full ||
|-
| {{key|Fn}}{{key|F4}} || suspend to ram || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full || may generate ACPI event when not enabled in the ibm-acpi hotkey mask
|-
| {{key|Fn}}{{key|F5}} || switch bluetooth || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full || in models starting from 2002
|-
| {{key|Fn}}{{key|F6}} || - || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| {{key|Fn}}{{key|F7}} || switch display || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]], [[#tpb configuration|tpb]] || additional actions ||
|-
| {{key|Fn}}{{key|F8}} || toggle display expansion || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]], [[#tpb configuration|tpb]] || additional actions ||
|-
| {{key|Fn}}{{key|F9}} || eject from dock || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full ||
|-
| {{key|Fn}}{{key|F10}} || - || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| {{key|Fn}}{{key|F11}} || - || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| {{key|Fn}}{{key|F12}} || hibernate || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full || may generate ACPI event when not enabled in the ibm-acpi hotkey mask
|-
| {{key|Fn}}{{key|Home}} / {{key|Fn}}{{key|Pos1}} || brightness up || [[#ibm-acpi events|ibm-acpi]], [[#tpb configuration|tpb]], [[KMilo]] || additional actions ||
|-
| {{key|Fn}}{{key|End}} || brightness down || [[#tpb configuration|tpb]], [[KMilo]] || additional actions ||
|-
| {{key|Fn}}{{key|PageUp}} || toggle thinklight || [[#tpb configuration|tpb]], [[KMilo]] || additional actions ||
|-
| {{key|Fn}}{{key|Space}} || toggle zoom || [[#tpb configuration|tpb]], [[KMilo]] || full ||
|-
| {{key|Fn}}{{key|Ins}} || - || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| {{key|Fn}}{{key|Del}} || - || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| {{key|Fn}}{{key|Backspace}} || - || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| {{key|NumLock}} || - || [[#xmodmap configuration|xmodmap]] || make working ||
|-
| {{key|Windows}} || - || [[#xmodmap configuration|xmodmap]] || remapping ||
|-
| {{ibmkey|Access IBM|#495988}} or {{ibmkey|ThinkPad|#494949}} || help application || [[#tpb configuration|tpb]], [[KMilo]] || full ||
|-
| {{ibmkey|Home|#494949}} || open web browser || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]], [[KMilo]] || full || only {{A30}}, {{A30p}}, {{A31}}, {{A31p}} and ext. keyboards
|-
| {{ibmkey|Search|#494949}} || open search application || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]], [[KMilo]] || full || only {{A30}}, {{A30p}}, {{A31}}, {{A31p}} and ext. keyboards
|-
| {{ibmkey|Mail|#494949}} || open mail application || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]], [[KMilo]] || full || only {{A30}}, {{A30p}}, {{A31}}, {{A31p}} and ext. keyboards
|-
| {{ibmkey|Favorites|#494949}} || open favorites || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]] || full || only {{A30}}, {{A30p}}, {{A31}}, {{A31p}} and ext. keyboards
|-
| {{ibmkey|Reload|#494949}} || reload web page || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]] || full || only {{A30}}, {{A30p}}, {{A31}}, {{A31p}} and ext. keyboards
|-
| {{ibmkey|Abort|#494949}} || abort loading page || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]] || full || only {{A30}}, {{A30p}}, {{A31}}, {{A31p}} and ext. keyboards
|-
| {{ibmkey|Backward|#494949}} || previous page || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]] || full || ext. keyboards and ThinkPads starting from 2002
|-
| {{ibmkey|Forward|#494949}} || next page || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]] || full || ext. keyboards and ThinkPads starting from 2002
|-
| {{ibmkey|Volume up|#494949}} || volume up || [[#tpb configuration|tpb]], [[KMilo]] || additional actions ||
|-
| {{ibmkey|Volume down|#494949}} || volume down || [[#tpb configuration|tpb]], [[KMilo]] || additional actions ||
|-
| {{ibmkey|Volume mute|#494949}} || mute volume || [[#tpb configuration|tpb]], [[KMilo]] || additional actions ||
|-
| {{ibmkey|Play/Pause|#494949}} || start/pause playback || [[#xmodmap configuration|xmodmap]] || full || {{X60s}} (Fn+Arrow Down)
|-
| {{ibmkey|Stop|#494949}} || stop playback || [[#xmodmap configuration|xmodmap]] || full || {{X60s}} (Fn+Arrow Up)
|-
| {{ibmkey|Next|#494949}} || play next || [[#xmodmap configuration|xmodmap]] || full || {{X60s}} (Fn+Arrow Right)
|-
| {{ibmkey|Previous|#494949}} || play previous || [[#xmodmap configuration|xmodmap]] || full || {{X60s}} (Fn+Arrow Left)
|-
| {{ibmkey|Power|#494949}} || shutdown || [[#ibm-acpi events|ibm-acpi]] || full || triggered on pressing 3secs, but notebook goes off on 5sec press
|-
| Display lid || blank screen || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| Ultrabay lid || announce ultrabay change || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| Dock eject || eject from dock || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| {{ibmkey|Tablet power|#494949}} || shutdown || [[#ibm-acpi events|ibm-acpi]] || full || triggered on pressing 3secs, but notebook goes off on 5sec press
|-
| {{ibmkey|Tablet orientation|#494949}} || rotates screen || [[#Mapping keys with setkeycodes|setkeycodes]] || full ||
|-
| {{ibmkey|Tablet shortcut|#494949}} || shortcut menu || [[#Mapping keys with setkeycodes|setkeycodes]] || full ||
|-
| {{ibmkey|Tablet Esc|#494949}} || esc key || [[#Mapping keys with setkeycodes|setkeycodes]] || full ||
|-
| {{ibmkey|Tablet Enter|#494949}} || enter key || [[#mapping keys with setkeycodes|setkeycodes]] || full ||
|-
| {{ibmkey|Tablet Up|#494949}} || up key || [[#Mapping keys with setkeycodes|setkeycodes]] || full ||
|-
| {{ibmkey|Tablet Down|#494949}} || down key || [[#Mapping keys with setkeycodes|setkeycodes]] || full ||
|-
| {{ibmkey|Tablet (unlabeled)|#494949}} || down key || [[#Mapping keys with setkeycodes|setkeycodes]] || full ||
|}

==Triggering key events==
===ibm-acpi events===
Some of the following events require a {{cmdroot|echo enable,0xffff >/proc/acpi/ibm/hotkey}} in order to make acpi able to get information on them. These events can be used to [[How to configure acpid|configure acpid]].

{| {{prettytable}}
|+ events triggered by [[ibm-acpi]] for {{path|/etc/acpi/events}} files.
! key !! event
|-
| {{key|Fn}}{{key|F1}} || ibm/hotkey HKEY 00000080 00001001
|-
| {{key|Fn}}{{key|F2}} || ibm/hotkey HKEY 00000080 00001002
|-
| {{key|Fn}}{{key|F3}} || ibm/hotkey HKEY 00000080 00001003
|-
| {{key|Fn}}{{key|F4}} || ibm/hotkey HKEY 00000080 00001004
|-
| {{key|Fn}}{{key|F5}} || ibm/hotkey HKEY 00000080 00001005
|-
| {{key|Fn}}{{key|F6}} || ibm/hotkey HKEY 00000080 00001006
|-
| {{key|Fn}}{{key|F7}} || ibm/hotkey HKEY 00000080 00001007
|-
| {{key|Fn}}{{key|F8}} || ibm/hotkey HKEY 00000080 00001008
|-
| {{key|Fn}}{{key|F9}} || ibm/hotkey HKEY 00000080 00001009
|-
| {{key|Fn}}{{key|F10}} || ibm/hotkey HKEY 00000080 0000100a
|-
| {{key|Fn}}{{key|F11}} || ibm/hotkey HKEY 00000080 0000100b
|-
| {{key|Fn}}{{key|F12}} || ibm/hotkey HKEY 00000080 0000100c
|-
| {{key|Fn}}{{key|Backspace}} || ibm/hotkey HKEY 00000080 0000100d
|-
| {{key|Fn}}{{key|Ins}} || ibm/hotkey HKEY 00000080 0000100e
|-
| {{key|Fn}}{{key|Del}} || ibm/hotkey HKEY 00000080 0000100f
|-
| {{key|Fn}}{{key|Home}}/{{key|Fn}}{{key|Pos1}} || ibm/hotkey HKEY 00000080 00001010
|-
| {{ibmkey|Power|#494949}} || button/power PWRF 00000080 xxxxxxxx
|-
| Display lid || button/lid LID 00000080 xxxxxxxx
|-
| Ultrabay eject || ibm/bay MSTR 00000003 00000000
|-
| Ultrabay inserted || ibm/bay MSTR 00000001 00000000
|-
| Dock eject || ibm/dock GDCK 00000003 00000001
|-
| Wireless switch || ibm/hotkey HKEY 00000080 00007000
|}

=== Pure ACPI events ===

A few keys can generate ACPI events of their own on certain ThinkPads, as long as they are masked off in the ibm-acpi hotkey's mask (or the hotkey feature is disabled in ibm-acpi).

If you want the ThinkPad's BIOS and ACPI methods to know about these keys being pressed, you probably want to leave them masked out from ibm-acpi, and use their non-HKEY events listed below, instead.

{| {{prettytable}}
|+ events triggered by ACPI when hotkey is masked out or disabled.
! key !! event
|-
| {{key|Fn}}{{key|F4}} || button/sleep SLPB 00000080 00000001
|-
| {{key|Fn}}{{key|F12}} || ibm/hotkey HKEY 00000080 0000100c
|}

===tpb configuration===
{| {{prettytable}}
|+ configuration keywords for [[tpb]] (to put in {{path|/etc/tpbrc}})
! key !! config keyword
|-
| {{ibmkey|Access IBM|#495988}} or {{ibmkey|ThinkPad|#494949}} || THINKPAD
|-
| {{ibmkey|Home|#494949}} || HOME
|-
| {{ibmkey|Search|#494949}} || SEARCH
|-
| {{ibmkey|Mail|#494949}} || MAIL
|-
| {{ibmkey|Favorites|#494949}} || FAVORITES
|-
| {{ibmkey|Reload|#494949}} || RELOAD
|-
| {{ibmkey|Abort|#494949}} || ABORT
|-
| {{ibmkey|Backward|#494949}} || BACKWARD
|-
| {{ibmkey|Forward|#494949}} || FORWARD
|-
| {{key|Fn}} || FN
|-
| {{key|Fn}}{{key|Space}} || CALLBACK (zoom on/off)
|-
| {{key|Fn}}{{key|PageUp}} || CALLBACK (thinklight on/off)
|-
| {{key|Fn}}{{key|F7}} || CALLBACK (display lcd/crt/both)
|-
| {{key|Fn}}{{key|F8}} || CALLBACK (expand on/off)
|-
| {{key|Fn}}{{key|Home}} / {{key|Fn}}{{key|Pos1}} || CALLBACK (brightness <percent>)
|-
| {{key|Fn}}{{key|End}} || CALLBACK (brightness <percent>)
|-
| {{ibmkey|Volume up|#494949}} || CALLBACK (volume <percent>)
|-
| {{ibmkey|Volume down|#494949}} || CALLBACK (volume <percent>)
|-
| {{ibmkey|Volume mute|#494949}} || CALLBACK (mute on/off)
|}

To all parameter keywords should be assigned the full path to the executables supposed to be started on key press.
The exectable provided for the CALLBACK keyword should take the parameters given in parentheses and act according to them.
If you want to use xmodmap for the HOME, SEARCH, MAIL, FAVORITES, RELOAD, ABORT, BACKWARD, FORWARD and FN keys you should
provide a <tt>XEVENTS OFF</tt> in your {{path|/etc/tpbrc}}.
You can use an appropriate executable to [[How to inject fake keystrokes|inject fake keystrokes]].

For Debian users, tpb is started from {{path|/etc/X11/Xsession.d/90tpb}}.

'''Sound Button configuration'''

''Note: Tested on T60p with Ubuntu 6.06 LTS''

Most Thinkpads have a hardware sound mixer, thus the volumes buttons should work without configuration. However, this change is not reflected in the software mixer. tpb has a switch to enable software mixer support via OSS. The manual recommends this only for devices without a hardware mixer, but it also works for other hadware mixer enabled devices, even with the ALSA system. Just put MIXER ON in your {{path|/etc/tpbrc}} file and you can see the effect immediately in any ALSA mixer (e.g. kmix). For this to work you need write permissions to {{path|/dev/nvram}}.

''Note: Tested on X21 with Ubuntu 6.06 LTS''

On the ThinkPad X21 (and maybe some other older models) ACPI causes problems with tpb. On an X21 using acpi the volume buttons would work occasionally, and the OSD for tpb functions would rarely work. If a volume buttons was pressed too often, sometimes the computer would enter a low power (unplugged state) and would require a reboot. The solution is to use APM instead of ACPI. Instructions can be found in [[How_to_make_APM_work]].

===KMilo configuration===
The programs to be executed by [[KMilo]] are configured via the KDE Control Center (<tt>kcontrol</tt>), under <tt>System Administration --> IBM Thinkpad Laptop</tt>. Note that you can use appropriate commands to [[How to inject fake keystrokes|inject fake keystrokes]].

===xmodmap configuration===
xmodmap enables you to edit the modifier map and keymap tables that are used to translate keycodes into keysyms.
Understood? Well, basically it allows you to give the X server a dictionary for the translation of keycodes like "97" into more human readable synonyms like "Home". This way xmodmap allows you to make the special keys of your keyboard known to X applications.

To discover the keycode that a certain keypress produces, use the tool {{cmduser|xev}}

Usually you should write your keycode-keysym associations into the file {{path|~/.Xmodmap}}. This file is usually read by the X session startup scripts of your system, so that the mappings automatically get included everytime you run the X server.

The {{path|~/.Xmodmap}} lines for our purpose are in the form of
keycode <keycode> = <keysym>

Load the assocation using the command

{{cmduser|xmodmap ~/.Xmodmap}}

(some configurations do this automatically upon X startup).

The following table shows the keycodes generated by the ThinkPad special keys and sensible keysyms to assign them to.
{| {{prettytable}}
|+ keycodes and recommended keysyms
! key !! keycode !! keysym
|-
| {{ibmkey|Access IBM|#495988}} or {{ibmkey|ThinkPad|#494949}} || 159 || XF86LaunchA
|-
| {{ibmkey|Backward|#494949}} || 234 || XF86Back or F19
|-
| {{ibmkey|Forward|#494949}} || 233 || XF86Forward or F20
|-
| {{ibmkey|Play/Pause|#494949}} || 162 || XF86AudioPlay
|-
| {{ibmkey|Stop|#494949}} || 164 || XF86AudioStop
|-
| {{ibmkey|Next|#494949}} || 153 || XF86AudioNext
|-
| {{ibmkey|Previous|#494949}} || 144 || XF86AudioPrev
|-

| {{ibmkey|Home|#494949}} || 178 || XF86HomePage
|-
| {{ibmkey|Search|#494949}} || 229 || XF86Search
|-
| {{ibmkey|Mail|#494949}} || 236 || XF86Mail
|-
| {{ibmkey|Favorites|#494949}} || 230 || XF86AddFavorite or XF86Favorites
|-
| {{ibmkey|Reload|#494949}} || 231 || XF86Reload
|-
| {{ibmkey|Abort|#494949}} || 232 || XF86Stop
|-
| {{key|Fn}} || 227 || F35
|}

Note: if you are running [[tpb]] you might need to add the line <tt>XEVENTS=off</tt> into your tpbrc to stop it from grabbing the key events and allow them to get through to X instead.

Note: XF86Forward and XF86Back do not work correctly in Firefox. You may want to map them to F19 and F20 instead if you use Firefox.

=====Enabling the Windows and Menu Keys=====
On some systems the Windows and Menu keys may not be recognized. You can enable then by
making the following changes:

keycode 115 = F13
keycode 227 = F35

F13 and F35 are used for the Windows and and Menu keys respectively. Labelling keycpode 227 as "Menu" may conflict with the right-mouse-click event.

=====Using Caps Lock as Super L (Windows key)=====
You can easily use Caps Lock as Win key by adding the following in your ~/.Xmodmap:
! No Caps Lock
clear lock
! Caps Lock as Win key
add mod4 = Caps_Lock
=====NumLock=====
On the ThinkPad {{600}}, {{T20}}, {{T21}}, {{T22}}, {{T30}}, {{X20}}, {{X21}}, {{X31}}, {{T43}}, {{R51}}, {{R52}} and possibly other models, X does not recognize the keycode for {{key|NumLk}} = {{key|Shift}}+{{key|ScrLk}}. To fix this, add the following to {{path|~/.Xmodmap}} in your home directory or {{path|/etc/X11/Xmodmap}} and run <tt>xmodmap</tt>, ex: <tt>xmodmap ~/.Xmodmap</tt>:
keycode 77 = Num_Lock

===Mapping keys with setkeycodes===
You can use the setkeycodes command to remap certain keys. I.e. you can use {{cmdroot|setkeycodes 6e 109 6d 104 69 28 6b 1}} to map the Tablets Up and Down keys to the standard PageUp and PageDown keys and Tablet Escape and Enter to their respective keys.

The following table shows the keycodes generated by the ThinkPad keys.
{| {{prettytable}}
|+ keycodes
! key !! keycode
|-
| {{ibmkey|Tablet orientation|#494949}} || 0x6d
|-
| {{ibmkey|Tablet Shortcut|#494949}} || 0x6e
|-
| {{ibmkey|Tablet Esc|#494949}} || 0x6b
|-
| {{ibmkey|Tablet Enter|#494949}} || 0x69
|-
| {{ibmkey|Tablet Up|#494949}} || 0x68
|-
| {{ibmkey|Tablet Down|#494949}} || 0x6c
|-
| {{ibmkey|Tablet (unlabeled)|#494949}} || 0x67
|}

==Example Applications==
===Web Browsers===
====Firefox====
To have firefox make use of the browser keys you need to modify one of its files{{footnote|3}}.
To do this you will first need to extract it from the {{path|browser.jar}} archive. Do...

:{{cmdroot|cd <firefox-directory>/chrome}}<br />
:{{cmdroot|unzip browser.jar}}

The file of interest is {{path|content/browser/browser.xul}}. Edit it {and don't forget to make a backup copy first}...
:{{cmdroot|vi content/browser/browser.xul}}

Look for the '''<keyset id="mainKeyset">''' section and add the following lines within...
<key id="goBackKb" keycode="VK_F19" command="Browser:Back" />
<key id="goForwardKb" keycode="VK_F20" command="Browser:Forward" />

The Command you need for Next Tab
<key id="goBackTabKb" keycode="VK_F19" oncommand="gBrowser.mTabContainer.advanceSelectedTab(-1)" />
For the Previous Tab
<key id="goForwardTabKb" keycode="VK_F20" oncommand="gBrowser.mTabContainer.advanceSelectedTab(1)" />

Now save the file and repackage the {{path|browser.jar}} archive...
:{{cmdroot|zip -rD0 browser.jar content/browser/}}

That's it.

{{HINT|For Firefox 2.0, just edit <firefox-directory>/chrome/browser/content/browser/browser.xul}}

{{HINT|Another interesting Page on Firefox is http://dqd.com/~mayoff/notes/thinkpad/dqdnavkeys/ It uses different key mappings (F19 resp. F20) but a ready [http://dqd.com/~mayoff/notes/thinkpad/dqdnavkeys/dqdnavkeys-1.2.xpi .xpi] is provided which is pretty comfortable. However, this xpi file does not install on Firefox 1.5.}}

{{HINT|You can also use the [http://extensionroom.mozdev.org/more-info/keyconfig keyconfig] extension to configure custom keys. This extension works with Firefox 1.5. The Command you need for Next Tab is gBrowser.mTabContainer.advanceSelectedTab(1,true); For Previous Tab its gBrowser.mTabContainer.advanceSelectedTab(-1,true); }}.

====Konqueror====
KDE allows you set key mappings for KDE applications (Go to KMenu > System > Control Center > Regional & Accessibility > Keyboard Shortcuts). By default (at least in KDE 3.5), XF86Back and XF86Forward are set as alternatives to Alt-Left and Alt-Right, and are mapped to KDE Back and Forward navigation actions.

If you use Konqueror as your only browser, you only need to set up {{path|~/.Xmodmap}} as described [[#xmodmap configuration|above]] to assign ThinkPad back/forward keys to the symbols XF86Back/XF86Forward. This also make these keys work for other KDE applications such as Quanta Plus, KPackage and so on (not all KDE applications honor this setting, e.g. KDE help system doesn't).

If you want to use Firefox, however, the above settings do not work. You will have to map ThinkPad back/forward keys to F19/F20 as described [[#Firefox|above]], and change KDE navigation key settings to use F19/F20 instead of the default.

====Opera====
However this isn't a simple configration file, you can set your browser manually.<br />
Go to <i>Tool > Settings > Mouse and keyboard > Keyboard settings > Edit > Browser Window</i>. There add F19 - Back and F20 - Forward. Now you can surf using your TP keys ;-)

===Window Managers===
====fvwm====
To get the {{ibmkey|Forward|#494949}} and {{ibmkey|Backward|#494949}} keys to cycle through pages in the virtual desktop, add this to your {{path|~/.fvwmrc}}:
Key XF86Back A A Scroll -100000 0
Key XF86Forward A A Scroll +100000 0
If you use multiple virtual desktops, you could instead use the keys to flip between them by using GotoDesk.

====fluxbox====
To get the keys to cycle through pages in the virtual desktop, add this to your {{path|~/.fluxbox/keys}}:
None F19 :PrevWorkspace
None F20 :NextWorkspace

====pekwm configuration====
You can make the two browser keys switch workspaces in pekwm, by adding the following two lines to the {{path|~/.pekwm/keys}} file:
KeyPress = "Mod1 XF86Back" { Actions = "GoToWorkspace prev" }
KeyPress = "Mod1 XF86Forward" { Actions = "GoToWorkspace next" }

====pwm====
Another example how to use these two keys to switch between pwm tabs. These two lines should be added to {{path|~/.pwm/keys-default.conf}} or {{path|/etc/pwm/keys-default.conf}}:
kbind "Back", "switch_rot", -1
kbind "Forward", "switch_rot", 1

====icewm====
Some applications use {{key|Ctrl}}{{key|Left}} and {{key|Ctrl}}{{key|Right}} to set the cursor to the beginning of the previous / next word. In icewm, though, they're bound to previous / next workspace. Change these two options in {{path|~/.icewm/preferences}} to bind those to {{ibmkey|Forward|#494949}} and {{ibmkey|Backward|#494949}}: (Provided you assigned keysyms F19 and F20 with xmodmap)
# "Previous workspace" shortcut
KeySysWorkspacePrev="F19"
# "Next workspace" shortcut
KeySysWorkspaceNext="F20"

===Other Uses===
====Console tools configuraton====
To make the {{ibmkey|Forward|#494949}} and {{ibmkey|Backward|#494949}} keys useful in console, add this to your keymap ({{path|/etc/console/boottime.kmap.gz}} in {{Debian}}):
keycode 158 = Decr_Console
keycode 159 = Incr_Console

Alternatively you can load this script (perhaps on system startup) to enable Backward/Forward button console (VT) switch:

#!/bin/sh
setkeycodes e06a 126 e069 127
echo keycode 126 = Decr_Console | loadkeys
echo keycode 127 = Incr_Console | loadkeys

It should work with any distro.

==External Sources==
*[http://www-307.ibm.com/pc/support/site.wss/document.do?lndocid=MIGR-51537 IBMs page on configuring the ThinkPad buttons (ThinkPad, Access IBM, Mail, Search, and Home buttons) under Linux]
*[http://dqd.com/~mayoff/notes/thinkpad/dqdnavkeys/ Rob Mayoffs page on using IBM Keyboard Navigation Keys in Linux Mozilla and Firefox]
*[http://snarfed.org/space/thinkpad+keys+in+firefox Ryan Barretts blog article about using the browser keys in Firefox]

{{footnotes|
#if there are more than one tool listed, one is sufficient
#'full' means you can completely reassign any action to be triggered by the key, 'additional actions' means you can trigger actions in addition to the standard function of the key, which can not be changed.
#Thanks go to Ryan Barrett for writing the [http://snarfed.org/space/thinkpad+keys+in+firefox little howto] on [http://snarfed.org/space/start his blog].
}}