Qt Reference Documentation

- Qt 4.8
- ALL VERSIONS

- A
- A
- A
- Print

# kmap2qmap

`kmap2qmap` is a tool to generate keymaps for use on Embedded Linux. The source files have to be in standard Linux `kmap` format that is e.g. understood by the kernel's `loadkeys` command. This means you can use the following sources to generate `qmap` files:

- The Linux Console Tools (LCT) project.
- Xorg X11 keymaps can be converted to the `kmap` format with the `ckbcomp` utility.
- Since `kmap` files are plain text files, they can also be hand crafted.

The generated `qmap` files are size optimized binary files.

`kmap2qmap` is a command line program, that needs at least 2 files as parameters. The last one will be the generated `.qmap` file, while all the others will be parsed as input `.kmap` files. For example:

     kmap2qmap i386/qwertz/de-latin1-nodeadkeys.kmap include/compose.latin1.inc de-latin1-nodeadkeys.qmap

`kmap2qmap` does not support all the (pseudo) symbols that the Linux kernel supports. If you are converting a standard keymap you will get a lot of warnings for things like `Show_Registers`, `Hex_A`, etc.: you can safely ignore those.

It also doesn't support numeric symbols (e.g. `keycode 1 = 4242`, instead of `keycode 1 = colon`), since these are deprecated and can change from one kernel version to the other.

On the other hand, `kmap2qmap` supports one additional, Qt specific, symbol: `QtZap`. The built-in US keymap has that symbol mapped tp `Ctrl+Alt+Backspace` and it serves as a shortcut to kill your QWS server (similiar to the X11 server).

See also Qt for Embedded Linux Character Input