---
name: "input-kbd"
section: "8"
platform: "linux"
package: "input-utils"
version: "1.3-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/input-kbd"
---

# input-kbd(8)

print or modify keyboard maps for input devices

## NAME

input-kbd - print or modify keyboard maps for input devices

## SYNOPSIS

**input-kbd** *num*

**input-kbd**  \[**-f** *file*\] *devnr*

## DESCRIPTION

**input-kbd** prints the keyboard map of kernel input device *devnr* on stdout. The keyboard map maps scancodes to keycodes.

If the device supports a keyboard map,  it is printed in the following format (from the output for an AT keyboard):

-

          0x0001 =  67  # KEY\_F9\
           0x0002 =  65  # KEY\_F7\
           0x0003 =  63  # KEY\_F5\
           0x0004 =  61  # KEY\_F3

If the device does not support a keyboard map,  **input-kbd** just lists the keys and buttons supported by the device, like this (for a mouse):

-

          bits: BTN\_LEFT\
           bits: BTN\_RIGHT\
           bits: BTN\_MIDDLE

## OPTIONS

- *devnr*

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

- **-f** *file*

  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:

-

  	0x0001 = KEY\_F9

- 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.

  ## AUTHOR

Gerd Hoffmann \<kraxel@redhat.com\>