2 * keymap - dump keymap of an evdev device or set a new keymap from a file
4 * Based on keyfuzz by Lennart Poettering <mzqrovna@0pointer.net>
5 * Adapted for udev-extras by Martin Pitt <martin.pitt@ubuntu.com>
7 * Copyright (C) 2006, Lennart Poettering
8 * Copyright (C) 2009, Canonical Ltd.
10 * keymap is free software; you can redistribute it and/or modify it
11 * under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * keymap is distributed in the hope that it will be useful, but
16 * WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with keymap; if not, write to the Free Software Foundation,
22 * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
35 #include <sys/ioctl.h>
36 #include <linux/limits.h>
37 #include <linux/input.h>
39 const struct key* lookup_key (const char *str, unsigned int len);
41 #include "keys-from-name.h"
42 #include "keys-to-name.h"
44 #define MAX_SCANCODES 1024
46 static int evdev_open(const char *dev)
51 if (strncmp(dev, "/dev", 4) != 0) {
52 snprintf(fn, sizeof(fn), "/dev/%s", dev);
56 if ((fd = open(dev, O_RDWR)) < 0) {
57 fprintf(stderr, "error open('%s'): %m\n", dev);
63 static int evdev_get_keycode(int fd, int scancode, int e)
68 if (ioctl(fd, EVIOCGKEYCODE, codes) < 0) {
69 if (e && errno == EINVAL) {
72 fprintf(stderr, "EVIOCGKEYCODE: %m\n");
79 static int evdev_set_keycode(int fd, int scancode, int keycode)
86 if (ioctl(fd, EVIOCSKEYCODE, codes) < 0) {
87 fprintf(stderr, "EVIOCSKEYCODE: %m\n");
93 static int evdev_driver_version(int fd, char *v, size_t l)
97 if (ioctl(fd, EVIOCGVERSION, &version)) {
98 fprintf(stderr, "EVIOCGVERSION: %m\n");
102 snprintf(v, l, "%i.%i.%i.", version >> 16, (version >> 8) & 0xff, version & 0xff);
106 static int evdev_device_name(int fd, char *n, size_t l)
108 if (ioctl(fd, EVIOCGNAME(l), n) < 0) {
109 fprintf(stderr, "EVIOCGNAME: %m\n");
115 /* Return a lower-case string with KEY_ prefix removed */
116 static const char* format_keyname(const char* key) {
117 static char result[101];
121 for (s = key+4, len = 0; *s && len < 100; ++len, ++s)
122 result[len] = tolower(*s);
127 static int dump_table(int fd) {
128 char version[256], name[256];
129 int scancode, r = -1;
131 if (evdev_driver_version(fd, version, sizeof(version)) < 0)
134 if (evdev_device_name(fd, name, sizeof(name)) < 0)
137 printf("### evdev %s, driver '%s'\n", version, name);
140 for (scancode = 0; scancode < MAX_SCANCODES; scancode++) {
143 if ((keycode = evdev_get_keycode(fd, scancode, 1)) < 0) {
150 if (keycode < KEY_MAX && key_names[keycode])
151 printf("0x%03x %s\n", scancode, format_keyname(key_names[keycode]));
153 printf("0x%03x 0x%03x\n", scancode, keycode);
159 static void set_key(int fd, const char* scancode_str, const char* keyname)
163 char t[105] = "KEY_UNKNOWN";
166 scancode = (unsigned) strtol(scancode_str, &endptr, 0);
167 if (*endptr != '\0') {
168 fprintf(stderr, "ERROR: Invalid scancode\n");
172 snprintf(t, sizeof(t), "KEY_%s", keyname);
174 if (!(k = lookup_key(t, strlen(t)))) {
175 fprintf(stderr, "ERROR: Unknown key name '%s'\n", keyname);
179 if (evdev_set_keycode(fd, scancode, k->id) < 0)
180 fprintf(stderr, "setting scancode 0x%2X to key code %i failed\n",
183 printf("setting scancode 0x%2X to key code %i\n",
187 static int merge_table(int fd, FILE *f) {
193 int scancode, new_keycode, old_keycode;
195 if (!fgets(s, sizeof(s), f))
199 p = s+strspn(s, "\t ");
200 if (*p == '#' || *p == '\n')
203 if (sscanf(p, "%i %i", &scancode, &new_keycode) != 2) {
204 char t[105] = "KEY_UNKNOWN";
207 if (sscanf(p, "%i %100s", &scancode, t+4) != 2) {
208 fprintf(stderr, "WARNING: Parse failure at line %i, ignoring.\n", line);
213 if (!(k = lookup_key(t, strlen(t)))) {
214 fprintf(stderr, "WARNING: Unknown key '%s' at line %i, ignoring.\n", t, line);
223 if ((old_keycode = evdev_get_keycode(fd, scancode, 0)) < 0) {
228 if (evdev_set_keycode(fd, scancode, new_keycode) < 0) {
233 if (new_keycode != old_keycode)
234 fprintf(stderr, "Remapped scancode 0x%02x to 0x%02x (prior: 0x%02x)\n",
235 scancode, new_keycode, old_keycode);
243 /* read one event; return 1 if valid */
244 static int read_event(int fd, struct input_event* ev)
247 ret = read(fd, ev, sizeof(struct input_event));
253 if (ret != sizeof(struct input_event)) {
254 fprintf(stderr, "did not get enough data for event struct, aborting\n");
261 static void print_key(uint32_t scancode, uint16_t keycode, int has_scan, int has_key)
265 /* ignore key release events */
269 if (has_key == 0 && has_scan != 0) {
270 fprintf(stderr, "got scan code event 0x%02X without a key code event\n",
276 printf("scan code: 0x%02X ", scancode);
278 printf("(no scan code received) ");
280 keyname = key_names[keycode];
282 printf("key code: %s\n", format_keyname(keyname));
284 printf("key code: %03X\n", keycode);
287 static void interactive(int fd)
289 struct input_event ev;
290 uint32_t last_scan = 0;
291 uint16_t last_key = 0;
292 int has_scan; /* boolean */
293 int has_key; /* 0: none, 1: release, 2: press */
295 /* grab input device */
296 ioctl(fd, EVIOCGRAB, 1);
297 puts("Press ESC to finish, or Control-C if this device is not your primary keyboard");
299 has_scan = has_key = 0;
300 while (read_event(fd, &ev)) {
301 /* Drivers usually send the scan code first, then the key code,
302 * then a SYN. Some drivers (like thinkpad_acpi) send the key
303 * code first, and some drivers might not send SYN events, so
304 * keep a robust state machine which can deal with any of those
307 if (ev.type == EV_MSC && ev.code == MSC_SCAN) {
309 fputs("driver did not send SYN event in between key events; previous event:\n",
311 print_key(last_scan, last_key, has_scan, has_key);
315 last_scan = ev.value;
317 /*printf("--- got scan %u; has scan %i key %i\n", last_scan, has_scan, has_key); */
319 else if (ev.type == EV_KEY) {
321 fputs("driver did not send SYN event in between key events; previous event:\n",
323 print_key(last_scan, last_key, has_scan, has_key);
328 has_key = 1 + ev.value;
329 /*printf("--- got key %hu; has scan %i key %i\n", last_key, has_scan, has_key);*/
332 if (ev.code == KEY_ESC && ev.value == 0)
335 else if (ev.type == EV_SYN) {
336 /*printf("--- got SYN; has scan %i key %i\n", has_scan, has_key);*/
337 print_key(last_scan, last_key, has_scan, has_key);
339 has_scan = has_key = 0;
344 /* release input device */
345 ioctl(fd, EVIOCGRAB, 0);
348 static void help(int error)
350 const char* h = "Usage: keymap <event device> [<map file>]\n"
351 " keymap <event device> scancode keyname [...]\n"
352 " keymap -i <event device>\n";
362 int main(int argc, char **argv)
364 static const struct option options[] = {
365 { "help", no_argument, NULL, 'h' },
366 { "interactive", no_argument, NULL, 'i' },
370 int opt_interactive = 0;
376 option = getopt_long(argc, argv, "hi", options, NULL);
395 if ((fd = evdev_open(argv[optind])) < 0)
398 /* one argument (device): dump or interactive */
399 if (argc == optind+1) {
407 /* two arguments (device, mapfile): set map file */
408 if (argc == optind+2) {
409 const char *filearg = argv[optind+1];
410 if (strchr(filearg, '/')) {
411 /* Keymap file argument is a path */
412 FILE *f = fopen(filearg, "r");
418 /* Keymap file argument is a filename */
419 /* Open override file if present, otherwise default file */
420 char keymap_path[PATH_MAX];
421 snprintf(keymap_path, sizeof(keymap_path), "%s%s", SYSCONFDIR "/udev/keymaps/", filearg);
422 FILE *f = fopen(keymap_path, "r");
426 snprintf(keymap_path, sizeof(keymap_path), "%s%s", PKGLIBEXECDIR "/keymaps/", filearg);
427 f = fopen(keymap_path, "r");
437 /* more arguments (device, scancode/keyname pairs): set keys directly */
438 if ((argc - optind - 1) % 2 == 0) {
439 for (i = optind+1; i < argc; i += 2)
440 set_key(fd, argv[i], argv[i+1]);
444 /* invalid number of arguments */
446 return 1; /* not reached */