4 * Copyright (c) 1999-2002 Vojtech Pavlik
8 * This program is free software; you can redistribute it and/or modify it
9 * under the terms of the GNU General Public License version 2 as published by
10 * the Free Software Foundation.
13 #include <linux/init.h>
14 #include <linux/types.h>
15 #include <linux/input.h>
16 #include <linux/module.h>
17 #include <linux/slab.h>
18 #include <linux/random.h>
19 #include <linux/major.h>
20 #include <linux/proc_fs.h>
21 #include <linux/sched.h>
22 #include <linux/seq_file.h>
23 #include <linux/poll.h>
24 #include <linux/device.h>
25 #include <linux/mutex.h>
26 #include <linux/rcupdate.h>
27 #include <linux/smp_lock.h>
28 #include "input-compat.h"
30 MODULE_AUTHOR("Vojtech Pavlik <vojtech@suse.cz>");
31 MODULE_DESCRIPTION("Input core");
32 MODULE_LICENSE("GPL");
34 #define INPUT_DEVICES 256
36 static LIST_HEAD(input_dev_list);
37 static LIST_HEAD(input_handler_list);
40 * input_mutex protects access to both input_dev_list and input_handler_list.
41 * This also causes input_[un]register_device and input_[un]register_handler
42 * be mutually exclusive which simplifies locking in drivers implementing
45 static DEFINE_MUTEX(input_mutex);
47 static struct input_handler *input_table[8];
49 static inline int is_event_supported(unsigned int code,
50 unsigned long *bm, unsigned int max)
52 return code <= max && test_bit(code, bm);
55 static int input_defuzz_abs_event(int value, int old_val, int fuzz)
58 if (value > old_val - fuzz / 2 && value < old_val + fuzz / 2)
61 if (value > old_val - fuzz && value < old_val + fuzz)
62 return (old_val * 3 + value) / 4;
64 if (value > old_val - fuzz * 2 && value < old_val + fuzz * 2)
65 return (old_val + value) / 2;
72 * Pass event first through all filters and then, if event has not been
73 * filtered out, through all open handles. This function is called with
74 * dev->event_lock held and interrupts disabled.
76 static void input_pass_event(struct input_dev *dev,
77 struct input_handler *src_handler,
78 unsigned int type, unsigned int code, int value)
80 struct input_handler *handler;
81 struct input_handle *handle;
85 handle = rcu_dereference(dev->grab);
87 handle->handler->event(handle, type, code, value);
89 bool filtered = false;
91 list_for_each_entry_rcu(handle, &dev->h_list, d_node) {
95 handler = handle->handler;
98 * If this is the handler that injected this
99 * particular event we want to skip it to avoid
100 * filters firing again and again.
102 if (handler == src_handler)
105 if (!handler->filter) {
109 handler->event(handle, type, code, value);
111 } else if (handler->filter(handle, type, code, value))
120 * Generate software autorepeat event. Note that we take
121 * dev->event_lock here to avoid racing with input_event
122 * which may cause keys get "stuck".
124 static void input_repeat_key(unsigned long data)
126 struct input_dev *dev = (void *) data;
129 spin_lock_irqsave(&dev->event_lock, flags);
131 if (test_bit(dev->repeat_key, dev->key) &&
132 is_event_supported(dev->repeat_key, dev->keybit, KEY_MAX)) {
134 input_pass_event(dev, NULL, EV_KEY, dev->repeat_key, 2);
138 * Only send SYN_REPORT if we are not in a middle
139 * of driver parsing a new hardware packet.
140 * Otherwise assume that the driver will send
141 * SYN_REPORT once it's done.
143 input_pass_event(dev, NULL, EV_SYN, SYN_REPORT, 1);
146 if (dev->rep[REP_PERIOD])
147 mod_timer(&dev->timer, jiffies +
148 msecs_to_jiffies(dev->rep[REP_PERIOD]));
151 spin_unlock_irqrestore(&dev->event_lock, flags);
154 static void input_start_autorepeat(struct input_dev *dev, int code)
156 if (test_bit(EV_REP, dev->evbit) &&
157 dev->rep[REP_PERIOD] && dev->rep[REP_DELAY] &&
159 dev->repeat_key = code;
160 mod_timer(&dev->timer,
161 jiffies + msecs_to_jiffies(dev->rep[REP_DELAY]));
165 static void input_stop_autorepeat(struct input_dev *dev)
167 del_timer(&dev->timer);
170 #define INPUT_IGNORE_EVENT 0
171 #define INPUT_PASS_TO_HANDLERS 1
172 #define INPUT_PASS_TO_DEVICE 2
173 #define INPUT_PASS_TO_ALL (INPUT_PASS_TO_HANDLERS | INPUT_PASS_TO_DEVICE)
175 static int input_handle_abs_event(struct input_dev *dev,
176 struct input_handler *src_handler,
177 unsigned int code, int *pval)
182 if (code == ABS_MT_SLOT) {
184 * "Stage" the event; we'll flush it later, when we
185 * get actual touch data.
187 if (*pval >= 0 && *pval < dev->mtsize)
190 return INPUT_IGNORE_EVENT;
193 is_mt_event = code >= ABS_MT_FIRST && code <= ABS_MT_LAST;
196 pold = &dev->absinfo[code].value;
197 } else if (dev->mt) {
198 struct input_mt_slot *mtslot = &dev->mt[dev->slot];
199 pold = &mtslot->abs[code - ABS_MT_FIRST];
202 * Bypass filtering for multi-touch events when
203 * not employing slots.
209 *pval = input_defuzz_abs_event(*pval, *pold,
210 dev->absinfo[code].fuzz);
212 return INPUT_IGNORE_EVENT;
217 /* Flush pending "slot" event */
218 if (is_mt_event && dev->slot != input_abs_get_val(dev, ABS_MT_SLOT)) {
219 input_abs_set_val(dev, ABS_MT_SLOT, dev->slot);
220 input_pass_event(dev, src_handler,
221 EV_ABS, ABS_MT_SLOT, dev->slot);
224 return INPUT_PASS_TO_HANDLERS;
227 static void input_handle_event(struct input_dev *dev,
228 struct input_handler *src_handler,
229 unsigned int type, unsigned int code, int value)
231 int disposition = INPUT_IGNORE_EVENT;
238 disposition = INPUT_PASS_TO_ALL;
244 disposition = INPUT_PASS_TO_HANDLERS;
249 disposition = INPUT_PASS_TO_HANDLERS;
255 if (is_event_supported(code, dev->keybit, KEY_MAX) &&
256 !!test_bit(code, dev->key) != value) {
259 __change_bit(code, dev->key);
261 input_start_autorepeat(dev, code);
263 input_stop_autorepeat(dev);
266 disposition = INPUT_PASS_TO_HANDLERS;
271 if (is_event_supported(code, dev->swbit, SW_MAX) &&
272 !!test_bit(code, dev->sw) != value) {
274 __change_bit(code, dev->sw);
275 disposition = INPUT_PASS_TO_HANDLERS;
280 if (is_event_supported(code, dev->absbit, ABS_MAX))
281 disposition = input_handle_abs_event(dev, src_handler,
287 if (is_event_supported(code, dev->relbit, REL_MAX) && value)
288 disposition = INPUT_PASS_TO_HANDLERS;
293 if (is_event_supported(code, dev->mscbit, MSC_MAX))
294 disposition = INPUT_PASS_TO_ALL;
299 if (is_event_supported(code, dev->ledbit, LED_MAX) &&
300 !!test_bit(code, dev->led) != value) {
302 __change_bit(code, dev->led);
303 disposition = INPUT_PASS_TO_ALL;
308 if (is_event_supported(code, dev->sndbit, SND_MAX)) {
310 if (!!test_bit(code, dev->snd) != !!value)
311 __change_bit(code, dev->snd);
312 disposition = INPUT_PASS_TO_ALL;
317 if (code <= REP_MAX && value >= 0 && dev->rep[code] != value) {
318 dev->rep[code] = value;
319 disposition = INPUT_PASS_TO_ALL;
325 disposition = INPUT_PASS_TO_ALL;
329 disposition = INPUT_PASS_TO_ALL;
333 if (disposition != INPUT_IGNORE_EVENT && type != EV_SYN)
336 if ((disposition & INPUT_PASS_TO_DEVICE) && dev->event)
337 dev->event(dev, type, code, value);
339 if (disposition & INPUT_PASS_TO_HANDLERS)
340 input_pass_event(dev, src_handler, type, code, value);
344 * input_event() - report new input event
345 * @dev: device that generated the event
346 * @type: type of the event
348 * @value: value of the event
350 * This function should be used by drivers implementing various input
351 * devices to report input events. See also input_inject_event().
353 * NOTE: input_event() may be safely used right after input device was
354 * allocated with input_allocate_device(), even before it is registered
355 * with input_register_device(), but the event will not reach any of the
356 * input handlers. Such early invocation of input_event() may be used
357 * to 'seed' initial state of a switch or initial position of absolute
360 void input_event(struct input_dev *dev,
361 unsigned int type, unsigned int code, int value)
365 if (is_event_supported(type, dev->evbit, EV_MAX)) {
367 spin_lock_irqsave(&dev->event_lock, flags);
368 add_input_randomness(type, code, value);
369 input_handle_event(dev, NULL, type, code, value);
370 spin_unlock_irqrestore(&dev->event_lock, flags);
373 EXPORT_SYMBOL(input_event);
376 * input_inject_event() - send input event from input handler
377 * @handle: input handle to send event through
378 * @type: type of the event
380 * @value: value of the event
382 * Similar to input_event() but will ignore event if device is
383 * "grabbed" and handle injecting event is not the one that owns
386 void input_inject_event(struct input_handle *handle,
387 unsigned int type, unsigned int code, int value)
389 struct input_dev *dev = handle->dev;
390 struct input_handle *grab;
393 if (is_event_supported(type, dev->evbit, EV_MAX)) {
394 spin_lock_irqsave(&dev->event_lock, flags);
397 grab = rcu_dereference(dev->grab);
398 if (!grab || grab == handle)
399 input_handle_event(dev, handle->handler,
403 spin_unlock_irqrestore(&dev->event_lock, flags);
406 EXPORT_SYMBOL(input_inject_event);
409 * input_alloc_absinfo - allocates array of input_absinfo structs
410 * @dev: the input device emitting absolute events
412 * If the absinfo struct the caller asked for is already allocated, this
413 * functions will not do anything.
415 void input_alloc_absinfo(struct input_dev *dev)
418 dev->absinfo = kcalloc(ABS_CNT, sizeof(struct input_absinfo),
421 WARN(!dev->absinfo, "%s(): kcalloc() failed?\n", __func__);
423 EXPORT_SYMBOL(input_alloc_absinfo);
425 void input_set_abs_params(struct input_dev *dev, unsigned int axis,
426 int min, int max, int fuzz, int flat)
428 struct input_absinfo *absinfo;
430 input_alloc_absinfo(dev);
434 absinfo = &dev->absinfo[axis];
435 absinfo->minimum = min;
436 absinfo->maximum = max;
437 absinfo->fuzz = fuzz;
438 absinfo->flat = flat;
440 dev->absbit[BIT_WORD(axis)] |= BIT_MASK(axis);
442 EXPORT_SYMBOL(input_set_abs_params);
446 * input_grab_device - grabs device for exclusive use
447 * @handle: input handle that wants to own the device
449 * When a device is grabbed by an input handle all events generated by
450 * the device are delivered only to this handle. Also events injected
451 * by other input handles are ignored while device is grabbed.
453 int input_grab_device(struct input_handle *handle)
455 struct input_dev *dev = handle->dev;
458 retval = mutex_lock_interruptible(&dev->mutex);
467 rcu_assign_pointer(dev->grab, handle);
471 mutex_unlock(&dev->mutex);
474 EXPORT_SYMBOL(input_grab_device);
476 static void __input_release_device(struct input_handle *handle)
478 struct input_dev *dev = handle->dev;
480 if (dev->grab == handle) {
481 rcu_assign_pointer(dev->grab, NULL);
482 /* Make sure input_pass_event() notices that grab is gone */
485 list_for_each_entry(handle, &dev->h_list, d_node)
486 if (handle->open && handle->handler->start)
487 handle->handler->start(handle);
492 * input_release_device - release previously grabbed device
493 * @handle: input handle that owns the device
495 * Releases previously grabbed device so that other input handles can
496 * start receiving input events. Upon release all handlers attached
497 * to the device have their start() method called so they have a change
498 * to synchronize device state with the rest of the system.
500 void input_release_device(struct input_handle *handle)
502 struct input_dev *dev = handle->dev;
504 mutex_lock(&dev->mutex);
505 __input_release_device(handle);
506 mutex_unlock(&dev->mutex);
508 EXPORT_SYMBOL(input_release_device);
511 * input_open_device - open input device
512 * @handle: handle through which device is being accessed
514 * This function should be called by input handlers when they
515 * want to start receive events from given input device.
517 int input_open_device(struct input_handle *handle)
519 struct input_dev *dev = handle->dev;
522 retval = mutex_lock_interruptible(&dev->mutex);
526 if (dev->going_away) {
533 if (!dev->users++ && dev->open)
534 retval = dev->open(dev);
538 if (!--handle->open) {
540 * Make sure we are not delivering any more events
541 * through this handle
548 mutex_unlock(&dev->mutex);
551 EXPORT_SYMBOL(input_open_device);
553 int input_flush_device(struct input_handle *handle, struct file *file)
555 struct input_dev *dev = handle->dev;
558 retval = mutex_lock_interruptible(&dev->mutex);
563 retval = dev->flush(dev, file);
565 mutex_unlock(&dev->mutex);
568 EXPORT_SYMBOL(input_flush_device);
571 * input_close_device - close input device
572 * @handle: handle through which device is being accessed
574 * This function should be called by input handlers when they
575 * want to stop receive events from given input device.
577 void input_close_device(struct input_handle *handle)
579 struct input_dev *dev = handle->dev;
581 mutex_lock(&dev->mutex);
583 __input_release_device(handle);
585 if (!--dev->users && dev->close)
588 if (!--handle->open) {
590 * synchronize_rcu() makes sure that input_pass_event()
591 * completed and that no more input events are delivered
592 * through this handle
597 mutex_unlock(&dev->mutex);
599 EXPORT_SYMBOL(input_close_device);
602 * Simulate keyup events for all keys that are marked as pressed.
603 * The function must be called with dev->event_lock held.
605 static void input_dev_release_keys(struct input_dev *dev)
609 if (is_event_supported(EV_KEY, dev->evbit, EV_MAX)) {
610 for (code = 0; code <= KEY_MAX; code++) {
611 if (is_event_supported(code, dev->keybit, KEY_MAX) &&
612 __test_and_clear_bit(code, dev->key)) {
613 input_pass_event(dev, NULL, EV_KEY, code, 0);
616 input_pass_event(dev, NULL, EV_SYN, SYN_REPORT, 1);
621 * Prepare device for unregistering
623 static void input_disconnect_device(struct input_dev *dev)
625 struct input_handle *handle;
628 * Mark device as going away. Note that we take dev->mutex here
629 * not to protect access to dev->going_away but rather to ensure
630 * that there are no threads in the middle of input_open_device()
632 mutex_lock(&dev->mutex);
633 dev->going_away = true;
634 mutex_unlock(&dev->mutex);
636 spin_lock_irq(&dev->event_lock);
639 * Simulate keyup events for all pressed keys so that handlers
640 * are not left with "stuck" keys. The driver may continue
641 * generate events even after we done here but they will not
642 * reach any handlers.
644 input_dev_release_keys(dev);
646 list_for_each_entry(handle, &dev->h_list, d_node)
649 spin_unlock_irq(&dev->event_lock);
653 * input_scancode_to_scalar() - converts scancode in &struct input_keymap_entry
654 * @ke: keymap entry containing scancode to be converted.
655 * @scancode: pointer to the location where converted scancode should
658 * This function is used to convert scancode stored in &struct keymap_entry
659 * into scalar form understood by legacy keymap handling methods. These
660 * methods expect scancodes to be represented as 'unsigned int'.
662 int input_scancode_to_scalar(const struct input_keymap_entry *ke,
663 unsigned int *scancode)
667 *scancode = *((u8 *)ke->scancode);
671 *scancode = *((u16 *)ke->scancode);
675 *scancode = *((u32 *)ke->scancode);
684 EXPORT_SYMBOL(input_scancode_to_scalar);
687 * Those routines handle the default case where no [gs]etkeycode() is
688 * defined. In this case, an array indexed by the scancode is used.
691 static unsigned int input_fetch_keycode(struct input_dev *dev,
694 switch (dev->keycodesize) {
696 return ((u8 *)dev->keycode)[index];
699 return ((u16 *)dev->keycode)[index];
702 return ((u32 *)dev->keycode)[index];
706 static int input_default_getkeycode(struct input_dev *dev,
707 struct input_keymap_entry *ke)
712 if (!dev->keycodesize)
715 if (ke->flags & INPUT_KEYMAP_BY_INDEX)
718 error = input_scancode_to_scalar(ke, &index);
723 if (index >= dev->keycodemax)
726 ke->keycode = input_fetch_keycode(dev, index);
728 ke->len = sizeof(index);
729 memcpy(ke->scancode, &index, sizeof(index));
734 static int input_default_setkeycode(struct input_dev *dev,
735 const struct input_keymap_entry *ke,
736 unsigned int *old_keycode)
742 if (!dev->keycodesize)
745 if (ke->flags & INPUT_KEYMAP_BY_INDEX) {
748 error = input_scancode_to_scalar(ke, &index);
753 if (index >= dev->keycodemax)
756 if (dev->keycodesize < sizeof(ke->keycode) &&
757 (ke->keycode >> (dev->keycodesize * 8)))
760 switch (dev->keycodesize) {
762 u8 *k = (u8 *)dev->keycode;
763 *old_keycode = k[index];
764 k[index] = ke->keycode;
768 u16 *k = (u16 *)dev->keycode;
769 *old_keycode = k[index];
770 k[index] = ke->keycode;
774 u32 *k = (u32 *)dev->keycode;
775 *old_keycode = k[index];
776 k[index] = ke->keycode;
781 __clear_bit(*old_keycode, dev->keybit);
782 __set_bit(ke->keycode, dev->keybit);
784 for (i = 0; i < dev->keycodemax; i++) {
785 if (input_fetch_keycode(dev, i) == *old_keycode) {
786 __set_bit(*old_keycode, dev->keybit);
787 break; /* Setting the bit twice is useless, so break */
795 * input_get_keycode - retrieve keycode currently mapped to a given scancode
796 * @dev: input device which keymap is being queried
799 * This function should be called by anyone interested in retrieving current
800 * keymap. Presently evdev handlers use it.
802 int input_get_keycode(struct input_dev *dev, struct input_keymap_entry *ke)
807 spin_lock_irqsave(&dev->event_lock, flags);
809 if (dev->getkeycode) {
811 * Support for legacy drivers, that don't implement the new
814 u32 scancode = ke->index;
816 memcpy(ke->scancode, &scancode, sizeof(scancode));
817 ke->len = sizeof(scancode);
818 retval = dev->getkeycode(dev, scancode, &ke->keycode);
820 retval = dev->getkeycode_new(dev, ke);
823 spin_unlock_irqrestore(&dev->event_lock, flags);
826 EXPORT_SYMBOL(input_get_keycode);
829 * input_set_keycode - attribute a keycode to a given scancode
830 * @dev: input device which keymap is being updated
831 * @ke: new keymap entry
833 * This function should be called by anyone needing to update current
834 * keymap. Presently keyboard and evdev handlers use it.
836 int input_set_keycode(struct input_dev *dev,
837 const struct input_keymap_entry *ke)
840 unsigned int old_keycode;
843 if (ke->keycode > KEY_MAX)
846 spin_lock_irqsave(&dev->event_lock, flags);
848 if (dev->setkeycode) {
850 * Support for legacy drivers, that don't implement the new
853 unsigned int scancode;
855 retval = input_scancode_to_scalar(ke, &scancode);
860 * We need to know the old scancode, in order to generate a
861 * keyup effect, if the set operation happens successfully
863 if (!dev->getkeycode) {
868 retval = dev->getkeycode(dev, scancode, &old_keycode);
872 retval = dev->setkeycode(dev, scancode, ke->keycode);
874 retval = dev->setkeycode_new(dev, ke, &old_keycode);
880 /* Make sure KEY_RESERVED did not get enabled. */
881 __clear_bit(KEY_RESERVED, dev->keybit);
884 * Simulate keyup event if keycode is not present
885 * in the keymap anymore
887 if (test_bit(EV_KEY, dev->evbit) &&
888 !is_event_supported(old_keycode, dev->keybit, KEY_MAX) &&
889 __test_and_clear_bit(old_keycode, dev->key)) {
891 input_pass_event(dev, NULL, EV_KEY, old_keycode, 0);
893 input_pass_event(dev, NULL, EV_SYN, SYN_REPORT, 1);
897 spin_unlock_irqrestore(&dev->event_lock, flags);
901 EXPORT_SYMBOL(input_set_keycode);
903 #define MATCH_BIT(bit, max) \
904 for (i = 0; i < BITS_TO_LONGS(max); i++) \
905 if ((id->bit[i] & dev->bit[i]) != id->bit[i]) \
907 if (i != BITS_TO_LONGS(max)) \
910 static const struct input_device_id *input_match_device(struct input_handler *handler,
911 struct input_dev *dev)
913 const struct input_device_id *id;
916 for (id = handler->id_table; id->flags || id->driver_info; id++) {
918 if (id->flags & INPUT_DEVICE_ID_MATCH_BUS)
919 if (id->bustype != dev->id.bustype)
922 if (id->flags & INPUT_DEVICE_ID_MATCH_VENDOR)
923 if (id->vendor != dev->id.vendor)
926 if (id->flags & INPUT_DEVICE_ID_MATCH_PRODUCT)
927 if (id->product != dev->id.product)
930 if (id->flags & INPUT_DEVICE_ID_MATCH_VERSION)
931 if (id->version != dev->id.version)
934 MATCH_BIT(evbit, EV_MAX);
935 MATCH_BIT(keybit, KEY_MAX);
936 MATCH_BIT(relbit, REL_MAX);
937 MATCH_BIT(absbit, ABS_MAX);
938 MATCH_BIT(mscbit, MSC_MAX);
939 MATCH_BIT(ledbit, LED_MAX);
940 MATCH_BIT(sndbit, SND_MAX);
941 MATCH_BIT(ffbit, FF_MAX);
942 MATCH_BIT(swbit, SW_MAX);
944 if (!handler->match || handler->match(handler, dev))
951 static int input_attach_handler(struct input_dev *dev, struct input_handler *handler)
953 const struct input_device_id *id;
956 id = input_match_device(handler, dev);
960 error = handler->connect(handler, dev, id);
961 if (error && error != -ENODEV)
963 "input: failed to attach handler %s to device %s, "
965 handler->name, kobject_name(&dev->dev.kobj), error);
972 static int input_bits_to_string(char *buf, int buf_size,
973 unsigned long bits, bool skip_empty)
977 if (INPUT_COMPAT_TEST) {
978 u32 dword = bits >> 32;
979 if (dword || !skip_empty)
980 len += snprintf(buf, buf_size, "%x ", dword);
982 dword = bits & 0xffffffffUL;
983 if (dword || !skip_empty || len)
984 len += snprintf(buf + len, max(buf_size - len, 0),
987 if (bits || !skip_empty)
988 len += snprintf(buf, buf_size, "%lx", bits);
994 #else /* !CONFIG_COMPAT */
996 static int input_bits_to_string(char *buf, int buf_size,
997 unsigned long bits, bool skip_empty)
999 return bits || !skip_empty ?
1000 snprintf(buf, buf_size, "%lx", bits) : 0;
1005 #ifdef CONFIG_PROC_FS
1007 static struct proc_dir_entry *proc_bus_input_dir;
1008 static DECLARE_WAIT_QUEUE_HEAD(input_devices_poll_wait);
1009 static int input_devices_state;
1011 static inline void input_wakeup_procfs_readers(void)
1013 input_devices_state++;
1014 wake_up(&input_devices_poll_wait);
1017 static unsigned int input_proc_devices_poll(struct file *file, poll_table *wait)
1019 poll_wait(file, &input_devices_poll_wait, wait);
1020 if (file->f_version != input_devices_state) {
1021 file->f_version = input_devices_state;
1022 return POLLIN | POLLRDNORM;
1028 union input_seq_state {
1031 bool mutex_acquired;
1036 static void *input_devices_seq_start(struct seq_file *seq, loff_t *pos)
1038 union input_seq_state *state = (union input_seq_state *)&seq->private;
1041 /* We need to fit into seq->private pointer */
1042 BUILD_BUG_ON(sizeof(union input_seq_state) != sizeof(seq->private));
1044 error = mutex_lock_interruptible(&input_mutex);
1046 state->mutex_acquired = false;
1047 return ERR_PTR(error);
1050 state->mutex_acquired = true;
1052 return seq_list_start(&input_dev_list, *pos);
1055 static void *input_devices_seq_next(struct seq_file *seq, void *v, loff_t *pos)
1057 return seq_list_next(v, &input_dev_list, pos);
1060 static void input_seq_stop(struct seq_file *seq, void *v)
1062 union input_seq_state *state = (union input_seq_state *)&seq->private;
1064 if (state->mutex_acquired)
1065 mutex_unlock(&input_mutex);
1068 static void input_seq_print_bitmap(struct seq_file *seq, const char *name,
1069 unsigned long *bitmap, int max)
1072 bool skip_empty = true;
1075 seq_printf(seq, "B: %s=", name);
1077 for (i = BITS_TO_LONGS(max) - 1; i >= 0; i--) {
1078 if (input_bits_to_string(buf, sizeof(buf),
1079 bitmap[i], skip_empty)) {
1081 seq_printf(seq, "%s%s", buf, i > 0 ? " " : "");
1086 * If no output was produced print a single 0.
1091 seq_putc(seq, '\n');
1094 static int input_devices_seq_show(struct seq_file *seq, void *v)
1096 struct input_dev *dev = container_of(v, struct input_dev, node);
1097 const char *path = kobject_get_path(&dev->dev.kobj, GFP_KERNEL);
1098 struct input_handle *handle;
1100 seq_printf(seq, "I: Bus=%04x Vendor=%04x Product=%04x Version=%04x\n",
1101 dev->id.bustype, dev->id.vendor, dev->id.product, dev->id.version);
1103 seq_printf(seq, "N: Name=\"%s\"\n", dev->name ? dev->name : "");
1104 seq_printf(seq, "P: Phys=%s\n", dev->phys ? dev->phys : "");
1105 seq_printf(seq, "S: Sysfs=%s\n", path ? path : "");
1106 seq_printf(seq, "U: Uniq=%s\n", dev->uniq ? dev->uniq : "");
1107 seq_printf(seq, "H: Handlers=");
1109 list_for_each_entry(handle, &dev->h_list, d_node)
1110 seq_printf(seq, "%s ", handle->name);
1111 seq_putc(seq, '\n');
1113 input_seq_print_bitmap(seq, "EV", dev->evbit, EV_MAX);
1114 if (test_bit(EV_KEY, dev->evbit))
1115 input_seq_print_bitmap(seq, "KEY", dev->keybit, KEY_MAX);
1116 if (test_bit(EV_REL, dev->evbit))
1117 input_seq_print_bitmap(seq, "REL", dev->relbit, REL_MAX);
1118 if (test_bit(EV_ABS, dev->evbit))
1119 input_seq_print_bitmap(seq, "ABS", dev->absbit, ABS_MAX);
1120 if (test_bit(EV_MSC, dev->evbit))
1121 input_seq_print_bitmap(seq, "MSC", dev->mscbit, MSC_MAX);
1122 if (test_bit(EV_LED, dev->evbit))
1123 input_seq_print_bitmap(seq, "LED", dev->ledbit, LED_MAX);
1124 if (test_bit(EV_SND, dev->evbit))
1125 input_seq_print_bitmap(seq, "SND", dev->sndbit, SND_MAX);
1126 if (test_bit(EV_FF, dev->evbit))
1127 input_seq_print_bitmap(seq, "FF", dev->ffbit, FF_MAX);
1128 if (test_bit(EV_SW, dev->evbit))
1129 input_seq_print_bitmap(seq, "SW", dev->swbit, SW_MAX);
1131 seq_putc(seq, '\n');
1137 static const struct seq_operations input_devices_seq_ops = {
1138 .start = input_devices_seq_start,
1139 .next = input_devices_seq_next,
1140 .stop = input_seq_stop,
1141 .show = input_devices_seq_show,
1144 static int input_proc_devices_open(struct inode *inode, struct file *file)
1146 return seq_open(file, &input_devices_seq_ops);
1149 static const struct file_operations input_devices_fileops = {
1150 .owner = THIS_MODULE,
1151 .open = input_proc_devices_open,
1152 .poll = input_proc_devices_poll,
1154 .llseek = seq_lseek,
1155 .release = seq_release,
1158 static void *input_handlers_seq_start(struct seq_file *seq, loff_t *pos)
1160 union input_seq_state *state = (union input_seq_state *)&seq->private;
1163 /* We need to fit into seq->private pointer */
1164 BUILD_BUG_ON(sizeof(union input_seq_state) != sizeof(seq->private));
1166 error = mutex_lock_interruptible(&input_mutex);
1168 state->mutex_acquired = false;
1169 return ERR_PTR(error);
1172 state->mutex_acquired = true;
1175 return seq_list_start(&input_handler_list, *pos);
1178 static void *input_handlers_seq_next(struct seq_file *seq, void *v, loff_t *pos)
1180 union input_seq_state *state = (union input_seq_state *)&seq->private;
1182 state->pos = *pos + 1;
1183 return seq_list_next(v, &input_handler_list, pos);
1186 static int input_handlers_seq_show(struct seq_file *seq, void *v)
1188 struct input_handler *handler = container_of(v, struct input_handler, node);
1189 union input_seq_state *state = (union input_seq_state *)&seq->private;
1191 seq_printf(seq, "N: Number=%u Name=%s", state->pos, handler->name);
1192 if (handler->filter)
1193 seq_puts(seq, " (filter)");
1195 seq_printf(seq, " Minor=%d", handler->minor);
1196 seq_putc(seq, '\n');
1201 static const struct seq_operations input_handlers_seq_ops = {
1202 .start = input_handlers_seq_start,
1203 .next = input_handlers_seq_next,
1204 .stop = input_seq_stop,
1205 .show = input_handlers_seq_show,
1208 static int input_proc_handlers_open(struct inode *inode, struct file *file)
1210 return seq_open(file, &input_handlers_seq_ops);
1213 static const struct file_operations input_handlers_fileops = {
1214 .owner = THIS_MODULE,
1215 .open = input_proc_handlers_open,
1217 .llseek = seq_lseek,
1218 .release = seq_release,
1221 static int __init input_proc_init(void)
1223 struct proc_dir_entry *entry;
1225 proc_bus_input_dir = proc_mkdir("bus/input", NULL);
1226 if (!proc_bus_input_dir)
1229 entry = proc_create("devices", 0, proc_bus_input_dir,
1230 &input_devices_fileops);
1234 entry = proc_create("handlers", 0, proc_bus_input_dir,
1235 &input_handlers_fileops);
1241 fail2: remove_proc_entry("devices", proc_bus_input_dir);
1242 fail1: remove_proc_entry("bus/input", NULL);
1246 static void input_proc_exit(void)
1248 remove_proc_entry("devices", proc_bus_input_dir);
1249 remove_proc_entry("handlers", proc_bus_input_dir);
1250 remove_proc_entry("bus/input", NULL);
1253 #else /* !CONFIG_PROC_FS */
1254 static inline void input_wakeup_procfs_readers(void) { }
1255 static inline int input_proc_init(void) { return 0; }
1256 static inline void input_proc_exit(void) { }
1259 #define INPUT_DEV_STRING_ATTR_SHOW(name) \
1260 static ssize_t input_dev_show_##name(struct device *dev, \
1261 struct device_attribute *attr, \
1264 struct input_dev *input_dev = to_input_dev(dev); \
1266 return scnprintf(buf, PAGE_SIZE, "%s\n", \
1267 input_dev->name ? input_dev->name : ""); \
1269 static DEVICE_ATTR(name, S_IRUGO, input_dev_show_##name, NULL)
1271 INPUT_DEV_STRING_ATTR_SHOW(name);
1272 INPUT_DEV_STRING_ATTR_SHOW(phys);
1273 INPUT_DEV_STRING_ATTR_SHOW(uniq);
1275 static int input_print_modalias_bits(char *buf, int size,
1276 char name, unsigned long *bm,
1277 unsigned int min_bit, unsigned int max_bit)
1281 len += snprintf(buf, max(size, 0), "%c", name);
1282 for (i = min_bit; i < max_bit; i++)
1283 if (bm[BIT_WORD(i)] & BIT_MASK(i))
1284 len += snprintf(buf + len, max(size - len, 0), "%X,", i);
1288 static int input_print_modalias(char *buf, int size, struct input_dev *id,
1293 len = snprintf(buf, max(size, 0),
1294 "input:b%04Xv%04Xp%04Xe%04X-",
1295 id->id.bustype, id->id.vendor,
1296 id->id.product, id->id.version);
1298 len += input_print_modalias_bits(buf + len, size - len,
1299 'e', id->evbit, 0, EV_MAX);
1300 len += input_print_modalias_bits(buf + len, size - len,
1301 'k', id->keybit, KEY_MIN_INTERESTING, KEY_MAX);
1302 len += input_print_modalias_bits(buf + len, size - len,
1303 'r', id->relbit, 0, REL_MAX);
1304 len += input_print_modalias_bits(buf + len, size - len,
1305 'a', id->absbit, 0, ABS_MAX);
1306 len += input_print_modalias_bits(buf + len, size - len,
1307 'm', id->mscbit, 0, MSC_MAX);
1308 len += input_print_modalias_bits(buf + len, size - len,
1309 'l', id->ledbit, 0, LED_MAX);
1310 len += input_print_modalias_bits(buf + len, size - len,
1311 's', id->sndbit, 0, SND_MAX);
1312 len += input_print_modalias_bits(buf + len, size - len,
1313 'f', id->ffbit, 0, FF_MAX);
1314 len += input_print_modalias_bits(buf + len, size - len,
1315 'w', id->swbit, 0, SW_MAX);
1318 len += snprintf(buf + len, max(size - len, 0), "\n");
1323 static ssize_t input_dev_show_modalias(struct device *dev,
1324 struct device_attribute *attr,
1327 struct input_dev *id = to_input_dev(dev);
1330 len = input_print_modalias(buf, PAGE_SIZE, id, 1);
1332 return min_t(int, len, PAGE_SIZE);
1334 static DEVICE_ATTR(modalias, S_IRUGO, input_dev_show_modalias, NULL);
1336 static struct attribute *input_dev_attrs[] = {
1337 &dev_attr_name.attr,
1338 &dev_attr_phys.attr,
1339 &dev_attr_uniq.attr,
1340 &dev_attr_modalias.attr,
1344 static struct attribute_group input_dev_attr_group = {
1345 .attrs = input_dev_attrs,
1348 #define INPUT_DEV_ID_ATTR(name) \
1349 static ssize_t input_dev_show_id_##name(struct device *dev, \
1350 struct device_attribute *attr, \
1353 struct input_dev *input_dev = to_input_dev(dev); \
1354 return scnprintf(buf, PAGE_SIZE, "%04x\n", input_dev->id.name); \
1356 static DEVICE_ATTR(name, S_IRUGO, input_dev_show_id_##name, NULL)
1358 INPUT_DEV_ID_ATTR(bustype);
1359 INPUT_DEV_ID_ATTR(vendor);
1360 INPUT_DEV_ID_ATTR(product);
1361 INPUT_DEV_ID_ATTR(version);
1363 static struct attribute *input_dev_id_attrs[] = {
1364 &dev_attr_bustype.attr,
1365 &dev_attr_vendor.attr,
1366 &dev_attr_product.attr,
1367 &dev_attr_version.attr,
1371 static struct attribute_group input_dev_id_attr_group = {
1373 .attrs = input_dev_id_attrs,
1376 static int input_print_bitmap(char *buf, int buf_size, unsigned long *bitmap,
1377 int max, int add_cr)
1381 bool skip_empty = true;
1383 for (i = BITS_TO_LONGS(max) - 1; i >= 0; i--) {
1384 len += input_bits_to_string(buf + len, max(buf_size - len, 0),
1385 bitmap[i], skip_empty);
1389 len += snprintf(buf + len, max(buf_size - len, 0), " ");
1394 * If no output was produced print a single 0.
1397 len = snprintf(buf, buf_size, "%d", 0);
1400 len += snprintf(buf + len, max(buf_size - len, 0), "\n");
1405 #define INPUT_DEV_CAP_ATTR(ev, bm) \
1406 static ssize_t input_dev_show_cap_##bm(struct device *dev, \
1407 struct device_attribute *attr, \
1410 struct input_dev *input_dev = to_input_dev(dev); \
1411 int len = input_print_bitmap(buf, PAGE_SIZE, \
1412 input_dev->bm##bit, ev##_MAX, \
1414 return min_t(int, len, PAGE_SIZE); \
1416 static DEVICE_ATTR(bm, S_IRUGO, input_dev_show_cap_##bm, NULL)
1418 INPUT_DEV_CAP_ATTR(EV, ev);
1419 INPUT_DEV_CAP_ATTR(KEY, key);
1420 INPUT_DEV_CAP_ATTR(REL, rel);
1421 INPUT_DEV_CAP_ATTR(ABS, abs);
1422 INPUT_DEV_CAP_ATTR(MSC, msc);
1423 INPUT_DEV_CAP_ATTR(LED, led);
1424 INPUT_DEV_CAP_ATTR(SND, snd);
1425 INPUT_DEV_CAP_ATTR(FF, ff);
1426 INPUT_DEV_CAP_ATTR(SW, sw);
1428 static struct attribute *input_dev_caps_attrs[] = {
1441 static struct attribute_group input_dev_caps_attr_group = {
1442 .name = "capabilities",
1443 .attrs = input_dev_caps_attrs,
1446 static const struct attribute_group *input_dev_attr_groups[] = {
1447 &input_dev_attr_group,
1448 &input_dev_id_attr_group,
1449 &input_dev_caps_attr_group,
1453 static void input_dev_release(struct device *device)
1455 struct input_dev *dev = to_input_dev(device);
1457 input_ff_destroy(dev);
1458 input_mt_destroy_slots(dev);
1459 kfree(dev->absinfo);
1462 module_put(THIS_MODULE);
1466 * Input uevent interface - loading event handlers based on
1469 static int input_add_uevent_bm_var(struct kobj_uevent_env *env,
1470 const char *name, unsigned long *bitmap, int max)
1474 if (add_uevent_var(env, "%s=", name))
1477 len = input_print_bitmap(&env->buf[env->buflen - 1],
1478 sizeof(env->buf) - env->buflen,
1479 bitmap, max, false);
1480 if (len >= (sizeof(env->buf) - env->buflen))
1487 static int input_add_uevent_modalias_var(struct kobj_uevent_env *env,
1488 struct input_dev *dev)
1492 if (add_uevent_var(env, "MODALIAS="))
1495 len = input_print_modalias(&env->buf[env->buflen - 1],
1496 sizeof(env->buf) - env->buflen,
1498 if (len >= (sizeof(env->buf) - env->buflen))
1505 #define INPUT_ADD_HOTPLUG_VAR(fmt, val...) \
1507 int err = add_uevent_var(env, fmt, val); \
1512 #define INPUT_ADD_HOTPLUG_BM_VAR(name, bm, max) \
1514 int err = input_add_uevent_bm_var(env, name, bm, max); \
1519 #define INPUT_ADD_HOTPLUG_MODALIAS_VAR(dev) \
1521 int err = input_add_uevent_modalias_var(env, dev); \
1526 static int input_dev_uevent(struct device *device, struct kobj_uevent_env *env)
1528 struct input_dev *dev = to_input_dev(device);
1530 INPUT_ADD_HOTPLUG_VAR("PRODUCT=%x/%x/%x/%x",
1531 dev->id.bustype, dev->id.vendor,
1532 dev->id.product, dev->id.version);
1534 INPUT_ADD_HOTPLUG_VAR("NAME=\"%s\"", dev->name);
1536 INPUT_ADD_HOTPLUG_VAR("PHYS=\"%s\"", dev->phys);
1538 INPUT_ADD_HOTPLUG_VAR("UNIQ=\"%s\"", dev->uniq);
1540 INPUT_ADD_HOTPLUG_BM_VAR("EV=", dev->evbit, EV_MAX);
1541 if (test_bit(EV_KEY, dev->evbit))
1542 INPUT_ADD_HOTPLUG_BM_VAR("KEY=", dev->keybit, KEY_MAX);
1543 if (test_bit(EV_REL, dev->evbit))
1544 INPUT_ADD_HOTPLUG_BM_VAR("REL=", dev->relbit, REL_MAX);
1545 if (test_bit(EV_ABS, dev->evbit))
1546 INPUT_ADD_HOTPLUG_BM_VAR("ABS=", dev->absbit, ABS_MAX);
1547 if (test_bit(EV_MSC, dev->evbit))
1548 INPUT_ADD_HOTPLUG_BM_VAR("MSC=", dev->mscbit, MSC_MAX);
1549 if (test_bit(EV_LED, dev->evbit))
1550 INPUT_ADD_HOTPLUG_BM_VAR("LED=", dev->ledbit, LED_MAX);
1551 if (test_bit(EV_SND, dev->evbit))
1552 INPUT_ADD_HOTPLUG_BM_VAR("SND=", dev->sndbit, SND_MAX);
1553 if (test_bit(EV_FF, dev->evbit))
1554 INPUT_ADD_HOTPLUG_BM_VAR("FF=", dev->ffbit, FF_MAX);
1555 if (test_bit(EV_SW, dev->evbit))
1556 INPUT_ADD_HOTPLUG_BM_VAR("SW=", dev->swbit, SW_MAX);
1558 INPUT_ADD_HOTPLUG_MODALIAS_VAR(dev);
1563 #define INPUT_DO_TOGGLE(dev, type, bits, on) \
1568 if (!test_bit(EV_##type, dev->evbit)) \
1571 for (i = 0; i < type##_MAX; i++) { \
1572 if (!test_bit(i, dev->bits##bit)) \
1575 active = test_bit(i, dev->bits); \
1576 if (!active && !on) \
1579 dev->event(dev, EV_##type, i, on ? active : 0); \
1583 static void input_dev_toggle(struct input_dev *dev, bool activate)
1588 INPUT_DO_TOGGLE(dev, LED, led, activate);
1589 INPUT_DO_TOGGLE(dev, SND, snd, activate);
1591 if (activate && test_bit(EV_REP, dev->evbit)) {
1592 dev->event(dev, EV_REP, REP_PERIOD, dev->rep[REP_PERIOD]);
1593 dev->event(dev, EV_REP, REP_DELAY, dev->rep[REP_DELAY]);
1598 * input_reset_device() - reset/restore the state of input device
1599 * @dev: input device whose state needs to be reset
1601 * This function tries to reset the state of an opened input device and
1602 * bring internal state and state if the hardware in sync with each other.
1603 * We mark all keys as released, restore LED state, repeat rate, etc.
1605 void input_reset_device(struct input_dev *dev)
1607 mutex_lock(&dev->mutex);
1610 input_dev_toggle(dev, true);
1613 * Keys that have been pressed at suspend time are unlikely
1614 * to be still pressed when we resume.
1616 spin_lock_irq(&dev->event_lock);
1617 input_dev_release_keys(dev);
1618 spin_unlock_irq(&dev->event_lock);
1621 mutex_unlock(&dev->mutex);
1623 EXPORT_SYMBOL(input_reset_device);
1626 static int input_dev_suspend(struct device *dev)
1628 struct input_dev *input_dev = to_input_dev(dev);
1630 mutex_lock(&input_dev->mutex);
1632 if (input_dev->users)
1633 input_dev_toggle(input_dev, false);
1635 mutex_unlock(&input_dev->mutex);
1640 static int input_dev_resume(struct device *dev)
1642 struct input_dev *input_dev = to_input_dev(dev);
1644 input_reset_device(input_dev);
1649 static const struct dev_pm_ops input_dev_pm_ops = {
1650 .suspend = input_dev_suspend,
1651 .resume = input_dev_resume,
1652 .poweroff = input_dev_suspend,
1653 .restore = input_dev_resume,
1655 #endif /* CONFIG_PM */
1657 static struct device_type input_dev_type = {
1658 .groups = input_dev_attr_groups,
1659 .release = input_dev_release,
1660 .uevent = input_dev_uevent,
1662 .pm = &input_dev_pm_ops,
1666 static char *input_devnode(struct device *dev, mode_t *mode)
1668 return kasprintf(GFP_KERNEL, "input/%s", dev_name(dev));
1671 struct class input_class = {
1673 .devnode = input_devnode,
1675 EXPORT_SYMBOL_GPL(input_class);
1678 * input_allocate_device - allocate memory for new input device
1680 * Returns prepared struct input_dev or NULL.
1682 * NOTE: Use input_free_device() to free devices that have not been
1683 * registered; input_unregister_device() should be used for already
1684 * registered devices.
1686 struct input_dev *input_allocate_device(void)
1688 struct input_dev *dev;
1690 dev = kzalloc(sizeof(struct input_dev), GFP_KERNEL);
1692 dev->dev.type = &input_dev_type;
1693 dev->dev.class = &input_class;
1694 device_initialize(&dev->dev);
1695 mutex_init(&dev->mutex);
1696 spin_lock_init(&dev->event_lock);
1697 INIT_LIST_HEAD(&dev->h_list);
1698 INIT_LIST_HEAD(&dev->node);
1700 __module_get(THIS_MODULE);
1705 EXPORT_SYMBOL(input_allocate_device);
1708 * input_free_device - free memory occupied by input_dev structure
1709 * @dev: input device to free
1711 * This function should only be used if input_register_device()
1712 * was not called yet or if it failed. Once device was registered
1713 * use input_unregister_device() and memory will be freed once last
1714 * reference to the device is dropped.
1716 * Device should be allocated by input_allocate_device().
1718 * NOTE: If there are references to the input device then memory
1719 * will not be freed until last reference is dropped.
1721 void input_free_device(struct input_dev *dev)
1724 input_put_device(dev);
1726 EXPORT_SYMBOL(input_free_device);
1729 * input_mt_create_slots() - create MT input slots
1730 * @dev: input device supporting MT events and finger tracking
1731 * @num_slots: number of slots used by the device
1733 * This function allocates all necessary memory for MT slot handling in the
1734 * input device, and adds ABS_MT_SLOT to the device capabilities. All slots
1735 * are initially marked as unused by setting ABS_MT_TRACKING_ID to -1.
1737 int input_mt_create_slots(struct input_dev *dev, unsigned int num_slots)
1744 dev->mt = kcalloc(num_slots, sizeof(struct input_mt_slot), GFP_KERNEL);
1748 dev->mtsize = num_slots;
1749 input_set_abs_params(dev, ABS_MT_SLOT, 0, num_slots - 1, 0, 0);
1751 /* Mark slots as 'unused' */
1752 for (i = 0; i < num_slots; i++)
1753 dev->mt[i].abs[ABS_MT_TRACKING_ID - ABS_MT_FIRST] = -1;
1757 EXPORT_SYMBOL(input_mt_create_slots);
1760 * input_mt_destroy_slots() - frees the MT slots of the input device
1761 * @dev: input device with allocated MT slots
1763 * This function is only needed in error path as the input core will
1764 * automatically free the MT slots when the device is destroyed.
1766 void input_mt_destroy_slots(struct input_dev *dev)
1772 EXPORT_SYMBOL(input_mt_destroy_slots);
1775 * input_set_capability - mark device as capable of a certain event
1776 * @dev: device that is capable of emitting or accepting event
1777 * @type: type of the event (EV_KEY, EV_REL, etc...)
1780 * In addition to setting up corresponding bit in appropriate capability
1781 * bitmap the function also adjusts dev->evbit.
1783 void input_set_capability(struct input_dev *dev, unsigned int type, unsigned int code)
1787 __set_bit(code, dev->keybit);
1791 __set_bit(code, dev->relbit);
1795 __set_bit(code, dev->absbit);
1799 __set_bit(code, dev->mscbit);
1803 __set_bit(code, dev->swbit);
1807 __set_bit(code, dev->ledbit);
1811 __set_bit(code, dev->sndbit);
1815 __set_bit(code, dev->ffbit);
1824 "input_set_capability: unknown type %u (code %u)\n",
1830 __set_bit(type, dev->evbit);
1832 EXPORT_SYMBOL(input_set_capability);
1834 #define INPUT_CLEANSE_BITMASK(dev, type, bits) \
1836 if (!test_bit(EV_##type, dev->evbit)) \
1837 memset(dev->bits##bit, 0, \
1838 sizeof(dev->bits##bit)); \
1841 static void input_cleanse_bitmasks(struct input_dev *dev)
1843 INPUT_CLEANSE_BITMASK(dev, KEY, key);
1844 INPUT_CLEANSE_BITMASK(dev, REL, rel);
1845 INPUT_CLEANSE_BITMASK(dev, ABS, abs);
1846 INPUT_CLEANSE_BITMASK(dev, MSC, msc);
1847 INPUT_CLEANSE_BITMASK(dev, LED, led);
1848 INPUT_CLEANSE_BITMASK(dev, SND, snd);
1849 INPUT_CLEANSE_BITMASK(dev, FF, ff);
1850 INPUT_CLEANSE_BITMASK(dev, SW, sw);
1854 * input_register_device - register device with input core
1855 * @dev: device to be registered
1857 * This function registers device with input core. The device must be
1858 * allocated with input_allocate_device() and all it's capabilities
1859 * set up before registering.
1860 * If function fails the device must be freed with input_free_device().
1861 * Once device has been successfully registered it can be unregistered
1862 * with input_unregister_device(); input_free_device() should not be
1863 * called in this case.
1865 int input_register_device(struct input_dev *dev)
1867 static atomic_t input_no = ATOMIC_INIT(0);
1868 struct input_handler *handler;
1872 /* Every input device generates EV_SYN/SYN_REPORT events. */
1873 __set_bit(EV_SYN, dev->evbit);
1875 /* KEY_RESERVED is not supposed to be transmitted to userspace. */
1876 __clear_bit(KEY_RESERVED, dev->keybit);
1878 /* Make sure that bitmasks not mentioned in dev->evbit are clean. */
1879 input_cleanse_bitmasks(dev);
1882 * If delay and period are pre-set by the driver, then autorepeating
1883 * is handled by the driver itself and we don't do it in input.c.
1885 init_timer(&dev->timer);
1886 if (!dev->rep[REP_DELAY] && !dev->rep[REP_PERIOD]) {
1887 dev->timer.data = (long) dev;
1888 dev->timer.function = input_repeat_key;
1889 dev->rep[REP_DELAY] = 250;
1890 dev->rep[REP_PERIOD] = 33;
1893 if (!dev->getkeycode && !dev->getkeycode_new)
1894 dev->getkeycode_new = input_default_getkeycode;
1896 if (!dev->setkeycode && !dev->setkeycode_new)
1897 dev->setkeycode_new = input_default_setkeycode;
1899 dev_set_name(&dev->dev, "input%ld",
1900 (unsigned long) atomic_inc_return(&input_no) - 1);
1902 error = device_add(&dev->dev);
1906 path = kobject_get_path(&dev->dev.kobj, GFP_KERNEL);
1907 printk(KERN_INFO "input: %s as %s\n",
1908 dev->name ? dev->name : "Unspecified device", path ? path : "N/A");
1911 error = mutex_lock_interruptible(&input_mutex);
1913 device_del(&dev->dev);
1917 list_add_tail(&dev->node, &input_dev_list);
1919 list_for_each_entry(handler, &input_handler_list, node)
1920 input_attach_handler(dev, handler);
1922 input_wakeup_procfs_readers();
1924 mutex_unlock(&input_mutex);
1928 EXPORT_SYMBOL(input_register_device);
1931 * input_unregister_device - unregister previously registered device
1932 * @dev: device to be unregistered
1934 * This function unregisters an input device. Once device is unregistered
1935 * the caller should not try to access it as it may get freed at any moment.
1937 void input_unregister_device(struct input_dev *dev)
1939 struct input_handle *handle, *next;
1941 input_disconnect_device(dev);
1943 mutex_lock(&input_mutex);
1945 list_for_each_entry_safe(handle, next, &dev->h_list, d_node)
1946 handle->handler->disconnect(handle);
1947 WARN_ON(!list_empty(&dev->h_list));
1949 del_timer_sync(&dev->timer);
1950 list_del_init(&dev->node);
1952 input_wakeup_procfs_readers();
1954 mutex_unlock(&input_mutex);
1956 device_unregister(&dev->dev);
1958 EXPORT_SYMBOL(input_unregister_device);
1961 * input_register_handler - register a new input handler
1962 * @handler: handler to be registered
1964 * This function registers a new input handler (interface) for input
1965 * devices in the system and attaches it to all input devices that
1966 * are compatible with the handler.
1968 int input_register_handler(struct input_handler *handler)
1970 struct input_dev *dev;
1973 retval = mutex_lock_interruptible(&input_mutex);
1977 INIT_LIST_HEAD(&handler->h_list);
1979 if (handler->fops != NULL) {
1980 if (input_table[handler->minor >> 5]) {
1984 input_table[handler->minor >> 5] = handler;
1987 list_add_tail(&handler->node, &input_handler_list);
1989 list_for_each_entry(dev, &input_dev_list, node)
1990 input_attach_handler(dev, handler);
1992 input_wakeup_procfs_readers();
1995 mutex_unlock(&input_mutex);
1998 EXPORT_SYMBOL(input_register_handler);
2001 * input_unregister_handler - unregisters an input handler
2002 * @handler: handler to be unregistered
2004 * This function disconnects a handler from its input devices and
2005 * removes it from lists of known handlers.
2007 void input_unregister_handler(struct input_handler *handler)
2009 struct input_handle *handle, *next;
2011 mutex_lock(&input_mutex);
2013 list_for_each_entry_safe(handle, next, &handler->h_list, h_node)
2014 handler->disconnect(handle);
2015 WARN_ON(!list_empty(&handler->h_list));
2017 list_del_init(&handler->node);
2019 if (handler->fops != NULL)
2020 input_table[handler->minor >> 5] = NULL;
2022 input_wakeup_procfs_readers();
2024 mutex_unlock(&input_mutex);
2026 EXPORT_SYMBOL(input_unregister_handler);
2029 * input_handler_for_each_handle - handle iterator
2030 * @handler: input handler to iterate
2031 * @data: data for the callback
2032 * @fn: function to be called for each handle
2034 * Iterate over @bus's list of devices, and call @fn for each, passing
2035 * it @data and stop when @fn returns a non-zero value. The function is
2036 * using RCU to traverse the list and therefore may be usind in atonic
2037 * contexts. The @fn callback is invoked from RCU critical section and
2038 * thus must not sleep.
2040 int input_handler_for_each_handle(struct input_handler *handler, void *data,
2041 int (*fn)(struct input_handle *, void *))
2043 struct input_handle *handle;
2048 list_for_each_entry_rcu(handle, &handler->h_list, h_node) {
2049 retval = fn(handle, data);
2058 EXPORT_SYMBOL(input_handler_for_each_handle);
2061 * input_register_handle - register a new input handle
2062 * @handle: handle to register
2064 * This function puts a new input handle onto device's
2065 * and handler's lists so that events can flow through
2066 * it once it is opened using input_open_device().
2068 * This function is supposed to be called from handler's
2071 int input_register_handle(struct input_handle *handle)
2073 struct input_handler *handler = handle->handler;
2074 struct input_dev *dev = handle->dev;
2078 * We take dev->mutex here to prevent race with
2079 * input_release_device().
2081 error = mutex_lock_interruptible(&dev->mutex);
2086 * Filters go to the head of the list, normal handlers
2089 if (handler->filter)
2090 list_add_rcu(&handle->d_node, &dev->h_list);
2092 list_add_tail_rcu(&handle->d_node, &dev->h_list);
2094 mutex_unlock(&dev->mutex);
2097 * Since we are supposed to be called from ->connect()
2098 * which is mutually exclusive with ->disconnect()
2099 * we can't be racing with input_unregister_handle()
2100 * and so separate lock is not needed here.
2102 list_add_tail_rcu(&handle->h_node, &handler->h_list);
2105 handler->start(handle);
2109 EXPORT_SYMBOL(input_register_handle);
2112 * input_unregister_handle - unregister an input handle
2113 * @handle: handle to unregister
2115 * This function removes input handle from device's
2116 * and handler's lists.
2118 * This function is supposed to be called from handler's
2119 * disconnect() method.
2121 void input_unregister_handle(struct input_handle *handle)
2123 struct input_dev *dev = handle->dev;
2125 list_del_rcu(&handle->h_node);
2128 * Take dev->mutex to prevent race with input_release_device().
2130 mutex_lock(&dev->mutex);
2131 list_del_rcu(&handle->d_node);
2132 mutex_unlock(&dev->mutex);
2136 EXPORT_SYMBOL(input_unregister_handle);
2138 static int input_open_file(struct inode *inode, struct file *file)
2140 struct input_handler *handler;
2141 const struct file_operations *old_fops, *new_fops = NULL;
2144 err = mutex_lock_interruptible(&input_mutex);
2148 /* No load-on-demand here? */
2149 handler = input_table[iminor(inode) >> 5];
2151 new_fops = fops_get(handler->fops);
2153 mutex_unlock(&input_mutex);
2156 * That's _really_ odd. Usually NULL ->open means "nothing special",
2157 * not "no device". Oh, well...
2159 if (!new_fops || !new_fops->open) {
2165 old_fops = file->f_op;
2166 file->f_op = new_fops;
2168 err = new_fops->open(inode, file);
2170 fops_put(file->f_op);
2171 file->f_op = fops_get(old_fops);
2178 static const struct file_operations input_fops = {
2179 .owner = THIS_MODULE,
2180 .open = input_open_file,
2181 .llseek = noop_llseek,
2184 static int __init input_init(void)
2188 err = class_register(&input_class);
2190 printk(KERN_ERR "input: unable to register input_dev class\n");
2194 err = input_proc_init();
2198 err = register_chrdev(INPUT_MAJOR, "input", &input_fops);
2200 printk(KERN_ERR "input: unable to register char major %d", INPUT_MAJOR);
2206 fail2: input_proc_exit();
2207 fail1: class_unregister(&input_class);
2211 static void __exit input_exit(void)
2214 unregister_chrdev(INPUT_MAJOR, "input");
2215 class_unregister(&input_class);
2218 subsys_initcall(input_init);
2219 module_exit(input_exit);