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 #define pr_fmt(fmt) KBUILD_BASENAME ": " fmt
15 #include <linux/init.h>
16 #include <linux/types.h>
17 #include <linux/idr.h>
18 #include <linux/input/mt.h>
19 #include <linux/module.h>
20 #include <linux/slab.h>
21 #include <linux/random.h>
22 #include <linux/major.h>
23 #include <linux/proc_fs.h>
24 #include <linux/sched.h>
25 #include <linux/seq_file.h>
26 #include <linux/poll.h>
27 #include <linux/device.h>
28 #include <linux/mutex.h>
29 #include <linux/rcupdate.h>
30 #include "input-compat.h"
32 MODULE_AUTHOR("Vojtech Pavlik <vojtech@suse.cz>");
33 MODULE_DESCRIPTION("Input core");
34 MODULE_LICENSE("GPL");
36 #define INPUT_MAX_CHAR_DEVICES 1024
37 #define INPUT_FIRST_DYNAMIC_DEV 256
38 static DEFINE_IDA(input_ida);
40 static LIST_HEAD(input_dev_list);
41 static LIST_HEAD(input_handler_list);
44 * input_mutex protects access to both input_dev_list and input_handler_list.
45 * This also causes input_[un]register_device and input_[un]register_handler
46 * be mutually exclusive which simplifies locking in drivers implementing
49 static DEFINE_MUTEX(input_mutex);
51 static const struct input_value input_value_sync = { EV_SYN, SYN_REPORT, 1 };
53 static inline int is_event_supported(unsigned int code,
54 unsigned long *bm, unsigned int max)
56 return code <= max && test_bit(code, bm);
59 static int input_defuzz_abs_event(int value, int old_val, int fuzz)
62 if (value > old_val - fuzz / 2 && value < old_val + fuzz / 2)
65 if (value > old_val - fuzz && value < old_val + fuzz)
66 return (old_val * 3 + value) / 4;
68 if (value > old_val - fuzz * 2 && value < old_val + fuzz * 2)
69 return (old_val + value) / 2;
75 static void input_start_autorepeat(struct input_dev *dev, int code)
77 if (test_bit(EV_REP, dev->evbit) &&
78 dev->rep[REP_PERIOD] && dev->rep[REP_DELAY] &&
80 dev->repeat_key = code;
81 mod_timer(&dev->timer,
82 jiffies + msecs_to_jiffies(dev->rep[REP_DELAY]));
86 static void input_stop_autorepeat(struct input_dev *dev)
88 del_timer(&dev->timer);
92 * Pass event first through all filters and then, if event has not been
93 * filtered out, through all open handles. This function is called with
94 * dev->event_lock held and interrupts disabled.
96 static unsigned int input_to_handler(struct input_handle *handle,
97 struct input_value *vals, unsigned int count)
99 struct input_handler *handler = handle->handler;
100 struct input_value *end = vals;
101 struct input_value *v;
103 if (handler->filter) {
104 for (v = vals; v != vals + count; v++) {
105 if (handler->filter(handle, v->type, v->code, v->value))
118 handler->events(handle, vals, count);
119 else if (handler->event)
120 for (v = vals; v != vals + count; v++)
121 handler->event(handle, v->type, v->code, v->value);
127 * Pass values first through all filters and then, if event has not been
128 * filtered out, through all open handles. This function is called with
129 * dev->event_lock held and interrupts disabled.
131 static void input_pass_values(struct input_dev *dev,
132 struct input_value *vals, unsigned int count)
134 struct input_handle *handle;
135 struct input_value *v;
142 handle = rcu_dereference(dev->grab);
144 count = input_to_handler(handle, vals, count);
146 list_for_each_entry_rcu(handle, &dev->h_list, d_node)
148 count = input_to_handler(handle, vals, count);
156 /* trigger auto repeat for key events */
157 if (test_bit(EV_REP, dev->evbit) && test_bit(EV_KEY, dev->evbit)) {
158 for (v = vals; v != vals + count; v++) {
159 if (v->type == EV_KEY && v->value != 2) {
161 input_start_autorepeat(dev, v->code);
163 input_stop_autorepeat(dev);
169 static void input_pass_event(struct input_dev *dev,
170 unsigned int type, unsigned int code, int value)
172 struct input_value vals[] = { { type, code, value } };
174 input_pass_values(dev, vals, ARRAY_SIZE(vals));
178 * Generate software autorepeat event. Note that we take
179 * dev->event_lock here to avoid racing with input_event
180 * which may cause keys get "stuck".
182 static void input_repeat_key(unsigned long data)
184 struct input_dev *dev = (void *) data;
187 spin_lock_irqsave(&dev->event_lock, flags);
189 if (test_bit(dev->repeat_key, dev->key) &&
190 is_event_supported(dev->repeat_key, dev->keybit, KEY_MAX)) {
191 struct input_value vals[] = {
192 { EV_KEY, dev->repeat_key, 2 },
196 input_pass_values(dev, vals, ARRAY_SIZE(vals));
198 if (dev->rep[REP_PERIOD])
199 mod_timer(&dev->timer, jiffies +
200 msecs_to_jiffies(dev->rep[REP_PERIOD]));
203 spin_unlock_irqrestore(&dev->event_lock, flags);
206 #define INPUT_IGNORE_EVENT 0
207 #define INPUT_PASS_TO_HANDLERS 1
208 #define INPUT_PASS_TO_DEVICE 2
210 #define INPUT_FLUSH 8
211 #define INPUT_PASS_TO_ALL (INPUT_PASS_TO_HANDLERS | INPUT_PASS_TO_DEVICE)
213 static int input_handle_abs_event(struct input_dev *dev,
214 unsigned int code, int *pval)
216 struct input_mt *mt = dev->mt;
220 if (code == ABS_MT_SLOT) {
222 * "Stage" the event; we'll flush it later, when we
223 * get actual touch data.
225 if (mt && *pval >= 0 && *pval < mt->num_slots)
228 return INPUT_IGNORE_EVENT;
231 is_mt_event = input_is_mt_value(code);
234 pold = &dev->absinfo[code].value;
236 pold = &mt->slots[mt->slot].abs[code - ABS_MT_FIRST];
239 * Bypass filtering for multi-touch events when
240 * not employing slots.
246 *pval = input_defuzz_abs_event(*pval, *pold,
247 dev->absinfo[code].fuzz);
249 return INPUT_IGNORE_EVENT;
254 /* Flush pending "slot" event */
255 if (is_mt_event && mt && mt->slot != input_abs_get_val(dev, ABS_MT_SLOT)) {
256 input_abs_set_val(dev, ABS_MT_SLOT, mt->slot);
257 return INPUT_PASS_TO_HANDLERS | INPUT_SLOT;
260 return INPUT_PASS_TO_HANDLERS;
263 static int input_get_disposition(struct input_dev *dev,
264 unsigned int type, unsigned int code, int *pval)
266 int disposition = INPUT_IGNORE_EVENT;
274 disposition = INPUT_PASS_TO_ALL;
278 disposition = INPUT_PASS_TO_HANDLERS | INPUT_FLUSH;
281 disposition = INPUT_PASS_TO_HANDLERS;
287 if (is_event_supported(code, dev->keybit, KEY_MAX)) {
289 /* auto-repeat bypasses state updates */
291 disposition = INPUT_PASS_TO_HANDLERS;
295 if (!!test_bit(code, dev->key) != !!value) {
297 __change_bit(code, dev->key);
298 disposition = INPUT_PASS_TO_HANDLERS;
304 if (is_event_supported(code, dev->swbit, SW_MAX) &&
305 !!test_bit(code, dev->sw) != !!value) {
307 __change_bit(code, dev->sw);
308 disposition = INPUT_PASS_TO_HANDLERS;
313 if (is_event_supported(code, dev->absbit, ABS_MAX))
314 disposition = input_handle_abs_event(dev, code, &value);
319 if (is_event_supported(code, dev->relbit, REL_MAX) && value)
320 disposition = INPUT_PASS_TO_HANDLERS;
325 if (is_event_supported(code, dev->mscbit, MSC_MAX))
326 disposition = INPUT_PASS_TO_ALL;
331 if (is_event_supported(code, dev->ledbit, LED_MAX) &&
332 !!test_bit(code, dev->led) != !!value) {
334 __change_bit(code, dev->led);
335 disposition = INPUT_PASS_TO_ALL;
340 if (is_event_supported(code, dev->sndbit, SND_MAX)) {
342 if (!!test_bit(code, dev->snd) != !!value)
343 __change_bit(code, dev->snd);
344 disposition = INPUT_PASS_TO_ALL;
349 if (code <= REP_MAX && value >= 0 && dev->rep[code] != value) {
350 dev->rep[code] = value;
351 disposition = INPUT_PASS_TO_ALL;
357 disposition = INPUT_PASS_TO_ALL;
361 disposition = INPUT_PASS_TO_ALL;
369 static void input_handle_event(struct input_dev *dev,
370 unsigned int type, unsigned int code, int value)
372 int disposition = input_get_disposition(dev, type, code, &value);
374 if (disposition != INPUT_IGNORE_EVENT && type != EV_SYN)
375 add_input_randomness(type, code, value);
377 if ((disposition & INPUT_PASS_TO_DEVICE) && dev->event)
378 dev->event(dev, type, code, value);
383 if (disposition & INPUT_PASS_TO_HANDLERS) {
384 struct input_value *v;
386 if (disposition & INPUT_SLOT) {
387 v = &dev->vals[dev->num_vals++];
389 v->code = ABS_MT_SLOT;
390 v->value = dev->mt->slot;
393 v = &dev->vals[dev->num_vals++];
399 if (disposition & INPUT_FLUSH) {
400 if (dev->num_vals >= 2)
401 input_pass_values(dev, dev->vals, dev->num_vals);
403 } else if (dev->num_vals >= dev->max_vals - 2) {
404 dev->vals[dev->num_vals++] = input_value_sync;
405 input_pass_values(dev, dev->vals, dev->num_vals);
412 * input_event() - report new input event
413 * @dev: device that generated the event
414 * @type: type of the event
416 * @value: value of the event
418 * This function should be used by drivers implementing various input
419 * devices to report input events. See also input_inject_event().
421 * NOTE: input_event() may be safely used right after input device was
422 * allocated with input_allocate_device(), even before it is registered
423 * with input_register_device(), but the event will not reach any of the
424 * input handlers. Such early invocation of input_event() may be used
425 * to 'seed' initial state of a switch or initial position of absolute
428 void input_event(struct input_dev *dev,
429 unsigned int type, unsigned int code, int value)
433 if (is_event_supported(type, dev->evbit, EV_MAX)) {
435 spin_lock_irqsave(&dev->event_lock, flags);
436 input_handle_event(dev, type, code, value);
437 spin_unlock_irqrestore(&dev->event_lock, flags);
440 EXPORT_SYMBOL(input_event);
443 * input_inject_event() - send input event from input handler
444 * @handle: input handle to send event through
445 * @type: type of the event
447 * @value: value of the event
449 * Similar to input_event() but will ignore event if device is
450 * "grabbed" and handle injecting event is not the one that owns
453 void input_inject_event(struct input_handle *handle,
454 unsigned int type, unsigned int code, int value)
456 struct input_dev *dev = handle->dev;
457 struct input_handle *grab;
460 if (is_event_supported(type, dev->evbit, EV_MAX)) {
461 spin_lock_irqsave(&dev->event_lock, flags);
464 grab = rcu_dereference(dev->grab);
465 if (!grab || grab == handle)
466 input_handle_event(dev, type, code, value);
469 spin_unlock_irqrestore(&dev->event_lock, flags);
472 EXPORT_SYMBOL(input_inject_event);
475 * input_alloc_absinfo - allocates array of input_absinfo structs
476 * @dev: the input device emitting absolute events
478 * If the absinfo struct the caller asked for is already allocated, this
479 * functions will not do anything.
481 void input_alloc_absinfo(struct input_dev *dev)
484 dev->absinfo = kcalloc(ABS_CNT, sizeof(struct input_absinfo),
487 WARN(!dev->absinfo, "%s(): kcalloc() failed?\n", __func__);
489 EXPORT_SYMBOL(input_alloc_absinfo);
491 void input_set_abs_params(struct input_dev *dev, unsigned int axis,
492 int min, int max, int fuzz, int flat)
494 struct input_absinfo *absinfo;
496 input_alloc_absinfo(dev);
500 absinfo = &dev->absinfo[axis];
501 absinfo->minimum = min;
502 absinfo->maximum = max;
503 absinfo->fuzz = fuzz;
504 absinfo->flat = flat;
506 __set_bit(EV_ABS, dev->evbit);
507 __set_bit(axis, dev->absbit);
509 EXPORT_SYMBOL(input_set_abs_params);
513 * input_grab_device - grabs device for exclusive use
514 * @handle: input handle that wants to own the device
516 * When a device is grabbed by an input handle all events generated by
517 * the device are delivered only to this handle. Also events injected
518 * by other input handles are ignored while device is grabbed.
520 int input_grab_device(struct input_handle *handle)
522 struct input_dev *dev = handle->dev;
525 retval = mutex_lock_interruptible(&dev->mutex);
534 rcu_assign_pointer(dev->grab, handle);
537 mutex_unlock(&dev->mutex);
540 EXPORT_SYMBOL(input_grab_device);
542 static void __input_release_device(struct input_handle *handle)
544 struct input_dev *dev = handle->dev;
545 struct input_handle *grabber;
547 grabber = rcu_dereference_protected(dev->grab,
548 lockdep_is_held(&dev->mutex));
549 if (grabber == handle) {
550 rcu_assign_pointer(dev->grab, NULL);
551 /* Make sure input_pass_event() notices that grab is gone */
554 list_for_each_entry(handle, &dev->h_list, d_node)
555 if (handle->open && handle->handler->start)
556 handle->handler->start(handle);
561 * input_release_device - release previously grabbed device
562 * @handle: input handle that owns the device
564 * Releases previously grabbed device so that other input handles can
565 * start receiving input events. Upon release all handlers attached
566 * to the device have their start() method called so they have a change
567 * to synchronize device state with the rest of the system.
569 void input_release_device(struct input_handle *handle)
571 struct input_dev *dev = handle->dev;
573 mutex_lock(&dev->mutex);
574 __input_release_device(handle);
575 mutex_unlock(&dev->mutex);
577 EXPORT_SYMBOL(input_release_device);
580 * input_open_device - open input device
581 * @handle: handle through which device is being accessed
583 * This function should be called by input handlers when they
584 * want to start receive events from given input device.
586 int input_open_device(struct input_handle *handle)
588 struct input_dev *dev = handle->dev;
591 retval = mutex_lock_interruptible(&dev->mutex);
595 if (dev->going_away) {
602 if (!dev->users++ && dev->open)
603 retval = dev->open(dev);
607 if (!--handle->open) {
609 * Make sure we are not delivering any more events
610 * through this handle
617 mutex_unlock(&dev->mutex);
620 EXPORT_SYMBOL(input_open_device);
622 int input_flush_device(struct input_handle *handle, struct file *file)
624 struct input_dev *dev = handle->dev;
627 retval = mutex_lock_interruptible(&dev->mutex);
632 retval = dev->flush(dev, file);
634 mutex_unlock(&dev->mutex);
637 EXPORT_SYMBOL(input_flush_device);
640 * input_close_device - close input device
641 * @handle: handle through which device is being accessed
643 * This function should be called by input handlers when they
644 * want to stop receive events from given input device.
646 void input_close_device(struct input_handle *handle)
648 struct input_dev *dev = handle->dev;
650 mutex_lock(&dev->mutex);
652 __input_release_device(handle);
654 if (!--dev->users && dev->close)
657 if (!--handle->open) {
659 * synchronize_rcu() makes sure that input_pass_event()
660 * completed and that no more input events are delivered
661 * through this handle
666 mutex_unlock(&dev->mutex);
668 EXPORT_SYMBOL(input_close_device);
671 * Simulate keyup events for all keys that are marked as pressed.
672 * The function must be called with dev->event_lock held.
674 static void input_dev_release_keys(struct input_dev *dev)
676 bool need_sync = false;
679 if (is_event_supported(EV_KEY, dev->evbit, EV_MAX)) {
680 for_each_set_bit(code, dev->key, KEY_CNT) {
681 input_pass_event(dev, EV_KEY, code, 0);
686 input_pass_event(dev, EV_SYN, SYN_REPORT, 1);
688 memset(dev->key, 0, sizeof(dev->key));
693 * Prepare device for unregistering
695 static void input_disconnect_device(struct input_dev *dev)
697 struct input_handle *handle;
700 * Mark device as going away. Note that we take dev->mutex here
701 * not to protect access to dev->going_away but rather to ensure
702 * that there are no threads in the middle of input_open_device()
704 mutex_lock(&dev->mutex);
705 dev->going_away = true;
706 mutex_unlock(&dev->mutex);
708 spin_lock_irq(&dev->event_lock);
711 * Simulate keyup events for all pressed keys so that handlers
712 * are not left with "stuck" keys. The driver may continue
713 * generate events even after we done here but they will not
714 * reach any handlers.
716 input_dev_release_keys(dev);
718 list_for_each_entry(handle, &dev->h_list, d_node)
721 spin_unlock_irq(&dev->event_lock);
725 * input_scancode_to_scalar() - converts scancode in &struct input_keymap_entry
726 * @ke: keymap entry containing scancode to be converted.
727 * @scancode: pointer to the location where converted scancode should
730 * This function is used to convert scancode stored in &struct keymap_entry
731 * into scalar form understood by legacy keymap handling methods. These
732 * methods expect scancodes to be represented as 'unsigned int'.
734 int input_scancode_to_scalar(const struct input_keymap_entry *ke,
735 unsigned int *scancode)
739 *scancode = *((u8 *)ke->scancode);
743 *scancode = *((u16 *)ke->scancode);
747 *scancode = *((u32 *)ke->scancode);
756 EXPORT_SYMBOL(input_scancode_to_scalar);
759 * Those routines handle the default case where no [gs]etkeycode() is
760 * defined. In this case, an array indexed by the scancode is used.
763 static unsigned int input_fetch_keycode(struct input_dev *dev,
766 switch (dev->keycodesize) {
768 return ((u8 *)dev->keycode)[index];
771 return ((u16 *)dev->keycode)[index];
774 return ((u32 *)dev->keycode)[index];
778 static int input_default_getkeycode(struct input_dev *dev,
779 struct input_keymap_entry *ke)
784 if (!dev->keycodesize)
787 if (ke->flags & INPUT_KEYMAP_BY_INDEX)
790 error = input_scancode_to_scalar(ke, &index);
795 if (index >= dev->keycodemax)
798 ke->keycode = input_fetch_keycode(dev, index);
800 ke->len = sizeof(index);
801 memcpy(ke->scancode, &index, sizeof(index));
806 static int input_default_setkeycode(struct input_dev *dev,
807 const struct input_keymap_entry *ke,
808 unsigned int *old_keycode)
814 if (!dev->keycodesize)
817 if (ke->flags & INPUT_KEYMAP_BY_INDEX) {
820 error = input_scancode_to_scalar(ke, &index);
825 if (index >= dev->keycodemax)
828 if (dev->keycodesize < sizeof(ke->keycode) &&
829 (ke->keycode >> (dev->keycodesize * 8)))
832 switch (dev->keycodesize) {
834 u8 *k = (u8 *)dev->keycode;
835 *old_keycode = k[index];
836 k[index] = ke->keycode;
840 u16 *k = (u16 *)dev->keycode;
841 *old_keycode = k[index];
842 k[index] = ke->keycode;
846 u32 *k = (u32 *)dev->keycode;
847 *old_keycode = k[index];
848 k[index] = ke->keycode;
853 if (*old_keycode <= KEY_MAX) {
854 __clear_bit(*old_keycode, dev->keybit);
855 for (i = 0; i < dev->keycodemax; i++) {
856 if (input_fetch_keycode(dev, i) == *old_keycode) {
857 __set_bit(*old_keycode, dev->keybit);
858 /* Setting the bit twice is useless, so break */
864 __set_bit(ke->keycode, dev->keybit);
869 * input_get_keycode - retrieve keycode currently mapped to a given scancode
870 * @dev: input device which keymap is being queried
873 * This function should be called by anyone interested in retrieving current
874 * keymap. Presently evdev handlers use it.
876 int input_get_keycode(struct input_dev *dev, struct input_keymap_entry *ke)
881 spin_lock_irqsave(&dev->event_lock, flags);
882 retval = dev->getkeycode(dev, ke);
883 spin_unlock_irqrestore(&dev->event_lock, flags);
887 EXPORT_SYMBOL(input_get_keycode);
890 * input_set_keycode - attribute a keycode to a given scancode
891 * @dev: input device which keymap is being updated
892 * @ke: new keymap entry
894 * This function should be called by anyone needing to update current
895 * keymap. Presently keyboard and evdev handlers use it.
897 int input_set_keycode(struct input_dev *dev,
898 const struct input_keymap_entry *ke)
901 unsigned int old_keycode;
904 if (ke->keycode > KEY_MAX)
907 spin_lock_irqsave(&dev->event_lock, flags);
909 retval = dev->setkeycode(dev, ke, &old_keycode);
913 /* Make sure KEY_RESERVED did not get enabled. */
914 __clear_bit(KEY_RESERVED, dev->keybit);
917 * Simulate keyup event if keycode is not present
918 * in the keymap anymore
920 if (old_keycode > KEY_MAX) {
921 dev_warn(dev->dev.parent ?: &dev->dev,
922 "%s: got too big old keycode %#x\n",
923 __func__, old_keycode);
924 } else if (test_bit(EV_KEY, dev->evbit) &&
925 !is_event_supported(old_keycode, dev->keybit, KEY_MAX) &&
926 __test_and_clear_bit(old_keycode, dev->key)) {
927 struct input_value vals[] = {
928 { EV_KEY, old_keycode, 0 },
932 input_pass_values(dev, vals, ARRAY_SIZE(vals));
936 spin_unlock_irqrestore(&dev->event_lock, flags);
940 EXPORT_SYMBOL(input_set_keycode);
942 static const struct input_device_id *input_match_device(struct input_handler *handler,
943 struct input_dev *dev)
945 const struct input_device_id *id;
947 for (id = handler->id_table; id->flags || id->driver_info; id++) {
949 if (id->flags & INPUT_DEVICE_ID_MATCH_BUS)
950 if (id->bustype != dev->id.bustype)
953 if (id->flags & INPUT_DEVICE_ID_MATCH_VENDOR)
954 if (id->vendor != dev->id.vendor)
957 if (id->flags & INPUT_DEVICE_ID_MATCH_PRODUCT)
958 if (id->product != dev->id.product)
961 if (id->flags & INPUT_DEVICE_ID_MATCH_VERSION)
962 if (id->version != dev->id.version)
965 if (!bitmap_subset(id->evbit, dev->evbit, EV_MAX))
968 if (!bitmap_subset(id->keybit, dev->keybit, KEY_MAX))
971 if (!bitmap_subset(id->relbit, dev->relbit, REL_MAX))
974 if (!bitmap_subset(id->absbit, dev->absbit, ABS_MAX))
977 if (!bitmap_subset(id->mscbit, dev->mscbit, MSC_MAX))
980 if (!bitmap_subset(id->ledbit, dev->ledbit, LED_MAX))
983 if (!bitmap_subset(id->sndbit, dev->sndbit, SND_MAX))
986 if (!bitmap_subset(id->ffbit, dev->ffbit, FF_MAX))
989 if (!bitmap_subset(id->swbit, dev->swbit, SW_MAX))
992 if (!handler->match || handler->match(handler, dev))
999 static int input_attach_handler(struct input_dev *dev, struct input_handler *handler)
1001 const struct input_device_id *id;
1004 id = input_match_device(handler, dev);
1008 error = handler->connect(handler, dev, id);
1009 if (error && error != -ENODEV)
1010 pr_err("failed to attach handler %s to device %s, error: %d\n",
1011 handler->name, kobject_name(&dev->dev.kobj), error);
1016 #ifdef CONFIG_COMPAT
1018 static int input_bits_to_string(char *buf, int buf_size,
1019 unsigned long bits, bool skip_empty)
1023 if (in_compat_syscall()) {
1024 u32 dword = bits >> 32;
1025 if (dword || !skip_empty)
1026 len += snprintf(buf, buf_size, "%x ", dword);
1028 dword = bits & 0xffffffffUL;
1029 if (dword || !skip_empty || len)
1030 len += snprintf(buf + len, max(buf_size - len, 0),
1033 if (bits || !skip_empty)
1034 len += snprintf(buf, buf_size, "%lx", bits);
1040 #else /* !CONFIG_COMPAT */
1042 static int input_bits_to_string(char *buf, int buf_size,
1043 unsigned long bits, bool skip_empty)
1045 return bits || !skip_empty ?
1046 snprintf(buf, buf_size, "%lx", bits) : 0;
1051 #ifdef CONFIG_PROC_FS
1053 static struct proc_dir_entry *proc_bus_input_dir;
1054 static DECLARE_WAIT_QUEUE_HEAD(input_devices_poll_wait);
1055 static int input_devices_state;
1057 static inline void input_wakeup_procfs_readers(void)
1059 input_devices_state++;
1060 wake_up(&input_devices_poll_wait);
1063 static unsigned int input_proc_devices_poll(struct file *file, poll_table *wait)
1065 poll_wait(file, &input_devices_poll_wait, wait);
1066 if (file->f_version != input_devices_state) {
1067 file->f_version = input_devices_state;
1068 return POLLIN | POLLRDNORM;
1074 union input_seq_state {
1077 bool mutex_acquired;
1082 static void *input_devices_seq_start(struct seq_file *seq, loff_t *pos)
1084 union input_seq_state *state = (union input_seq_state *)&seq->private;
1087 /* We need to fit into seq->private pointer */
1088 BUILD_BUG_ON(sizeof(union input_seq_state) != sizeof(seq->private));
1090 error = mutex_lock_interruptible(&input_mutex);
1092 state->mutex_acquired = false;
1093 return ERR_PTR(error);
1096 state->mutex_acquired = true;
1098 return seq_list_start(&input_dev_list, *pos);
1101 static void *input_devices_seq_next(struct seq_file *seq, void *v, loff_t *pos)
1103 return seq_list_next(v, &input_dev_list, pos);
1106 static void input_seq_stop(struct seq_file *seq, void *v)
1108 union input_seq_state *state = (union input_seq_state *)&seq->private;
1110 if (state->mutex_acquired)
1111 mutex_unlock(&input_mutex);
1114 static void input_seq_print_bitmap(struct seq_file *seq, const char *name,
1115 unsigned long *bitmap, int max)
1118 bool skip_empty = true;
1121 seq_printf(seq, "B: %s=", name);
1123 for (i = BITS_TO_LONGS(max) - 1; i >= 0; i--) {
1124 if (input_bits_to_string(buf, sizeof(buf),
1125 bitmap[i], skip_empty)) {
1127 seq_printf(seq, "%s%s", buf, i > 0 ? " " : "");
1132 * If no output was produced print a single 0.
1137 seq_putc(seq, '\n');
1140 static int input_devices_seq_show(struct seq_file *seq, void *v)
1142 struct input_dev *dev = container_of(v, struct input_dev, node);
1143 const char *path = kobject_get_path(&dev->dev.kobj, GFP_KERNEL);
1144 struct input_handle *handle;
1146 seq_printf(seq, "I: Bus=%04x Vendor=%04x Product=%04x Version=%04x\n",
1147 dev->id.bustype, dev->id.vendor, dev->id.product, dev->id.version);
1149 seq_printf(seq, "N: Name=\"%s\"\n", dev->name ? dev->name : "");
1150 seq_printf(seq, "P: Phys=%s\n", dev->phys ? dev->phys : "");
1151 seq_printf(seq, "S: Sysfs=%s\n", path ? path : "");
1152 seq_printf(seq, "U: Uniq=%s\n", dev->uniq ? dev->uniq : "");
1153 seq_printf(seq, "H: Handlers=");
1155 list_for_each_entry(handle, &dev->h_list, d_node)
1156 seq_printf(seq, "%s ", handle->name);
1157 seq_putc(seq, '\n');
1159 input_seq_print_bitmap(seq, "PROP", dev->propbit, INPUT_PROP_MAX);
1161 input_seq_print_bitmap(seq, "EV", dev->evbit, EV_MAX);
1162 if (test_bit(EV_KEY, dev->evbit))
1163 input_seq_print_bitmap(seq, "KEY", dev->keybit, KEY_MAX);
1164 if (test_bit(EV_REL, dev->evbit))
1165 input_seq_print_bitmap(seq, "REL", dev->relbit, REL_MAX);
1166 if (test_bit(EV_ABS, dev->evbit))
1167 input_seq_print_bitmap(seq, "ABS", dev->absbit, ABS_MAX);
1168 if (test_bit(EV_MSC, dev->evbit))
1169 input_seq_print_bitmap(seq, "MSC", dev->mscbit, MSC_MAX);
1170 if (test_bit(EV_LED, dev->evbit))
1171 input_seq_print_bitmap(seq, "LED", dev->ledbit, LED_MAX);
1172 if (test_bit(EV_SND, dev->evbit))
1173 input_seq_print_bitmap(seq, "SND", dev->sndbit, SND_MAX);
1174 if (test_bit(EV_FF, dev->evbit))
1175 input_seq_print_bitmap(seq, "FF", dev->ffbit, FF_MAX);
1176 if (test_bit(EV_SW, dev->evbit))
1177 input_seq_print_bitmap(seq, "SW", dev->swbit, SW_MAX);
1179 seq_putc(seq, '\n');
1185 static const struct seq_operations input_devices_seq_ops = {
1186 .start = input_devices_seq_start,
1187 .next = input_devices_seq_next,
1188 .stop = input_seq_stop,
1189 .show = input_devices_seq_show,
1192 static int input_proc_devices_open(struct inode *inode, struct file *file)
1194 return seq_open(file, &input_devices_seq_ops);
1197 static const struct file_operations input_devices_fileops = {
1198 .owner = THIS_MODULE,
1199 .open = input_proc_devices_open,
1200 .poll = input_proc_devices_poll,
1202 .llseek = seq_lseek,
1203 .release = seq_release,
1206 static void *input_handlers_seq_start(struct seq_file *seq, loff_t *pos)
1208 union input_seq_state *state = (union input_seq_state *)&seq->private;
1211 /* We need to fit into seq->private pointer */
1212 BUILD_BUG_ON(sizeof(union input_seq_state) != sizeof(seq->private));
1214 error = mutex_lock_interruptible(&input_mutex);
1216 state->mutex_acquired = false;
1217 return ERR_PTR(error);
1220 state->mutex_acquired = true;
1223 return seq_list_start(&input_handler_list, *pos);
1226 static void *input_handlers_seq_next(struct seq_file *seq, void *v, loff_t *pos)
1228 union input_seq_state *state = (union input_seq_state *)&seq->private;
1230 state->pos = *pos + 1;
1231 return seq_list_next(v, &input_handler_list, pos);
1234 static int input_handlers_seq_show(struct seq_file *seq, void *v)
1236 struct input_handler *handler = container_of(v, struct input_handler, node);
1237 union input_seq_state *state = (union input_seq_state *)&seq->private;
1239 seq_printf(seq, "N: Number=%u Name=%s", state->pos, handler->name);
1240 if (handler->filter)
1241 seq_puts(seq, " (filter)");
1242 if (handler->legacy_minors)
1243 seq_printf(seq, " Minor=%d", handler->minor);
1244 seq_putc(seq, '\n');
1249 static const struct seq_operations input_handlers_seq_ops = {
1250 .start = input_handlers_seq_start,
1251 .next = input_handlers_seq_next,
1252 .stop = input_seq_stop,
1253 .show = input_handlers_seq_show,
1256 static int input_proc_handlers_open(struct inode *inode, struct file *file)
1258 return seq_open(file, &input_handlers_seq_ops);
1261 static const struct file_operations input_handlers_fileops = {
1262 .owner = THIS_MODULE,
1263 .open = input_proc_handlers_open,
1265 .llseek = seq_lseek,
1266 .release = seq_release,
1269 static int __init input_proc_init(void)
1271 struct proc_dir_entry *entry;
1273 proc_bus_input_dir = proc_mkdir("bus/input", NULL);
1274 if (!proc_bus_input_dir)
1277 entry = proc_create("devices", 0, proc_bus_input_dir,
1278 &input_devices_fileops);
1282 entry = proc_create("handlers", 0, proc_bus_input_dir,
1283 &input_handlers_fileops);
1289 fail2: remove_proc_entry("devices", proc_bus_input_dir);
1290 fail1: remove_proc_entry("bus/input", NULL);
1294 static void input_proc_exit(void)
1296 remove_proc_entry("devices", proc_bus_input_dir);
1297 remove_proc_entry("handlers", proc_bus_input_dir);
1298 remove_proc_entry("bus/input", NULL);
1301 #else /* !CONFIG_PROC_FS */
1302 static inline void input_wakeup_procfs_readers(void) { }
1303 static inline int input_proc_init(void) { return 0; }
1304 static inline void input_proc_exit(void) { }
1307 #define INPUT_DEV_STRING_ATTR_SHOW(name) \
1308 static ssize_t input_dev_show_##name(struct device *dev, \
1309 struct device_attribute *attr, \
1312 struct input_dev *input_dev = to_input_dev(dev); \
1314 return scnprintf(buf, PAGE_SIZE, "%s\n", \
1315 input_dev->name ? input_dev->name : ""); \
1317 static DEVICE_ATTR(name, S_IRUGO, input_dev_show_##name, NULL)
1319 INPUT_DEV_STRING_ATTR_SHOW(name);
1320 INPUT_DEV_STRING_ATTR_SHOW(phys);
1321 INPUT_DEV_STRING_ATTR_SHOW(uniq);
1323 static int input_print_modalias_bits(char *buf, int size,
1324 char name, unsigned long *bm,
1325 unsigned int min_bit, unsigned int max_bit)
1329 len += snprintf(buf, max(size, 0), "%c", name);
1330 for (i = min_bit; i < max_bit; i++)
1331 if (bm[BIT_WORD(i)] & BIT_MASK(i))
1332 len += snprintf(buf + len, max(size - len, 0), "%X,", i);
1336 static int input_print_modalias(char *buf, int size, struct input_dev *id,
1341 len = snprintf(buf, max(size, 0),
1342 "input:b%04Xv%04Xp%04Xe%04X-",
1343 id->id.bustype, id->id.vendor,
1344 id->id.product, id->id.version);
1346 len += input_print_modalias_bits(buf + len, size - len,
1347 'e', id->evbit, 0, EV_MAX);
1348 len += input_print_modalias_bits(buf + len, size - len,
1349 'k', id->keybit, KEY_MIN_INTERESTING, KEY_MAX);
1350 len += input_print_modalias_bits(buf + len, size - len,
1351 'r', id->relbit, 0, REL_MAX);
1352 len += input_print_modalias_bits(buf + len, size - len,
1353 'a', id->absbit, 0, ABS_MAX);
1354 len += input_print_modalias_bits(buf + len, size - len,
1355 'm', id->mscbit, 0, MSC_MAX);
1356 len += input_print_modalias_bits(buf + len, size - len,
1357 'l', id->ledbit, 0, LED_MAX);
1358 len += input_print_modalias_bits(buf + len, size - len,
1359 's', id->sndbit, 0, SND_MAX);
1360 len += input_print_modalias_bits(buf + len, size - len,
1361 'f', id->ffbit, 0, FF_MAX);
1362 len += input_print_modalias_bits(buf + len, size - len,
1363 'w', id->swbit, 0, SW_MAX);
1366 len += snprintf(buf + len, max(size - len, 0), "\n");
1371 static ssize_t input_dev_show_modalias(struct device *dev,
1372 struct device_attribute *attr,
1375 struct input_dev *id = to_input_dev(dev);
1378 len = input_print_modalias(buf, PAGE_SIZE, id, 1);
1380 return min_t(int, len, PAGE_SIZE);
1382 static DEVICE_ATTR(modalias, S_IRUGO, input_dev_show_modalias, NULL);
1384 static int input_print_bitmap(char *buf, int buf_size, unsigned long *bitmap,
1385 int max, int add_cr);
1387 static ssize_t input_dev_show_properties(struct device *dev,
1388 struct device_attribute *attr,
1391 struct input_dev *input_dev = to_input_dev(dev);
1392 int len = input_print_bitmap(buf, PAGE_SIZE, input_dev->propbit,
1393 INPUT_PROP_MAX, true);
1394 return min_t(int, len, PAGE_SIZE);
1396 static DEVICE_ATTR(properties, S_IRUGO, input_dev_show_properties, NULL);
1398 static struct attribute *input_dev_attrs[] = {
1399 &dev_attr_name.attr,
1400 &dev_attr_phys.attr,
1401 &dev_attr_uniq.attr,
1402 &dev_attr_modalias.attr,
1403 &dev_attr_properties.attr,
1407 static struct attribute_group input_dev_attr_group = {
1408 .attrs = input_dev_attrs,
1411 #define INPUT_DEV_ID_ATTR(name) \
1412 static ssize_t input_dev_show_id_##name(struct device *dev, \
1413 struct device_attribute *attr, \
1416 struct input_dev *input_dev = to_input_dev(dev); \
1417 return scnprintf(buf, PAGE_SIZE, "%04x\n", input_dev->id.name); \
1419 static DEVICE_ATTR(name, S_IRUGO, input_dev_show_id_##name, NULL)
1421 INPUT_DEV_ID_ATTR(bustype);
1422 INPUT_DEV_ID_ATTR(vendor);
1423 INPUT_DEV_ID_ATTR(product);
1424 INPUT_DEV_ID_ATTR(version);
1426 static struct attribute *input_dev_id_attrs[] = {
1427 &dev_attr_bustype.attr,
1428 &dev_attr_vendor.attr,
1429 &dev_attr_product.attr,
1430 &dev_attr_version.attr,
1434 static struct attribute_group input_dev_id_attr_group = {
1436 .attrs = input_dev_id_attrs,
1439 static int input_print_bitmap(char *buf, int buf_size, unsigned long *bitmap,
1440 int max, int add_cr)
1444 bool skip_empty = true;
1446 for (i = BITS_TO_LONGS(max) - 1; i >= 0; i--) {
1447 len += input_bits_to_string(buf + len, max(buf_size - len, 0),
1448 bitmap[i], skip_empty);
1452 len += snprintf(buf + len, max(buf_size - len, 0), " ");
1457 * If no output was produced print a single 0.
1460 len = snprintf(buf, buf_size, "%d", 0);
1463 len += snprintf(buf + len, max(buf_size - len, 0), "\n");
1468 #define INPUT_DEV_CAP_ATTR(ev, bm) \
1469 static ssize_t input_dev_show_cap_##bm(struct device *dev, \
1470 struct device_attribute *attr, \
1473 struct input_dev *input_dev = to_input_dev(dev); \
1474 int len = input_print_bitmap(buf, PAGE_SIZE, \
1475 input_dev->bm##bit, ev##_MAX, \
1477 return min_t(int, len, PAGE_SIZE); \
1479 static DEVICE_ATTR(bm, S_IRUGO, input_dev_show_cap_##bm, NULL)
1481 INPUT_DEV_CAP_ATTR(EV, ev);
1482 INPUT_DEV_CAP_ATTR(KEY, key);
1483 INPUT_DEV_CAP_ATTR(REL, rel);
1484 INPUT_DEV_CAP_ATTR(ABS, abs);
1485 INPUT_DEV_CAP_ATTR(MSC, msc);
1486 INPUT_DEV_CAP_ATTR(LED, led);
1487 INPUT_DEV_CAP_ATTR(SND, snd);
1488 INPUT_DEV_CAP_ATTR(FF, ff);
1489 INPUT_DEV_CAP_ATTR(SW, sw);
1491 static struct attribute *input_dev_caps_attrs[] = {
1504 static struct attribute_group input_dev_caps_attr_group = {
1505 .name = "capabilities",
1506 .attrs = input_dev_caps_attrs,
1509 static const struct attribute_group *input_dev_attr_groups[] = {
1510 &input_dev_attr_group,
1511 &input_dev_id_attr_group,
1512 &input_dev_caps_attr_group,
1516 static void input_dev_release(struct device *device)
1518 struct input_dev *dev = to_input_dev(device);
1520 input_ff_destroy(dev);
1521 input_mt_destroy_slots(dev);
1522 kfree(dev->absinfo);
1526 module_put(THIS_MODULE);
1530 * Input uevent interface - loading event handlers based on
1533 static int input_add_uevent_bm_var(struct kobj_uevent_env *env,
1534 const char *name, unsigned long *bitmap, int max)
1538 if (add_uevent_var(env, "%s", name))
1541 len = input_print_bitmap(&env->buf[env->buflen - 1],
1542 sizeof(env->buf) - env->buflen,
1543 bitmap, max, false);
1544 if (len >= (sizeof(env->buf) - env->buflen))
1551 static int input_add_uevent_modalias_var(struct kobj_uevent_env *env,
1552 struct input_dev *dev)
1556 if (add_uevent_var(env, "MODALIAS="))
1559 len = input_print_modalias(&env->buf[env->buflen - 1],
1560 sizeof(env->buf) - env->buflen,
1562 if (len >= (sizeof(env->buf) - env->buflen))
1569 #define INPUT_ADD_HOTPLUG_VAR(fmt, val...) \
1571 int err = add_uevent_var(env, fmt, val); \
1576 #define INPUT_ADD_HOTPLUG_BM_VAR(name, bm, max) \
1578 int err = input_add_uevent_bm_var(env, name, bm, max); \
1583 #define INPUT_ADD_HOTPLUG_MODALIAS_VAR(dev) \
1585 int err = input_add_uevent_modalias_var(env, dev); \
1590 static int input_dev_uevent(struct device *device, struct kobj_uevent_env *env)
1592 struct input_dev *dev = to_input_dev(device);
1594 INPUT_ADD_HOTPLUG_VAR("PRODUCT=%x/%x/%x/%x",
1595 dev->id.bustype, dev->id.vendor,
1596 dev->id.product, dev->id.version);
1598 INPUT_ADD_HOTPLUG_VAR("NAME=\"%s\"", dev->name);
1600 INPUT_ADD_HOTPLUG_VAR("PHYS=\"%s\"", dev->phys);
1602 INPUT_ADD_HOTPLUG_VAR("UNIQ=\"%s\"", dev->uniq);
1604 INPUT_ADD_HOTPLUG_BM_VAR("PROP=", dev->propbit, INPUT_PROP_MAX);
1606 INPUT_ADD_HOTPLUG_BM_VAR("EV=", dev->evbit, EV_MAX);
1607 if (test_bit(EV_KEY, dev->evbit))
1608 INPUT_ADD_HOTPLUG_BM_VAR("KEY=", dev->keybit, KEY_MAX);
1609 if (test_bit(EV_REL, dev->evbit))
1610 INPUT_ADD_HOTPLUG_BM_VAR("REL=", dev->relbit, REL_MAX);
1611 if (test_bit(EV_ABS, dev->evbit))
1612 INPUT_ADD_HOTPLUG_BM_VAR("ABS=", dev->absbit, ABS_MAX);
1613 if (test_bit(EV_MSC, dev->evbit))
1614 INPUT_ADD_HOTPLUG_BM_VAR("MSC=", dev->mscbit, MSC_MAX);
1615 if (test_bit(EV_LED, dev->evbit))
1616 INPUT_ADD_HOTPLUG_BM_VAR("LED=", dev->ledbit, LED_MAX);
1617 if (test_bit(EV_SND, dev->evbit))
1618 INPUT_ADD_HOTPLUG_BM_VAR("SND=", dev->sndbit, SND_MAX);
1619 if (test_bit(EV_FF, dev->evbit))
1620 INPUT_ADD_HOTPLUG_BM_VAR("FF=", dev->ffbit, FF_MAX);
1621 if (test_bit(EV_SW, dev->evbit))
1622 INPUT_ADD_HOTPLUG_BM_VAR("SW=", dev->swbit, SW_MAX);
1624 INPUT_ADD_HOTPLUG_MODALIAS_VAR(dev);
1629 #define INPUT_DO_TOGGLE(dev, type, bits, on) \
1634 if (!test_bit(EV_##type, dev->evbit)) \
1637 for_each_set_bit(i, dev->bits##bit, type##_CNT) { \
1638 active = test_bit(i, dev->bits); \
1639 if (!active && !on) \
1642 dev->event(dev, EV_##type, i, on ? active : 0); \
1646 static void input_dev_toggle(struct input_dev *dev, bool activate)
1651 INPUT_DO_TOGGLE(dev, LED, led, activate);
1652 INPUT_DO_TOGGLE(dev, SND, snd, activate);
1654 if (activate && test_bit(EV_REP, dev->evbit)) {
1655 dev->event(dev, EV_REP, REP_PERIOD, dev->rep[REP_PERIOD]);
1656 dev->event(dev, EV_REP, REP_DELAY, dev->rep[REP_DELAY]);
1661 * input_reset_device() - reset/restore the state of input device
1662 * @dev: input device whose state needs to be reset
1664 * This function tries to reset the state of an opened input device and
1665 * bring internal state and state if the hardware in sync with each other.
1666 * We mark all keys as released, restore LED state, repeat rate, etc.
1668 void input_reset_device(struct input_dev *dev)
1670 unsigned long flags;
1672 mutex_lock(&dev->mutex);
1673 spin_lock_irqsave(&dev->event_lock, flags);
1675 input_dev_toggle(dev, true);
1676 input_dev_release_keys(dev);
1678 spin_unlock_irqrestore(&dev->event_lock, flags);
1679 mutex_unlock(&dev->mutex);
1681 EXPORT_SYMBOL(input_reset_device);
1683 #ifdef CONFIG_PM_SLEEP
1684 static int input_dev_suspend(struct device *dev)
1686 struct input_dev *input_dev = to_input_dev(dev);
1688 spin_lock_irq(&input_dev->event_lock);
1691 * Keys that are pressed now are unlikely to be
1692 * still pressed when we resume.
1694 input_dev_release_keys(input_dev);
1696 /* Turn off LEDs and sounds, if any are active. */
1697 input_dev_toggle(input_dev, false);
1699 spin_unlock_irq(&input_dev->event_lock);
1704 static int input_dev_resume(struct device *dev)
1706 struct input_dev *input_dev = to_input_dev(dev);
1708 spin_lock_irq(&input_dev->event_lock);
1710 /* Restore state of LEDs and sounds, if any were active. */
1711 input_dev_toggle(input_dev, true);
1713 spin_unlock_irq(&input_dev->event_lock);
1718 static int input_dev_freeze(struct device *dev)
1720 struct input_dev *input_dev = to_input_dev(dev);
1722 spin_lock_irq(&input_dev->event_lock);
1725 * Keys that are pressed now are unlikely to be
1726 * still pressed when we resume.
1728 input_dev_release_keys(input_dev);
1730 spin_unlock_irq(&input_dev->event_lock);
1735 static int input_dev_poweroff(struct device *dev)
1737 struct input_dev *input_dev = to_input_dev(dev);
1739 spin_lock_irq(&input_dev->event_lock);
1741 /* Turn off LEDs and sounds, if any are active. */
1742 input_dev_toggle(input_dev, false);
1744 spin_unlock_irq(&input_dev->event_lock);
1749 static const struct dev_pm_ops input_dev_pm_ops = {
1750 .suspend = input_dev_suspend,
1751 .resume = input_dev_resume,
1752 .freeze = input_dev_freeze,
1753 .poweroff = input_dev_poweroff,
1754 .restore = input_dev_resume,
1756 #endif /* CONFIG_PM */
1758 static struct device_type input_dev_type = {
1759 .groups = input_dev_attr_groups,
1760 .release = input_dev_release,
1761 .uevent = input_dev_uevent,
1762 #ifdef CONFIG_PM_SLEEP
1763 .pm = &input_dev_pm_ops,
1767 static char *input_devnode(struct device *dev, umode_t *mode)
1769 return kasprintf(GFP_KERNEL, "input/%s", dev_name(dev));
1772 struct class input_class = {
1774 .devnode = input_devnode,
1776 EXPORT_SYMBOL_GPL(input_class);
1779 * input_allocate_device - allocate memory for new input device
1781 * Returns prepared struct input_dev or %NULL.
1783 * NOTE: Use input_free_device() to free devices that have not been
1784 * registered; input_unregister_device() should be used for already
1785 * registered devices.
1787 struct input_dev *input_allocate_device(void)
1789 static atomic_t input_no = ATOMIC_INIT(-1);
1790 struct input_dev *dev;
1792 dev = kzalloc(sizeof(struct input_dev), GFP_KERNEL);
1794 dev->dev.type = &input_dev_type;
1795 dev->dev.class = &input_class;
1796 device_initialize(&dev->dev);
1797 mutex_init(&dev->mutex);
1798 spin_lock_init(&dev->event_lock);
1799 init_timer(&dev->timer);
1800 INIT_LIST_HEAD(&dev->h_list);
1801 INIT_LIST_HEAD(&dev->node);
1803 dev_set_name(&dev->dev, "input%lu",
1804 (unsigned long)atomic_inc_return(&input_no));
1806 __module_get(THIS_MODULE);
1811 EXPORT_SYMBOL(input_allocate_device);
1813 struct input_devres {
1814 struct input_dev *input;
1817 static int devm_input_device_match(struct device *dev, void *res, void *data)
1819 struct input_devres *devres = res;
1821 return devres->input == data;
1824 static void devm_input_device_release(struct device *dev, void *res)
1826 struct input_devres *devres = res;
1827 struct input_dev *input = devres->input;
1829 dev_dbg(dev, "%s: dropping reference to %s\n",
1830 __func__, dev_name(&input->dev));
1831 input_put_device(input);
1835 * devm_input_allocate_device - allocate managed input device
1836 * @dev: device owning the input device being created
1838 * Returns prepared struct input_dev or %NULL.
1840 * Managed input devices do not need to be explicitly unregistered or
1841 * freed as it will be done automatically when owner device unbinds from
1842 * its driver (or binding fails). Once managed input device is allocated,
1843 * it is ready to be set up and registered in the same fashion as regular
1844 * input device. There are no special devm_input_device_[un]register()
1845 * variants, regular ones work with both managed and unmanaged devices,
1846 * should you need them. In most cases however, managed input device need
1847 * not be explicitly unregistered or freed.
1849 * NOTE: the owner device is set up as parent of input device and users
1850 * should not override it.
1852 struct input_dev *devm_input_allocate_device(struct device *dev)
1854 struct input_dev *input;
1855 struct input_devres *devres;
1857 devres = devres_alloc(devm_input_device_release,
1858 sizeof(struct input_devres), GFP_KERNEL);
1862 input = input_allocate_device();
1864 devres_free(devres);
1868 input->dev.parent = dev;
1869 input->devres_managed = true;
1871 devres->input = input;
1872 devres_add(dev, devres);
1876 EXPORT_SYMBOL(devm_input_allocate_device);
1879 * input_free_device - free memory occupied by input_dev structure
1880 * @dev: input device to free
1882 * This function should only be used if input_register_device()
1883 * was not called yet or if it failed. Once device was registered
1884 * use input_unregister_device() and memory will be freed once last
1885 * reference to the device is dropped.
1887 * Device should be allocated by input_allocate_device().
1889 * NOTE: If there are references to the input device then memory
1890 * will not be freed until last reference is dropped.
1892 void input_free_device(struct input_dev *dev)
1895 if (dev->devres_managed)
1896 WARN_ON(devres_destroy(dev->dev.parent,
1897 devm_input_device_release,
1898 devm_input_device_match,
1900 input_put_device(dev);
1903 EXPORT_SYMBOL(input_free_device);
1906 * input_set_capability - mark device as capable of a certain event
1907 * @dev: device that is capable of emitting or accepting event
1908 * @type: type of the event (EV_KEY, EV_REL, etc...)
1911 * In addition to setting up corresponding bit in appropriate capability
1912 * bitmap the function also adjusts dev->evbit.
1914 void input_set_capability(struct input_dev *dev, unsigned int type, unsigned int code)
1918 __set_bit(code, dev->keybit);
1922 __set_bit(code, dev->relbit);
1926 input_alloc_absinfo(dev);
1930 __set_bit(code, dev->absbit);
1934 __set_bit(code, dev->mscbit);
1938 __set_bit(code, dev->swbit);
1942 __set_bit(code, dev->ledbit);
1946 __set_bit(code, dev->sndbit);
1950 __set_bit(code, dev->ffbit);
1958 pr_err("input_set_capability: unknown type %u (code %u)\n",
1964 __set_bit(type, dev->evbit);
1966 EXPORT_SYMBOL(input_set_capability);
1968 static unsigned int input_estimate_events_per_packet(struct input_dev *dev)
1972 unsigned int events;
1975 mt_slots = dev->mt->num_slots;
1976 } else if (test_bit(ABS_MT_TRACKING_ID, dev->absbit)) {
1977 mt_slots = dev->absinfo[ABS_MT_TRACKING_ID].maximum -
1978 dev->absinfo[ABS_MT_TRACKING_ID].minimum + 1,
1979 mt_slots = clamp(mt_slots, 2, 32);
1980 } else if (test_bit(ABS_MT_POSITION_X, dev->absbit)) {
1986 events = mt_slots + 1; /* count SYN_MT_REPORT and SYN_REPORT */
1988 if (test_bit(EV_ABS, dev->evbit))
1989 for_each_set_bit(i, dev->absbit, ABS_CNT)
1990 events += input_is_mt_axis(i) ? mt_slots : 1;
1992 if (test_bit(EV_REL, dev->evbit))
1993 events += bitmap_weight(dev->relbit, REL_CNT);
1995 /* Make room for KEY and MSC events */
2001 #define INPUT_CLEANSE_BITMASK(dev, type, bits) \
2003 if (!test_bit(EV_##type, dev->evbit)) \
2004 memset(dev->bits##bit, 0, \
2005 sizeof(dev->bits##bit)); \
2008 static void input_cleanse_bitmasks(struct input_dev *dev)
2010 INPUT_CLEANSE_BITMASK(dev, KEY, key);
2011 INPUT_CLEANSE_BITMASK(dev, REL, rel);
2012 INPUT_CLEANSE_BITMASK(dev, ABS, abs);
2013 INPUT_CLEANSE_BITMASK(dev, MSC, msc);
2014 INPUT_CLEANSE_BITMASK(dev, LED, led);
2015 INPUT_CLEANSE_BITMASK(dev, SND, snd);
2016 INPUT_CLEANSE_BITMASK(dev, FF, ff);
2017 INPUT_CLEANSE_BITMASK(dev, SW, sw);
2020 static void __input_unregister_device(struct input_dev *dev)
2022 struct input_handle *handle, *next;
2024 input_disconnect_device(dev);
2026 mutex_lock(&input_mutex);
2028 list_for_each_entry_safe(handle, next, &dev->h_list, d_node)
2029 handle->handler->disconnect(handle);
2030 WARN_ON(!list_empty(&dev->h_list));
2032 del_timer_sync(&dev->timer);
2033 list_del_init(&dev->node);
2035 input_wakeup_procfs_readers();
2037 mutex_unlock(&input_mutex);
2039 device_del(&dev->dev);
2042 static void devm_input_device_unregister(struct device *dev, void *res)
2044 struct input_devres *devres = res;
2045 struct input_dev *input = devres->input;
2047 dev_dbg(dev, "%s: unregistering device %s\n",
2048 __func__, dev_name(&input->dev));
2049 __input_unregister_device(input);
2053 * input_enable_softrepeat - enable software autorepeat
2054 * @dev: input device
2055 * @delay: repeat delay
2056 * @period: repeat period
2058 * Enable software autorepeat on the input device.
2060 void input_enable_softrepeat(struct input_dev *dev, int delay, int period)
2062 dev->timer.data = (unsigned long) dev;
2063 dev->timer.function = input_repeat_key;
2064 dev->rep[REP_DELAY] = delay;
2065 dev->rep[REP_PERIOD] = period;
2067 EXPORT_SYMBOL(input_enable_softrepeat);
2070 * input_register_device - register device with input core
2071 * @dev: device to be registered
2073 * This function registers device with input core. The device must be
2074 * allocated with input_allocate_device() and all it's capabilities
2075 * set up before registering.
2076 * If function fails the device must be freed with input_free_device().
2077 * Once device has been successfully registered it can be unregistered
2078 * with input_unregister_device(); input_free_device() should not be
2079 * called in this case.
2081 * Note that this function is also used to register managed input devices
2082 * (ones allocated with devm_input_allocate_device()). Such managed input
2083 * devices need not be explicitly unregistered or freed, their tear down
2084 * is controlled by the devres infrastructure. It is also worth noting
2085 * that tear down of managed input devices is internally a 2-step process:
2086 * registered managed input device is first unregistered, but stays in
2087 * memory and can still handle input_event() calls (although events will
2088 * not be delivered anywhere). The freeing of managed input device will
2089 * happen later, when devres stack is unwound to the point where device
2090 * allocation was made.
2092 int input_register_device(struct input_dev *dev)
2094 struct input_devres *devres = NULL;
2095 struct input_handler *handler;
2096 unsigned int packet_size;
2100 if (dev->devres_managed) {
2101 devres = devres_alloc(devm_input_device_unregister,
2102 sizeof(struct input_devres), GFP_KERNEL);
2106 devres->input = dev;
2109 /* Every input device generates EV_SYN/SYN_REPORT events. */
2110 __set_bit(EV_SYN, dev->evbit);
2112 /* KEY_RESERVED is not supposed to be transmitted to userspace. */
2113 __clear_bit(KEY_RESERVED, dev->keybit);
2115 /* Buttonpads should not map BTN_RIGHT and/or BTN_MIDDLE. */
2116 if (test_bit(INPUT_PROP_BUTTONPAD, dev->propbit)) {
2117 __clear_bit(BTN_RIGHT, dev->keybit);
2118 __clear_bit(BTN_MIDDLE, dev->keybit);
2121 /* Make sure that bitmasks not mentioned in dev->evbit are clean. */
2122 input_cleanse_bitmasks(dev);
2124 packet_size = input_estimate_events_per_packet(dev);
2125 if (dev->hint_events_per_packet < packet_size)
2126 dev->hint_events_per_packet = packet_size;
2128 dev->max_vals = dev->hint_events_per_packet + 2;
2129 dev->vals = kcalloc(dev->max_vals, sizeof(*dev->vals), GFP_KERNEL);
2132 goto err_devres_free;
2136 * If delay and period are pre-set by the driver, then autorepeating
2137 * is handled by the driver itself and we don't do it in input.c.
2139 if (!dev->rep[REP_DELAY] && !dev->rep[REP_PERIOD])
2140 input_enable_softrepeat(dev, 250, 33);
2142 if (!dev->getkeycode)
2143 dev->getkeycode = input_default_getkeycode;
2145 if (!dev->setkeycode)
2146 dev->setkeycode = input_default_setkeycode;
2148 error = device_add(&dev->dev);
2152 path = kobject_get_path(&dev->dev.kobj, GFP_KERNEL);
2153 pr_info("%s as %s\n",
2154 dev->name ? dev->name : "Unspecified device",
2155 path ? path : "N/A");
2158 error = mutex_lock_interruptible(&input_mutex);
2160 goto err_device_del;
2162 list_add_tail(&dev->node, &input_dev_list);
2164 list_for_each_entry(handler, &input_handler_list, node)
2165 input_attach_handler(dev, handler);
2167 input_wakeup_procfs_readers();
2169 mutex_unlock(&input_mutex);
2171 if (dev->devres_managed) {
2172 dev_dbg(dev->dev.parent, "%s: registering %s with devres.\n",
2173 __func__, dev_name(&dev->dev));
2174 devres_add(dev->dev.parent, devres);
2179 device_del(&dev->dev);
2184 devres_free(devres);
2187 EXPORT_SYMBOL(input_register_device);
2190 * input_unregister_device - unregister previously registered device
2191 * @dev: device to be unregistered
2193 * This function unregisters an input device. Once device is unregistered
2194 * the caller should not try to access it as it may get freed at any moment.
2196 void input_unregister_device(struct input_dev *dev)
2198 if (dev->devres_managed) {
2199 WARN_ON(devres_destroy(dev->dev.parent,
2200 devm_input_device_unregister,
2201 devm_input_device_match,
2203 __input_unregister_device(dev);
2205 * We do not do input_put_device() here because it will be done
2206 * when 2nd devres fires up.
2209 __input_unregister_device(dev);
2210 input_put_device(dev);
2213 EXPORT_SYMBOL(input_unregister_device);
2216 * input_register_handler - register a new input handler
2217 * @handler: handler to be registered
2219 * This function registers a new input handler (interface) for input
2220 * devices in the system and attaches it to all input devices that
2221 * are compatible with the handler.
2223 int input_register_handler(struct input_handler *handler)
2225 struct input_dev *dev;
2228 error = mutex_lock_interruptible(&input_mutex);
2232 INIT_LIST_HEAD(&handler->h_list);
2234 list_add_tail(&handler->node, &input_handler_list);
2236 list_for_each_entry(dev, &input_dev_list, node)
2237 input_attach_handler(dev, handler);
2239 input_wakeup_procfs_readers();
2241 mutex_unlock(&input_mutex);
2244 EXPORT_SYMBOL(input_register_handler);
2247 * input_unregister_handler - unregisters an input handler
2248 * @handler: handler to be unregistered
2250 * This function disconnects a handler from its input devices and
2251 * removes it from lists of known handlers.
2253 void input_unregister_handler(struct input_handler *handler)
2255 struct input_handle *handle, *next;
2257 mutex_lock(&input_mutex);
2259 list_for_each_entry_safe(handle, next, &handler->h_list, h_node)
2260 handler->disconnect(handle);
2261 WARN_ON(!list_empty(&handler->h_list));
2263 list_del_init(&handler->node);
2265 input_wakeup_procfs_readers();
2267 mutex_unlock(&input_mutex);
2269 EXPORT_SYMBOL(input_unregister_handler);
2272 * input_handler_for_each_handle - handle iterator
2273 * @handler: input handler to iterate
2274 * @data: data for the callback
2275 * @fn: function to be called for each handle
2277 * Iterate over @bus's list of devices, and call @fn for each, passing
2278 * it @data and stop when @fn returns a non-zero value. The function is
2279 * using RCU to traverse the list and therefore may be using in atomic
2280 * contexts. The @fn callback is invoked from RCU critical section and
2281 * thus must not sleep.
2283 int input_handler_for_each_handle(struct input_handler *handler, void *data,
2284 int (*fn)(struct input_handle *, void *))
2286 struct input_handle *handle;
2291 list_for_each_entry_rcu(handle, &handler->h_list, h_node) {
2292 retval = fn(handle, data);
2301 EXPORT_SYMBOL(input_handler_for_each_handle);
2304 * input_register_handle - register a new input handle
2305 * @handle: handle to register
2307 * This function puts a new input handle onto device's
2308 * and handler's lists so that events can flow through
2309 * it once it is opened using input_open_device().
2311 * This function is supposed to be called from handler's
2314 int input_register_handle(struct input_handle *handle)
2316 struct input_handler *handler = handle->handler;
2317 struct input_dev *dev = handle->dev;
2321 * We take dev->mutex here to prevent race with
2322 * input_release_device().
2324 error = mutex_lock_interruptible(&dev->mutex);
2329 * Filters go to the head of the list, normal handlers
2332 if (handler->filter)
2333 list_add_rcu(&handle->d_node, &dev->h_list);
2335 list_add_tail_rcu(&handle->d_node, &dev->h_list);
2337 mutex_unlock(&dev->mutex);
2340 * Since we are supposed to be called from ->connect()
2341 * which is mutually exclusive with ->disconnect()
2342 * we can't be racing with input_unregister_handle()
2343 * and so separate lock is not needed here.
2345 list_add_tail_rcu(&handle->h_node, &handler->h_list);
2348 handler->start(handle);
2352 EXPORT_SYMBOL(input_register_handle);
2355 * input_unregister_handle - unregister an input handle
2356 * @handle: handle to unregister
2358 * This function removes input handle from device's
2359 * and handler's lists.
2361 * This function is supposed to be called from handler's
2362 * disconnect() method.
2364 void input_unregister_handle(struct input_handle *handle)
2366 struct input_dev *dev = handle->dev;
2368 list_del_rcu(&handle->h_node);
2371 * Take dev->mutex to prevent race with input_release_device().
2373 mutex_lock(&dev->mutex);
2374 list_del_rcu(&handle->d_node);
2375 mutex_unlock(&dev->mutex);
2379 EXPORT_SYMBOL(input_unregister_handle);
2382 * input_get_new_minor - allocates a new input minor number
2383 * @legacy_base: beginning or the legacy range to be searched
2384 * @legacy_num: size of legacy range
2385 * @allow_dynamic: whether we can also take ID from the dynamic range
2387 * This function allocates a new device minor for from input major namespace.
2388 * Caller can request legacy minor by specifying @legacy_base and @legacy_num
2389 * parameters and whether ID can be allocated from dynamic range if there are
2390 * no free IDs in legacy range.
2392 int input_get_new_minor(int legacy_base, unsigned int legacy_num,
2396 * This function should be called from input handler's ->connect()
2397 * methods, which are serialized with input_mutex, so no additional
2398 * locking is needed here.
2400 if (legacy_base >= 0) {
2401 int minor = ida_simple_get(&input_ida,
2403 legacy_base + legacy_num,
2405 if (minor >= 0 || !allow_dynamic)
2409 return ida_simple_get(&input_ida,
2410 INPUT_FIRST_DYNAMIC_DEV, INPUT_MAX_CHAR_DEVICES,
2413 EXPORT_SYMBOL(input_get_new_minor);
2416 * input_free_minor - release previously allocated minor
2417 * @minor: minor to be released
2419 * This function releases previously allocated input minor so that it can be
2422 void input_free_minor(unsigned int minor)
2424 ida_simple_remove(&input_ida, minor);
2426 EXPORT_SYMBOL(input_free_minor);
2428 static int __init input_init(void)
2432 err = class_register(&input_class);
2434 pr_err("unable to register input_dev class\n");
2438 err = input_proc_init();
2442 err = register_chrdev_region(MKDEV(INPUT_MAJOR, 0),
2443 INPUT_MAX_CHAR_DEVICES, "input");
2445 pr_err("unable to register char major %d", INPUT_MAJOR);
2451 fail2: input_proc_exit();
2452 fail1: class_unregister(&input_class);
2456 static void __exit input_exit(void)
2459 unregister_chrdev_region(MKDEV(INPUT_MAJOR, 0),
2460 INPUT_MAX_CHAR_DEVICES);
2461 class_unregister(&input_class);
2464 subsys_initcall(input_init);
2465 module_exit(input_exit);