.TH INPUT-KBD 8 "July 2005" "" ""

.SH NAME
input-kbd \- print or modify keyboard maps for input devices

.SH SYNOPSIS
\fBinput\-kbd\fR \fInum\fR
.HP 10
\fBinput\-kbd \fR [\fB\-f\fR\ \fIfile\fR] \fIdevnr\fR

.SH DESCRIPTION

.PP
\fBinput\-kbd\fR prints the keyboard map of kernel input device
\fIdevnr\fR on stdout.
The keyboard map maps scancodes to keycodes.

.PP
If the device supports a keyboard map, 
it is printed in the following format
(from the output for an AT keyboard): 
.IP
        0x0001 =  67  # KEY_F9
        0x0002 =  65  # KEY_F7
        0x0003 =  63  # KEY_F5
        0x0004 =  61  # KEY_F3
 

.PP
If the device does not support a keyboard map, 
\fBinput\-kbd\fR just lists the keys and buttons supported by the device,
like this (for a mouse):
.IP
        bits: BTN_LEFT
        bits: BTN_RIGHT
        bits: BTN_MIDDLE
 

.SH OPTIONS

.TP
\fIdevnr\fR
The index of the input device to use (0 for /dev/input/event0 and so on).

.TP
\fB\-f\fR \fIfile\fR
Read a keyboard map from a file and reconfigure the device with this map.
If the file name is '-' then stdin is used.
The map file uses the same format as the output of this command.
Blank lines are ignored.  A '#' character and anything following it on the same line are ignored as a comment.
Scancodes and keycodes are decimal values unless proceeded by "0x" for hexadecimal.
To remove a mapping entirely, set it to 0x00 (RESERVED).
Key names are also accepted instead of keycodes, like this: 
.IP
	0x0001 = KEY_F9
.TP
Be careful setting values from 0 to 9, as they will be parsed as the key symbols, not the decimal numbers.  If you want to list a single-digit decimal keycode, specify it as a hexadecimal value to remove any ambiguity.

.SH AUTHOR
Gerd Hoffmann <kraxel@redhat.com>