1 // SPDX-License-Identifier: GPL-2.0-only
3 * HID raw devices, giving access to raw HID events.
5 * In comparison to hiddev, this device does not process the
6 * hid events at all (no parsing, no lookups). This lets applications
7 * to work on raw hid events as they want to, and avoids a need to
8 * use a transport-specific userspace libhid/libusb libraries.
10 * Copyright (c) 2007-2014 Jiri Kosina
14 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
17 #include <linux/module.h>
18 #include <linux/errno.h>
19 #include <linux/kernel.h>
20 #include <linux/init.h>
21 #include <linux/cdev.h>
22 #include <linux/poll.h>
23 #include <linux/device.h>
24 #include <linux/major.h>
25 #include <linux/slab.h>
26 #include <linux/hid.h>
27 #include <linux/mutex.h>
28 #include <linux/sched/signal.h>
29 #include <linux/string.h>
31 #include <linux/hidraw.h>
33 static int hidraw_major
;
34 static struct cdev hidraw_cdev
;
35 static const struct class hidraw_class
= {
38 static struct hidraw
*hidraw_table
[HIDRAW_MAX_DEVICES
];
39 static DECLARE_RWSEM(minors_rwsem
);
41 static inline bool hidraw_is_revoked(struct hidraw_list
*list
)
46 static ssize_t
hidraw_read(struct file
*file
, char __user
*buffer
, size_t count
, loff_t
*ppos
)
48 struct hidraw_list
*list
= file
->private_data
;
50 DECLARE_WAITQUEUE(wait
, current
);
52 if (hidraw_is_revoked(list
))
55 mutex_lock(&list
->read_mutex
);
58 if (list
->head
== list
->tail
) {
59 add_wait_queue(&list
->hidraw
->wait
, &wait
);
60 set_current_state(TASK_INTERRUPTIBLE
);
62 while (list
->head
== list
->tail
) {
63 if (signal_pending(current
)) {
67 if (!list
->hidraw
->exist
) {
71 if (file
->f_flags
& O_NONBLOCK
) {
76 /* allow O_NONBLOCK to work well from other threads */
77 mutex_unlock(&list
->read_mutex
);
79 mutex_lock(&list
->read_mutex
);
80 set_current_state(TASK_INTERRUPTIBLE
);
83 set_current_state(TASK_RUNNING
);
84 remove_wait_queue(&list
->hidraw
->wait
, &wait
);
90 len
= list
->buffer
[list
->tail
].len
> count
?
91 count
: list
->buffer
[list
->tail
].len
;
93 if (list
->buffer
[list
->tail
].value
) {
94 if (copy_to_user(buffer
, list
->buffer
[list
->tail
].value
, len
)) {
101 kfree(list
->buffer
[list
->tail
].value
);
102 list
->buffer
[list
->tail
].value
= NULL
;
103 list
->tail
= (list
->tail
+ 1) & (HIDRAW_BUFFER_SIZE
- 1);
106 mutex_unlock(&list
->read_mutex
);
111 * The first byte of the report buffer is expected to be a report number.
113 static ssize_t
hidraw_send_report(struct file
*file
, const char __user
*buffer
, size_t count
, unsigned char report_type
)
115 unsigned int minor
= iminor(file_inode(file
));
116 struct hid_device
*dev
;
120 lockdep_assert_held(&minors_rwsem
);
122 if (!hidraw_table
[minor
] || !hidraw_table
[minor
]->exist
) {
127 dev
= hidraw_table
[minor
]->hid
;
129 if (count
> HID_MAX_BUFFER_SIZE
) {
130 hid_warn(dev
, "pid %d passed too large report\n",
131 task_pid_nr(current
));
137 hid_warn(dev
, "pid %d passed too short report\n",
138 task_pid_nr(current
));
143 buf
= memdup_user(buffer
, count
);
149 if ((report_type
== HID_OUTPUT_REPORT
) &&
150 !(dev
->quirks
& HID_QUIRK_NO_OUTPUT_REPORTS_ON_INTR_EP
)) {
151 ret
= __hid_hw_output_report(dev
, buf
, count
, (u64
)(long)file
, false);
153 * compatibility with old implementation of USB-HID and I2C-HID:
154 * if the device does not support receiving output reports,
155 * on an interrupt endpoint, fallback to SET_REPORT HID command.
161 ret
= __hid_hw_raw_request(dev
, buf
[0], buf
, count
, report_type
,
162 HID_REQ_SET_REPORT
, (u64
)(long)file
, false);
170 static ssize_t
hidraw_write(struct file
*file
, const char __user
*buffer
, size_t count
, loff_t
*ppos
)
172 struct hidraw_list
*list
= file
->private_data
;
174 down_read(&minors_rwsem
);
175 if (hidraw_is_revoked(list
))
178 ret
= hidraw_send_report(file
, buffer
, count
, HID_OUTPUT_REPORT
);
179 up_read(&minors_rwsem
);
185 * This function performs a Get_Report transfer over the control endpoint
186 * per section 7.2.1 of the HID specification, version 1.1. The first byte
187 * of buffer is the report number to request, or 0x0 if the device does not
188 * use numbered reports. The report_type parameter can be HID_FEATURE_REPORT
189 * or HID_INPUT_REPORT.
191 static ssize_t
hidraw_get_report(struct file
*file
, char __user
*buffer
, size_t count
, unsigned char report_type
)
193 unsigned int minor
= iminor(file_inode(file
));
194 struct hid_device
*dev
;
197 unsigned char report_number
;
199 lockdep_assert_held(&minors_rwsem
);
201 if (!hidraw_table
[minor
] || !hidraw_table
[minor
]->exist
) {
206 dev
= hidraw_table
[minor
]->hid
;
208 if (!dev
->ll_driver
->raw_request
) {
213 if (count
> HID_MAX_BUFFER_SIZE
) {
214 hid_warn(dev
, "pid %d passed too large report\n",
215 task_pid_nr(current
));
221 hid_warn(dev
, "pid %d passed too short report\n",
222 task_pid_nr(current
));
227 buf
= kmalloc(count
, GFP_KERNEL
);
234 * Read the first byte from the user. This is the report number,
235 * which is passed to hid_hw_raw_request().
237 if (copy_from_user(&report_number
, buffer
, 1)) {
242 ret
= __hid_hw_raw_request(dev
, report_number
, buf
, count
, report_type
,
243 HID_REQ_GET_REPORT
, (u64
)(long)file
, false);
248 len
= (ret
< count
) ? ret
: count
;
250 if (copy_to_user(buffer
, buf
, len
)) {
263 static __poll_t
hidraw_poll(struct file
*file
, poll_table
*wait
)
265 struct hidraw_list
*list
= file
->private_data
;
266 __poll_t mask
= EPOLLOUT
| EPOLLWRNORM
; /* hidraw is always writable */
268 poll_wait(file
, &list
->hidraw
->wait
, wait
);
269 if (list
->head
!= list
->tail
)
270 mask
|= EPOLLIN
| EPOLLRDNORM
;
271 if (!list
->hidraw
->exist
|| hidraw_is_revoked(list
))
272 mask
|= EPOLLERR
| EPOLLHUP
;
276 static int hidraw_open(struct inode
*inode
, struct file
*file
)
278 unsigned int minor
= iminor(inode
);
280 struct hidraw_list
*list
;
284 if (!(list
= kzalloc(sizeof(struct hidraw_list
), GFP_KERNEL
))) {
290 * Technically not writing to the hidraw_table but a write lock is
291 * required to protect the device refcount. This is symmetrical to
294 down_write(&minors_rwsem
);
295 if (!hidraw_table
[minor
] || !hidraw_table
[minor
]->exist
) {
300 dev
= hidraw_table
[minor
];
302 err
= hid_hw_power(dev
->hid
, PM_HINT_FULLON
);
308 err
= hid_hw_open(dev
->hid
);
310 hid_hw_power(dev
->hid
, PM_HINT_NORMAL
);
316 list
->hidraw
= hidraw_table
[minor
];
317 mutex_init(&list
->read_mutex
);
318 spin_lock_irqsave(&hidraw_table
[minor
]->list_lock
, flags
);
319 list_add_tail(&list
->node
, &hidraw_table
[minor
]->list
);
320 spin_unlock_irqrestore(&hidraw_table
[minor
]->list_lock
, flags
);
321 file
->private_data
= list
;
323 up_write(&minors_rwsem
);
331 static int hidraw_fasync(int fd
, struct file
*file
, int on
)
333 struct hidraw_list
*list
= file
->private_data
;
335 if (hidraw_is_revoked(list
))
338 return fasync_helper(fd
, file
, on
, &list
->fasync
);
341 static void drop_ref(struct hidraw
*hidraw
, int exists_bit
)
346 hid_hw_close(hidraw
->hid
);
347 wake_up_interruptible(&hidraw
->wait
);
349 device_destroy(&hidraw_class
,
350 MKDEV(hidraw_major
, hidraw
->minor
));
355 if (!hidraw
->exist
) {
356 hidraw_table
[hidraw
->minor
] = NULL
;
359 /* close device for last reader */
360 hid_hw_close(hidraw
->hid
);
361 hid_hw_power(hidraw
->hid
, PM_HINT_NORMAL
);
366 static int hidraw_release(struct inode
* inode
, struct file
* file
)
368 unsigned int minor
= iminor(inode
);
369 struct hidraw_list
*list
= file
->private_data
;
372 down_write(&minors_rwsem
);
374 spin_lock_irqsave(&hidraw_table
[minor
]->list_lock
, flags
);
375 while (list
->tail
!= list
->head
) {
376 kfree(list
->buffer
[list
->tail
].value
);
377 list
->buffer
[list
->tail
].value
= NULL
;
378 list
->tail
= (list
->tail
+ 1) & (HIDRAW_BUFFER_SIZE
- 1);
380 list_del(&list
->node
);
381 spin_unlock_irqrestore(&hidraw_table
[minor
]->list_lock
, flags
);
384 drop_ref(hidraw_table
[minor
], 0);
386 up_write(&minors_rwsem
);
390 static int hidraw_revoke(struct hidraw_list
*list
)
392 list
->revoked
= true;
397 static long hidraw_ioctl(struct file
*file
, unsigned int cmd
,
400 struct inode
*inode
= file_inode(file
);
401 unsigned int minor
= iminor(inode
);
404 struct hidraw_list
*list
= file
->private_data
;
405 void __user
*user_arg
= (void __user
*) arg
;
407 down_read(&minors_rwsem
);
408 dev
= hidraw_table
[minor
];
409 if (!dev
|| !dev
->exist
|| hidraw_is_revoked(list
)) {
415 case HIDIOCGRDESCSIZE
:
416 if (put_user(dev
->hid
->rsize
, (int __user
*)arg
))
424 if (get_user(len
, (int __user
*)arg
))
426 else if (len
> HID_MAX_DESCRIPTOR_SIZE
- 1)
428 else if (copy_to_user(user_arg
+ offsetof(
429 struct hidraw_report_descriptor
,
432 min(dev
->hid
->rsize
, len
)))
438 struct hidraw_devinfo dinfo
;
440 dinfo
.bustype
= dev
->hid
->bus
;
441 dinfo
.vendor
= dev
->hid
->vendor
;
442 dinfo
.product
= dev
->hid
->product
;
443 if (copy_to_user(user_arg
, &dinfo
, sizeof(dinfo
)))
452 ret
= hidraw_revoke(list
);
457 struct hid_device
*hid
= dev
->hid
;
458 if (_IOC_TYPE(cmd
) != 'H') {
463 if (_IOC_NR(cmd
) == _IOC_NR(HIDIOCSFEATURE(0))) {
464 int len
= _IOC_SIZE(cmd
);
465 ret
= hidraw_send_report(file
, user_arg
, len
, HID_FEATURE_REPORT
);
468 if (_IOC_NR(cmd
) == _IOC_NR(HIDIOCGFEATURE(0))) {
469 int len
= _IOC_SIZE(cmd
);
470 ret
= hidraw_get_report(file
, user_arg
, len
, HID_FEATURE_REPORT
);
474 if (_IOC_NR(cmd
) == _IOC_NR(HIDIOCSINPUT(0))) {
475 int len
= _IOC_SIZE(cmd
);
476 ret
= hidraw_send_report(file
, user_arg
, len
, HID_INPUT_REPORT
);
479 if (_IOC_NR(cmd
) == _IOC_NR(HIDIOCGINPUT(0))) {
480 int len
= _IOC_SIZE(cmd
);
481 ret
= hidraw_get_report(file
, user_arg
, len
, HID_INPUT_REPORT
);
485 if (_IOC_NR(cmd
) == _IOC_NR(HIDIOCSOUTPUT(0))) {
486 int len
= _IOC_SIZE(cmd
);
487 ret
= hidraw_send_report(file
, user_arg
, len
, HID_OUTPUT_REPORT
);
490 if (_IOC_NR(cmd
) == _IOC_NR(HIDIOCGOUTPUT(0))) {
491 int len
= _IOC_SIZE(cmd
);
492 ret
= hidraw_get_report(file
, user_arg
, len
, HID_OUTPUT_REPORT
);
496 /* Begin Read-only ioctls. */
497 if (_IOC_DIR(cmd
) != _IOC_READ
) {
502 if (_IOC_NR(cmd
) == _IOC_NR(HIDIOCGRAWNAME(0))) {
503 int len
= strlen(hid
->name
) + 1;
504 if (len
> _IOC_SIZE(cmd
))
505 len
= _IOC_SIZE(cmd
);
506 ret
= copy_to_user(user_arg
, hid
->name
, len
) ?
511 if (_IOC_NR(cmd
) == _IOC_NR(HIDIOCGRAWPHYS(0))) {
512 int len
= strlen(hid
->phys
) + 1;
513 if (len
> _IOC_SIZE(cmd
))
514 len
= _IOC_SIZE(cmd
);
515 ret
= copy_to_user(user_arg
, hid
->phys
, len
) ?
520 if (_IOC_NR(cmd
) == _IOC_NR(HIDIOCGRAWUNIQ(0))) {
521 int len
= strlen(hid
->uniq
) + 1;
522 if (len
> _IOC_SIZE(cmd
))
523 len
= _IOC_SIZE(cmd
);
524 ret
= copy_to_user(user_arg
, hid
->uniq
, len
) ?
533 up_read(&minors_rwsem
);
537 static const struct file_operations hidraw_ops
= {
538 .owner
= THIS_MODULE
,
540 .write
= hidraw_write
,
543 .release
= hidraw_release
,
544 .unlocked_ioctl
= hidraw_ioctl
,
545 .fasync
= hidraw_fasync
,
546 .compat_ioctl
= compat_ptr_ioctl
,
547 .llseek
= noop_llseek
,
550 int hidraw_report_event(struct hid_device
*hid
, u8
*data
, int len
)
552 struct hidraw
*dev
= hid
->hidraw
;
553 struct hidraw_list
*list
;
557 spin_lock_irqsave(&dev
->list_lock
, flags
);
558 list_for_each_entry(list
, &dev
->list
, node
) {
559 int new_head
= (list
->head
+ 1) & (HIDRAW_BUFFER_SIZE
- 1);
561 if (hidraw_is_revoked(list
) || new_head
== list
->tail
)
564 if (!(list
->buffer
[list
->head
].value
= kmemdup(data
, len
, GFP_ATOMIC
))) {
568 list
->buffer
[list
->head
].len
= len
;
569 list
->head
= new_head
;
570 kill_fasync(&list
->fasync
, SIGIO
, POLL_IN
);
572 spin_unlock_irqrestore(&dev
->list_lock
, flags
);
574 wake_up_interruptible(&dev
->wait
);
577 EXPORT_SYMBOL_GPL(hidraw_report_event
);
579 int hidraw_connect(struct hid_device
*hid
)
584 /* we accept any HID device, all applications */
586 dev
= kzalloc(sizeof(struct hidraw
), GFP_KERNEL
);
592 down_write(&minors_rwsem
);
594 for (minor
= 0; minor
< HIDRAW_MAX_DEVICES
; minor
++) {
595 if (hidraw_table
[minor
])
597 hidraw_table
[minor
] = dev
;
603 up_write(&minors_rwsem
);
608 dev
->dev
= device_create(&hidraw_class
, &hid
->dev
, MKDEV(hidraw_major
, minor
),
609 NULL
, "%s%d", "hidraw", minor
);
611 if (IS_ERR(dev
->dev
)) {
612 hidraw_table
[minor
] = NULL
;
613 up_write(&minors_rwsem
);
614 result
= PTR_ERR(dev
->dev
);
619 init_waitqueue_head(&dev
->wait
);
620 spin_lock_init(&dev
->list_lock
);
621 INIT_LIST_HEAD(&dev
->list
);
629 up_write(&minors_rwsem
);
634 EXPORT_SYMBOL_GPL(hidraw_connect
);
636 void hidraw_disconnect(struct hid_device
*hid
)
638 struct hidraw
*hidraw
= hid
->hidraw
;
640 down_write(&minors_rwsem
);
644 up_write(&minors_rwsem
);
646 EXPORT_SYMBOL_GPL(hidraw_disconnect
);
648 int __init
hidraw_init(void)
653 result
= alloc_chrdev_region(&dev_id
, HIDRAW_FIRST_MINOR
,
654 HIDRAW_MAX_DEVICES
, "hidraw");
656 pr_warn("can't get major number\n");
660 hidraw_major
= MAJOR(dev_id
);
662 result
= class_register(&hidraw_class
);
666 cdev_init(&hidraw_cdev
, &hidraw_ops
);
667 result
= cdev_add(&hidraw_cdev
, dev_id
, HIDRAW_MAX_DEVICES
);
671 pr_info("raw HID events driver (C) Jiri Kosina\n");
676 class_unregister(&hidraw_class
);
678 unregister_chrdev_region(dev_id
, HIDRAW_MAX_DEVICES
);
682 void hidraw_exit(void)
684 dev_t dev_id
= MKDEV(hidraw_major
, 0);
686 cdev_del(&hidraw_cdev
);
687 class_unregister(&hidraw_class
);
688 unregister_chrdev_region(dev_id
, HIDRAW_MAX_DEVICES
);