USB: replace remaining __FUNCTION__ occurrences
[linux-block.git] / drivers / usb / core / devio.c
CommitLineData
1da177e4
LT
1/*****************************************************************************/
2
3/*
4 * devio.c -- User space communication with USB devices.
5 *
6 * Copyright (C) 1999-2000 Thomas Sailer (sailer@ife.ee.ethz.ch)
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 *
22 * $Id: devio.c,v 1.7 2000/02/01 17:28:48 fliegl Exp $
23 *
24 * This file implements the usbfs/x/y files, where
25 * x is the bus number and y the device number.
26 *
27 * It allows user space programs/"drivers" to communicate directly
28 * with USB devices without intervening kernel driver.
29 *
30 * Revision history
31 * 22.12.1999 0.1 Initial release (split from proc_usb.c)
32 * 04.01.2000 0.2 Turned into its own filesystem
46113830
HW
33 * 30.09.2005 0.3 Fix user-triggerable oops in async URB delivery
34 * (CAN-2005-3055)
1da177e4
LT
35 */
36
37/*****************************************************************************/
38
39#include <linux/fs.h>
40#include <linux/mm.h>
41#include <linux/slab.h>
42#include <linux/smp_lock.h>
43#include <linux/signal.h>
44#include <linux/poll.h>
45#include <linux/module.h>
46#include <linux/usb.h>
47#include <linux/usbdevice_fs.h>
fbf82fd2 48#include <linux/cdev.h>
a7b986b3 49#include <linux/notifier.h>
7a01955f 50#include <linux/security.h>
1da177e4
LT
51#include <asm/uaccess.h>
52#include <asm/byteorder.h>
53#include <linux/moduleparam.h>
54
55#include "hcd.h" /* for usbcore internals */
56#include "usb.h"
57
fbf82fd2
KS
58#define USB_MAXBUS 64
59#define USB_DEVICE_MAX USB_MAXBUS * 128
fbf82fd2 60
4a2a8a2c
AS
61/* Mutual exclusion for removal, open, and release */
62DEFINE_MUTEX(usbfs_mutex);
63
1da177e4
LT
64struct async {
65 struct list_head asynclist;
66 struct dev_state *ps;
2425c08b 67 struct pid *pid;
46113830 68 uid_t uid, euid;
1da177e4
LT
69 unsigned int signr;
70 unsigned int ifnum;
71 void __user *userbuffer;
72 void __user *userurb;
73 struct urb *urb;
e015268d 74 int status;
7a01955f 75 u32 secid;
1da177e4
LT
76};
77
04e482ff
GKH
78static int usbfs_snoop;
79module_param(usbfs_snoop, bool, S_IRUGO | S_IWUSR);
80MODULE_PARM_DESC(usbfs_snoop, "true to log all usbfs traffic");
1da177e4
LT
81
82#define snoop(dev, format, arg...) \
83 do { \
84 if (usbfs_snoop) \
04e482ff 85 dev_info(dev , format , ## arg); \
1da177e4
LT
86 } while (0)
87
fad21bdf
AS
88#define USB_DEVICE_DEV MKDEV(USB_DEVICE_MAJOR, 0)
89
1da177e4
LT
90
91#define MAX_USBFS_BUFFER_SIZE 16384
92
04e482ff 93static inline int connected(struct dev_state *ps)
1da177e4 94{
349710c3
AS
95 return (!list_empty(&ps->list) &&
96 ps->dev->state != USB_STATE_NOTATTACHED);
1da177e4
LT
97}
98
99static loff_t usbdev_lseek(struct file *file, loff_t offset, int orig)
100{
101 loff_t ret;
102
103 lock_kernel();
104
105 switch (orig) {
106 case 0:
107 file->f_pos = offset;
108 ret = file->f_pos;
109 break;
110 case 1:
111 file->f_pos += offset;
112 ret = file->f_pos;
113 break;
114 case 2:
115 default:
116 ret = -EINVAL;
117 }
118
119 unlock_kernel();
120 return ret;
121}
122
04e482ff
GKH
123static ssize_t usbdev_read(struct file *file, char __user *buf, size_t nbytes,
124 loff_t *ppos)
1da177e4 125{
ec17cf1c 126 struct dev_state *ps = file->private_data;
1da177e4
LT
127 struct usb_device *dev = ps->dev;
128 ssize_t ret = 0;
129 unsigned len;
130 loff_t pos;
131 int i;
132
133 pos = *ppos;
134 usb_lock_device(dev);
349710c3 135 if (!connected(ps)) {
1da177e4
LT
136 ret = -ENODEV;
137 goto err;
138 } else if (pos < 0) {
139 ret = -EINVAL;
140 goto err;
141 }
142
143 if (pos < sizeof(struct usb_device_descriptor)) {
04e482ff
GKH
144 /* 18 bytes - fits on the stack */
145 struct usb_device_descriptor temp_desc;
8781ba0a
ON
146
147 memcpy(&temp_desc, &dev->descriptor, sizeof(dev->descriptor));
9fcd5c32
AM
148 le16_to_cpus(&temp_desc.bcdUSB);
149 le16_to_cpus(&temp_desc.idVendor);
150 le16_to_cpus(&temp_desc.idProduct);
151 le16_to_cpus(&temp_desc.bcdDevice);
1da177e4
LT
152
153 len = sizeof(struct usb_device_descriptor) - pos;
154 if (len > nbytes)
155 len = nbytes;
8781ba0a 156 if (copy_to_user(buf, ((char *)&temp_desc) + pos, len)) {
1da177e4
LT
157 ret = -EFAULT;
158 goto err;
159 }
1da177e4
LT
160
161 *ppos += len;
162 buf += len;
163 nbytes -= len;
164 ret += len;
165 }
166
167 pos = sizeof(struct usb_device_descriptor);
168 for (i = 0; nbytes && i < dev->descriptor.bNumConfigurations; i++) {
169 struct usb_config_descriptor *config =
170 (struct usb_config_descriptor *)dev->rawdescriptors[i];
171 unsigned int length = le16_to_cpu(config->wTotalLength);
172
173 if (*ppos < pos + length) {
174
175 /* The descriptor may claim to be longer than it
176 * really is. Here is the actual allocated length. */
177 unsigned alloclen =
178 le16_to_cpu(dev->config[i].desc.wTotalLength);
179
180 len = length - (*ppos - pos);
181 if (len > nbytes)
182 len = nbytes;
183
184 /* Simply don't write (skip over) unallocated parts */
185 if (alloclen > (*ppos - pos)) {
186 alloclen -= (*ppos - pos);
187 if (copy_to_user(buf,
188 dev->rawdescriptors[i] + (*ppos - pos),
189 min(len, alloclen))) {
190 ret = -EFAULT;
191 goto err;
192 }
193 }
194
195 *ppos += len;
196 buf += len;
197 nbytes -= len;
198 ret += len;
199 }
200
201 pos += length;
202 }
203
204err:
205 usb_unlock_device(dev);
206 return ret;
207}
208
209/*
210 * async list handling
211 */
212
213static struct async *alloc_async(unsigned int numisoframes)
214{
dd95b814 215 struct async *as;
0a1ef3b5 216
dd95b814 217 as = kzalloc(sizeof(struct async), GFP_KERNEL);
04e482ff
GKH
218 if (!as)
219 return NULL;
1da177e4
LT
220 as->urb = usb_alloc_urb(numisoframes, GFP_KERNEL);
221 if (!as->urb) {
222 kfree(as);
223 return NULL;
224 }
04e482ff 225 return as;
1da177e4
LT
226}
227
228static void free_async(struct async *as)
229{
2425c08b 230 put_pid(as->pid);
6fd19f4b
JJ
231 kfree(as->urb->transfer_buffer);
232 kfree(as->urb->setup_packet);
1da177e4 233 usb_free_urb(as->urb);
6fd19f4b 234 kfree(as);
1da177e4
LT
235}
236
237static inline void async_newpending(struct async *as)
238{
04e482ff
GKH
239 struct dev_state *ps = as->ps;
240 unsigned long flags;
241
242 spin_lock_irqsave(&ps->lock, flags);
243 list_add_tail(&as->asynclist, &ps->async_pending);
244 spin_unlock_irqrestore(&ps->lock, flags);
1da177e4
LT
245}
246
247static inline void async_removepending(struct async *as)
248{
04e482ff
GKH
249 struct dev_state *ps = as->ps;
250 unsigned long flags;
251
252 spin_lock_irqsave(&ps->lock, flags);
253 list_del_init(&as->asynclist);
254 spin_unlock_irqrestore(&ps->lock, flags);
1da177e4
LT
255}
256
257static inline struct async *async_getcompleted(struct dev_state *ps)
258{
04e482ff
GKH
259 unsigned long flags;
260 struct async *as = NULL;
261
262 spin_lock_irqsave(&ps->lock, flags);
263 if (!list_empty(&ps->async_completed)) {
264 as = list_entry(ps->async_completed.next, struct async,
265 asynclist);
266 list_del_init(&as->asynclist);
267 }
268 spin_unlock_irqrestore(&ps->lock, flags);
269 return as;
1da177e4
LT
270}
271
04e482ff
GKH
272static inline struct async *async_getpending(struct dev_state *ps,
273 void __user *userurb)
1da177e4 274{
04e482ff
GKH
275 unsigned long flags;
276 struct async *as;
1da177e4 277
04e482ff 278 spin_lock_irqsave(&ps->lock, flags);
1da177e4
LT
279 list_for_each_entry(as, &ps->async_pending, asynclist)
280 if (as->userurb == userurb) {
281 list_del_init(&as->asynclist);
282 spin_unlock_irqrestore(&ps->lock, flags);
283 return as;
284 }
04e482ff
GKH
285 spin_unlock_irqrestore(&ps->lock, flags);
286 return NULL;
1da177e4
LT
287}
288
e639dd3f
GKH
289static void snoop_urb(struct urb *urb, void __user *userurb)
290{
291 int j;
292 unsigned char *data = urb->transfer_buffer;
293
294 if (!usbfs_snoop)
295 return;
296
93cf9b90
AS
297 dev_info(&urb->dev->dev, "direction=%s\n",
298 usb_urb_dir_in(urb) ? "IN" : "OUT");
e639dd3f
GKH
299 dev_info(&urb->dev->dev, "userurb=%p\n", userurb);
300 dev_info(&urb->dev->dev, "transfer_buffer_length=%d\n",
301 urb->transfer_buffer_length);
302 dev_info(&urb->dev->dev, "actual_length=%d\n", urb->actual_length);
303 dev_info(&urb->dev->dev, "data: ");
304 for (j = 0; j < urb->transfer_buffer_length; ++j)
04e482ff 305 printk("%02x ", data[j]);
e639dd3f
GKH
306 printk("\n");
307}
308
7d12e780 309static void async_completed(struct urb *urb)
1da177e4 310{
04e482ff
GKH
311 struct async *as = urb->context;
312 struct dev_state *ps = as->ps;
1da177e4
LT
313 struct siginfo sinfo;
314
04e482ff
GKH
315 spin_lock(&ps->lock);
316 list_move_tail(&as->asynclist, &ps->async_completed);
317 spin_unlock(&ps->lock);
e015268d 318 as->status = urb->status;
1da177e4
LT
319 if (as->signr) {
320 sinfo.si_signo = as->signr;
e015268d 321 sinfo.si_errno = as->status;
1da177e4
LT
322 sinfo.si_code = SI_ASYNCIO;
323 sinfo.si_addr = as->userurb;
2425c08b 324 kill_pid_info_as_uid(as->signr, &sinfo, as->pid, as->uid,
7a01955f 325 as->euid, as->secid);
1da177e4 326 }
e639dd3f
GKH
327 snoop(&urb->dev->dev, "urb complete\n");
328 snoop_urb(urb, as->userurb);
329 wake_up(&ps->wait);
1da177e4
LT
330}
331
04e482ff 332static void destroy_async(struct dev_state *ps, struct list_head *list)
1da177e4
LT
333{
334 struct async *as;
335 unsigned long flags;
336
337 spin_lock_irqsave(&ps->lock, flags);
338 while (!list_empty(list)) {
339 as = list_entry(list->next, struct async, asynclist);
340 list_del_init(&as->asynclist);
341
342 /* drop the spinlock so the completion handler can run */
343 spin_unlock_irqrestore(&ps->lock, flags);
344 usb_kill_urb(as->urb);
345 spin_lock_irqsave(&ps->lock, flags);
346 }
347 spin_unlock_irqrestore(&ps->lock, flags);
348 as = async_getcompleted(ps);
349 while (as) {
350 free_async(as);
351 as = async_getcompleted(ps);
352 }
353}
354
04e482ff
GKH
355static void destroy_async_on_interface(struct dev_state *ps,
356 unsigned int ifnum)
1da177e4
LT
357{
358 struct list_head *p, *q, hitlist;
359 unsigned long flags;
360
361 INIT_LIST_HEAD(&hitlist);
362 spin_lock_irqsave(&ps->lock, flags);
363 list_for_each_safe(p, q, &ps->async_pending)
364 if (ifnum == list_entry(p, struct async, asynclist)->ifnum)
365 list_move_tail(p, &hitlist);
366 spin_unlock_irqrestore(&ps->lock, flags);
367 destroy_async(ps, &hitlist);
368}
369
370static inline void destroy_all_async(struct dev_state *ps)
371{
04e482ff 372 destroy_async(ps, &ps->async_pending);
1da177e4
LT
373}
374
375/*
376 * interface claims are made only at the request of user level code,
377 * which can also release them (explicitly or by closing files).
378 * they're also undone when devices disconnect.
379 */
380
04e482ff
GKH
381static int driver_probe(struct usb_interface *intf,
382 const struct usb_device_id *id)
1da177e4
LT
383{
384 return -ENODEV;
385}
386
387static void driver_disconnect(struct usb_interface *intf)
388{
04e482ff 389 struct dev_state *ps = usb_get_intfdata(intf);
1da177e4
LT
390 unsigned int ifnum = intf->altsetting->desc.bInterfaceNumber;
391
392 if (!ps)
393 return;
394
395 /* NOTE: this relies on usbcore having canceled and completed
396 * all pending I/O requests; 2.6 does that.
397 */
398
399 if (likely(ifnum < 8*sizeof(ps->ifclaimed)))
400 clear_bit(ifnum, &ps->ifclaimed);
401 else
402 warn("interface number %u out of range", ifnum);
403
04e482ff 404 usb_set_intfdata(intf, NULL);
1da177e4
LT
405
406 /* force async requests to complete */
407 destroy_async_on_interface(ps, ifnum);
408}
409
2e2eb83f
AS
410/* The following routines are merely placeholders. There is no way
411 * to inform a user task about suspend or resumes.
412 */
413static int driver_suspend(struct usb_interface *intf, pm_message_t msg)
414{
415 return 0;
416}
417
418static int driver_resume(struct usb_interface *intf)
419{
420 return 0;
421}
422
1da177e4 423struct usb_driver usbfs_driver = {
1da177e4
LT
424 .name = "usbfs",
425 .probe = driver_probe,
426 .disconnect = driver_disconnect,
2e2eb83f
AS
427 .suspend = driver_suspend,
428 .resume = driver_resume,
1da177e4
LT
429};
430
431static int claimintf(struct dev_state *ps, unsigned int ifnum)
432{
433 struct usb_device *dev = ps->dev;
434 struct usb_interface *intf;
435 int err;
436
437 if (ifnum >= 8*sizeof(ps->ifclaimed))
438 return -EINVAL;
439 /* already claimed */
440 if (test_bit(ifnum, &ps->ifclaimed))
441 return 0;
442
1da177e4
LT
443 intf = usb_ifnum_to_if(dev, ifnum);
444 if (!intf)
445 err = -ENOENT;
446 else
447 err = usb_driver_claim_interface(&usbfs_driver, intf, ps);
1da177e4
LT
448 if (err == 0)
449 set_bit(ifnum, &ps->ifclaimed);
450 return err;
451}
452
453static int releaseintf(struct dev_state *ps, unsigned int ifnum)
454{
455 struct usb_device *dev;
456 struct usb_interface *intf;
457 int err;
458
459 err = -EINVAL;
460 if (ifnum >= 8*sizeof(ps->ifclaimed))
461 return err;
462 dev = ps->dev;
1da177e4
LT
463 intf = usb_ifnum_to_if(dev, ifnum);
464 if (!intf)
465 err = -ENOENT;
466 else if (test_and_clear_bit(ifnum, &ps->ifclaimed)) {
467 usb_driver_release_interface(&usbfs_driver, intf);
468 err = 0;
469 }
1da177e4
LT
470 return err;
471}
472
473static int checkintf(struct dev_state *ps, unsigned int ifnum)
474{
475 if (ps->dev->state != USB_STATE_CONFIGURED)
476 return -EHOSTUNREACH;
477 if (ifnum >= 8*sizeof(ps->ifclaimed))
478 return -EINVAL;
479 if (test_bit(ifnum, &ps->ifclaimed))
480 return 0;
481 /* if not yet claimed, claim it for the driver */
04e482ff
GKH
482 dev_warn(&ps->dev->dev, "usbfs: process %d (%s) did not claim "
483 "interface %u before use\n", task_pid_nr(current),
484 current->comm, ifnum);
1da177e4
LT
485 return claimintf(ps, ifnum);
486}
487
488static int findintfep(struct usb_device *dev, unsigned int ep)
489{
490 unsigned int i, j, e;
04e482ff 491 struct usb_interface *intf;
1da177e4
LT
492 struct usb_host_interface *alts;
493 struct usb_endpoint_descriptor *endpt;
494
495 if (ep & ~(USB_DIR_IN|0xf))
496 return -EINVAL;
497 if (!dev->actconfig)
498 return -ESRCH;
499 for (i = 0; i < dev->actconfig->desc.bNumInterfaces; i++) {
500 intf = dev->actconfig->interface[i];
501 for (j = 0; j < intf->num_altsetting; j++) {
04e482ff 502 alts = &intf->altsetting[j];
1da177e4
LT
503 for (e = 0; e < alts->desc.bNumEndpoints; e++) {
504 endpt = &alts->endpoint[e].desc;
505 if (endpt->bEndpointAddress == ep)
506 return alts->desc.bInterfaceNumber;
507 }
508 }
509 }
04e482ff 510 return -ENOENT;
1da177e4
LT
511}
512
04e482ff
GKH
513static int check_ctrlrecip(struct dev_state *ps, unsigned int requesttype,
514 unsigned int index)
1da177e4
LT
515{
516 int ret = 0;
517
24f8b116
HS
518 if (ps->dev->state != USB_STATE_ADDRESS
519 && ps->dev->state != USB_STATE_CONFIGURED)
1da177e4
LT
520 return -EHOSTUNREACH;
521 if (USB_TYPE_VENDOR == (USB_TYPE_MASK & requesttype))
522 return 0;
523
524 index &= 0xff;
525 switch (requesttype & USB_RECIP_MASK) {
526 case USB_RECIP_ENDPOINT:
04e482ff
GKH
527 ret = findintfep(ps->dev, index);
528 if (ret >= 0)
1da177e4
LT
529 ret = checkintf(ps, ret);
530 break;
531
532 case USB_RECIP_INTERFACE:
533 ret = checkintf(ps, index);
534 break;
535 }
536 return ret;
537}
538
9f8b17e6 539static int __match_minor(struct device *dev, void *data)
4592bf5a 540{
9f8b17e6 541 int minor = *((int *)data);
4592bf5a 542
9f8b17e6
KS
543 if (dev->devt == MKDEV(USB_DEVICE_MAJOR, minor))
544 return 1;
545 return 0;
546}
4592bf5a 547
9f8b17e6
KS
548static struct usb_device *usbdev_lookup_by_minor(int minor)
549{
550 struct device *dev;
551
552 dev = bus_find_device(&usb_bus_type, NULL, &minor, __match_minor);
553 if (!dev)
554 return NULL;
555 put_device(dev);
556 return container_of(dev, struct usb_device, dev);
557}
4592bf5a 558
1da177e4
LT
559/*
560 * file operations
561 */
562static int usbdev_open(struct inode *inode, struct file *file)
563{
fbf82fd2 564 struct usb_device *dev = NULL;
1da177e4
LT
565 struct dev_state *ps;
566 int ret;
567
4a2a8a2c
AS
568 /* Protect against simultaneous removal or release */
569 mutex_lock(&usbfs_mutex);
570
1da177e4 571 ret = -ENOMEM;
04e482ff
GKH
572 ps = kmalloc(sizeof(struct dev_state), GFP_KERNEL);
573 if (!ps)
4a2a8a2c 574 goto out;
1da177e4 575
1da177e4 576 ret = -ENOENT;
9f8b17e6 577 /* usbdev device-node */
fbf82fd2 578 if (imajor(inode) == USB_DEVICE_MAJOR)
9f8b17e6
KS
579 dev = usbdev_lookup_by_minor(iminor(inode));
580#ifdef CONFIG_USB_DEVICEFS
581 /* procfs file */
fbf82fd2 582 if (!dev)
8e18e294 583 dev = inode->i_private;
9f8b17e6 584#endif
01d883d4 585 if (!dev)
1da177e4 586 goto out;
94fcda1f 587 ret = usb_autoresume_device(dev);
01d883d4
AS
588 if (ret)
589 goto out;
590
fbf82fd2 591 usb_get_dev(dev);
1da177e4
LT
592 ret = 0;
593 ps->dev = dev;
594 ps->file = file;
595 spin_lock_init(&ps->lock);
316547fd 596 INIT_LIST_HEAD(&ps->list);
1da177e4
LT
597 INIT_LIST_HEAD(&ps->async_pending);
598 INIT_LIST_HEAD(&ps->async_completed);
599 init_waitqueue_head(&ps->wait);
600 ps->discsignr = 0;
2425c08b 601 ps->disc_pid = get_pid(task_pid(current));
d7dd8a72
LT
602 ps->disc_uid = current->uid;
603 ps->disc_euid = current->euid;
1da177e4
LT
604 ps->disccontext = NULL;
605 ps->ifclaimed = 0;
7a01955f 606 security_task_getsecid(current, &ps->secid);
527660a8 607 smp_wmb();
1da177e4
LT
608 list_add_tail(&ps->list, &dev->filelist);
609 file->private_data = ps;
610 out:
01d883d4
AS
611 if (ret)
612 kfree(ps);
4a2a8a2c
AS
613 mutex_unlock(&usbfs_mutex);
614 return ret;
1da177e4
LT
615}
616
617static int usbdev_release(struct inode *inode, struct file *file)
618{
ec17cf1c 619 struct dev_state *ps = file->private_data;
1da177e4
LT
620 struct usb_device *dev = ps->dev;
621 unsigned int ifnum;
622
623 usb_lock_device(dev);
4a2a8a2c
AS
624
625 /* Protect against simultaneous open */
626 mutex_lock(&usbfs_mutex);
1da177e4 627 list_del_init(&ps->list);
4a2a8a2c
AS
628 mutex_unlock(&usbfs_mutex);
629
1da177e4
LT
630 for (ifnum = 0; ps->ifclaimed && ifnum < 8*sizeof(ps->ifclaimed);
631 ifnum++) {
632 if (test_bit(ifnum, &ps->ifclaimed))
633 releaseintf(ps, ifnum);
634 }
635 destroy_all_async(ps);
94fcda1f 636 usb_autosuspend_device(dev);
1da177e4
LT
637 usb_unlock_device(dev);
638 usb_put_dev(dev);
2425c08b 639 put_pid(ps->disc_pid);
1da177e4 640 kfree(ps);
4a2a8a2c 641 return 0;
1da177e4
LT
642}
643
644static int proc_control(struct dev_state *ps, void __user *arg)
645{
646 struct usb_device *dev = ps->dev;
647 struct usbdevfs_ctrltransfer ctrl;
648 unsigned int tmo;
649 unsigned char *tbuf;
ff66e3ce 650 unsigned wLength;
1da177e4
LT
651 int i, j, ret;
652
653 if (copy_from_user(&ctrl, arg, sizeof(ctrl)))
654 return -EFAULT;
04e482ff
GKH
655 ret = check_ctrlrecip(ps, ctrl.bRequestType, ctrl.wIndex);
656 if (ret)
1da177e4 657 return ret;
ff66e3ce
AM
658 wLength = ctrl.wLength; /* To suppress 64k PAGE_SIZE warning */
659 if (wLength > PAGE_SIZE)
1da177e4 660 return -EINVAL;
04e482ff
GKH
661 tbuf = (unsigned char *)__get_free_page(GFP_KERNEL);
662 if (!tbuf)
1da177e4
LT
663 return -ENOMEM;
664 tmo = ctrl.timeout;
665 if (ctrl.bRequestType & 0x80) {
04e482ff
GKH
666 if (ctrl.wLength && !access_ok(VERIFY_WRITE, ctrl.data,
667 ctrl.wLength)) {
1da177e4
LT
668 free_page((unsigned long)tbuf);
669 return -EINVAL;
670 }
fe0410c7
AS
671 snoop(&dev->dev, "control read: bRequest=%02x "
672 "bRrequestType=%02x wValue=%04x "
673 "wIndex=%04x wLength=%04x\n",
674 ctrl.bRequest, ctrl.bRequestType, ctrl.wValue,
675 ctrl.wIndex, ctrl.wLength);
1da177e4
LT
676
677 usb_unlock_device(dev);
04e482ff
GKH
678 i = usb_control_msg(dev, usb_rcvctrlpipe(dev, 0), ctrl.bRequest,
679 ctrl.bRequestType, ctrl.wValue, ctrl.wIndex,
680 tbuf, ctrl.wLength, tmo);
1da177e4
LT
681 usb_lock_device(dev);
682 if ((i > 0) && ctrl.wLength) {
683 if (usbfs_snoop) {
684 dev_info(&dev->dev, "control read: data ");
fe0410c7 685 for (j = 0; j < i; ++j)
04e482ff 686 printk("%02x ", (u8)(tbuf)[j]);
1da177e4
LT
687 printk("\n");
688 }
fe0410c7 689 if (copy_to_user(ctrl.data, tbuf, i)) {
1da177e4
LT
690 free_page((unsigned long)tbuf);
691 return -EFAULT;
692 }
693 }
694 } else {
695 if (ctrl.wLength) {
696 if (copy_from_user(tbuf, ctrl.data, ctrl.wLength)) {
697 free_page((unsigned long)tbuf);
698 return -EFAULT;
699 }
700 }
fe0410c7
AS
701 snoop(&dev->dev, "control write: bRequest=%02x "
702 "bRrequestType=%02x wValue=%04x "
703 "wIndex=%04x wLength=%04x\n",
704 ctrl.bRequest, ctrl.bRequestType, ctrl.wValue,
705 ctrl.wIndex, ctrl.wLength);
1da177e4
LT
706 if (usbfs_snoop) {
707 dev_info(&dev->dev, "control write: data: ");
708 for (j = 0; j < ctrl.wLength; ++j)
e639dd3f 709 printk("%02x ", (unsigned char)(tbuf)[j]);
1da177e4
LT
710 printk("\n");
711 }
712 usb_unlock_device(dev);
04e482ff
GKH
713 i = usb_control_msg(dev, usb_sndctrlpipe(dev, 0), ctrl.bRequest,
714 ctrl.bRequestType, ctrl.wValue, ctrl.wIndex,
715 tbuf, ctrl.wLength, tmo);
1da177e4
LT
716 usb_lock_device(dev);
717 }
718 free_page((unsigned long)tbuf);
04e482ff 719 if (i < 0 && i != -EPIPE) {
1da177e4
LT
720 dev_printk(KERN_DEBUG, &dev->dev, "usbfs: USBDEVFS_CONTROL "
721 "failed cmd %s rqt %u rq %u len %u ret %d\n",
722 current->comm, ctrl.bRequestType, ctrl.bRequest,
723 ctrl.wLength, i);
724 }
725 return i;
726}
727
728static int proc_bulk(struct dev_state *ps, void __user *arg)
729{
730 struct usb_device *dev = ps->dev;
731 struct usbdevfs_bulktransfer bulk;
732 unsigned int tmo, len1, pipe;
733 int len2;
734 unsigned char *tbuf;
e639dd3f 735 int i, j, ret;
1da177e4
LT
736
737 if (copy_from_user(&bulk, arg, sizeof(bulk)))
738 return -EFAULT;
04e482ff
GKH
739 ret = findintfep(ps->dev, bulk.ep);
740 if (ret < 0)
1da177e4 741 return ret;
04e482ff
GKH
742 ret = checkintf(ps, ret);
743 if (ret)
1da177e4
LT
744 return ret;
745 if (bulk.ep & USB_DIR_IN)
746 pipe = usb_rcvbulkpipe(dev, bulk.ep & 0x7f);
747 else
748 pipe = usb_sndbulkpipe(dev, bulk.ep & 0x7f);
749 if (!usb_maxpacket(dev, pipe, !(bulk.ep & USB_DIR_IN)))
750 return -EINVAL;
751 len1 = bulk.len;
752 if (len1 > MAX_USBFS_BUFFER_SIZE)
753 return -EINVAL;
754 if (!(tbuf = kmalloc(len1, GFP_KERNEL)))
755 return -ENOMEM;
756 tmo = bulk.timeout;
757 if (bulk.ep & 0x80) {
758 if (len1 && !access_ok(VERIFY_WRITE, bulk.data, len1)) {
759 kfree(tbuf);
760 return -EINVAL;
761 }
e639dd3f
GKH
762 snoop(&dev->dev, "bulk read: len=0x%02x timeout=%04d\n",
763 bulk.len, bulk.timeout);
1da177e4
LT
764 usb_unlock_device(dev);
765 i = usb_bulk_msg(dev, pipe, tbuf, len1, &len2, tmo);
766 usb_lock_device(dev);
767 if (!i && len2) {
e639dd3f
GKH
768 if (usbfs_snoop) {
769 dev_info(&dev->dev, "bulk read: data ");
770 for (j = 0; j < len2; ++j)
04e482ff 771 printk("%02x ", (u8)(tbuf)[j]);
e639dd3f
GKH
772 printk("\n");
773 }
1da177e4
LT
774 if (copy_to_user(bulk.data, tbuf, len2)) {
775 kfree(tbuf);
776 return -EFAULT;
777 }
778 }
779 } else {
780 if (len1) {
781 if (copy_from_user(tbuf, bulk.data, len1)) {
782 kfree(tbuf);
783 return -EFAULT;
784 }
785 }
e639dd3f
GKH
786 snoop(&dev->dev, "bulk write: len=0x%02x timeout=%04d\n",
787 bulk.len, bulk.timeout);
788 if (usbfs_snoop) {
789 dev_info(&dev->dev, "bulk write: data: ");
790 for (j = 0; j < len1; ++j)
791 printk("%02x ", (unsigned char)(tbuf)[j]);
792 printk("\n");
793 }
1da177e4
LT
794 usb_unlock_device(dev);
795 i = usb_bulk_msg(dev, pipe, tbuf, len1, &len2, tmo);
796 usb_lock_device(dev);
797 }
798 kfree(tbuf);
799 if (i < 0)
800 return i;
801 return len2;
802}
803
804static int proc_resetep(struct dev_state *ps, void __user *arg)
805{
806 unsigned int ep;
807 int ret;
808
809 if (get_user(ep, (unsigned int __user *)arg))
810 return -EFAULT;
04e482ff
GKH
811 ret = findintfep(ps->dev, ep);
812 if (ret < 0)
1da177e4 813 return ret;
04e482ff
GKH
814 ret = checkintf(ps, ret);
815 if (ret)
1da177e4
LT
816 return ret;
817 usb_settoggle(ps->dev, ep & 0xf, !(ep & USB_DIR_IN), 0);
818 return 0;
819}
820
821static int proc_clearhalt(struct dev_state *ps, void __user *arg)
822{
823 unsigned int ep;
824 int pipe;
825 int ret;
826
827 if (get_user(ep, (unsigned int __user *)arg))
828 return -EFAULT;
04e482ff
GKH
829 ret = findintfep(ps->dev, ep);
830 if (ret < 0)
1da177e4 831 return ret;
04e482ff
GKH
832 ret = checkintf(ps, ret);
833 if (ret)
1da177e4
LT
834 return ret;
835 if (ep & USB_DIR_IN)
04e482ff
GKH
836 pipe = usb_rcvbulkpipe(ps->dev, ep & 0x7f);
837 else
838 pipe = usb_sndbulkpipe(ps->dev, ep & 0x7f);
1da177e4
LT
839
840 return usb_clear_halt(ps->dev, pipe);
841}
1da177e4
LT
842
843static int proc_getdriver(struct dev_state *ps, void __user *arg)
844{
845 struct usbdevfs_getdriver gd;
846 struct usb_interface *intf;
847 int ret;
848
849 if (copy_from_user(&gd, arg, sizeof(gd)))
850 return -EFAULT;
1da177e4
LT
851 intf = usb_ifnum_to_if(ps->dev, gd.interface);
852 if (!intf || !intf->dev.driver)
853 ret = -ENODATA;
854 else {
855 strncpy(gd.driver, intf->dev.driver->name,
856 sizeof(gd.driver));
857 ret = (copy_to_user(arg, &gd, sizeof(gd)) ? -EFAULT : 0);
858 }
1da177e4
LT
859 return ret;
860}
861
862static int proc_connectinfo(struct dev_state *ps, void __user *arg)
863{
864 struct usbdevfs_connectinfo ci;
865
866 ci.devnum = ps->dev->devnum;
867 ci.slow = ps->dev->speed == USB_SPEED_LOW;
868 if (copy_to_user(arg, &ci, sizeof(ci)))
869 return -EFAULT;
870 return 0;
871}
872
873static int proc_resetdevice(struct dev_state *ps)
874{
79efa097 875 return usb_reset_composite_device(ps->dev, NULL);
1da177e4
LT
876}
877
878static int proc_setintf(struct dev_state *ps, void __user *arg)
879{
880 struct usbdevfs_setinterface setintf;
881 int ret;
882
883 if (copy_from_user(&setintf, arg, sizeof(setintf)))
884 return -EFAULT;
885 if ((ret = checkintf(ps, setintf.interface)))
886 return ret;
887 return usb_set_interface(ps->dev, setintf.interface,
888 setintf.altsetting);
889}
890
891static int proc_setconfig(struct dev_state *ps, void __user *arg)
892{
3f141e2a 893 int u;
1da177e4 894 int status = 0;
04e482ff 895 struct usb_host_config *actconfig;
1da177e4 896
3f141e2a 897 if (get_user(u, (int __user *)arg))
1da177e4
LT
898 return -EFAULT;
899
04e482ff
GKH
900 actconfig = ps->dev->actconfig;
901
902 /* Don't touch the device if any interfaces are claimed.
903 * It could interfere with other drivers' operations, and if
1da177e4
LT
904 * an interface is claimed by usbfs it could easily deadlock.
905 */
04e482ff
GKH
906 if (actconfig) {
907 int i;
908
909 for (i = 0; i < actconfig->desc.bNumInterfaces; ++i) {
910 if (usb_interface_claimed(actconfig->interface[i])) {
911 dev_warn(&ps->dev->dev,
72ebddb5 912 "usbfs: interface %d claimed by %s "
1da177e4
LT
913 "while '%s' sets config #%d\n",
914 actconfig->interface[i]
915 ->cur_altsetting
916 ->desc.bInterfaceNumber,
72ebddb5
DB
917 actconfig->interface[i]
918 ->dev.driver->name,
1da177e4 919 current->comm, u);
04e482ff 920 status = -EBUSY;
1da177e4 921 break;
1da177e4 922 }
04e482ff
GKH
923 }
924 }
1da177e4
LT
925
926 /* SET_CONFIGURATION is often abused as a "cheap" driver reset,
927 * so avoid usb_set_configuration()'s kick to sysfs
928 */
929 if (status == 0) {
930 if (actconfig && actconfig->desc.bConfigurationValue == u)
931 status = usb_reset_configuration(ps->dev);
932 else
933 status = usb_set_configuration(ps->dev, u);
934 }
935
936 return status;
937}
938
1da177e4 939static int proc_do_submiturb(struct dev_state *ps, struct usbdevfs_urb *uurb,
04e482ff
GKH
940 struct usbdevfs_iso_packet_desc __user *iso_frame_desc,
941 void __user *arg)
1da177e4
LT
942{
943 struct usbdevfs_iso_packet_desc *isopkt = NULL;
944 struct usb_host_endpoint *ep;
945 struct async *as;
946 struct usb_ctrlrequest *dr = NULL;
947 unsigned int u, totlen, isofrmlen;
97b9eb91 948 int ret, ifnum = -1;
93cf9b90 949 int is_in;
1da177e4 950
14722ef4
AS
951 if (uurb->flags & ~(USBDEVFS_URB_ISO_ASAP |
952 USBDEVFS_URB_SHORT_NOT_OK |
953 USBDEVFS_URB_NO_FSBR |
954 USBDEVFS_URB_ZERO_PACKET |
955 USBDEVFS_URB_NO_INTERRUPT))
1da177e4
LT
956 return -EINVAL;
957 if (!uurb->buffer)
958 return -EINVAL;
04e482ff
GKH
959 if (uurb->signr != 0 && (uurb->signr < SIGRTMIN ||
960 uurb->signr > SIGRTMAX))
1da177e4 961 return -EINVAL;
04e482ff
GKH
962 if (!(uurb->type == USBDEVFS_URB_TYPE_CONTROL &&
963 (uurb->endpoint & ~USB_ENDPOINT_DIR_MASK) == 0)) {
964 ifnum = findintfep(ps->dev, uurb->endpoint);
965 if (ifnum < 0)
1da177e4 966 return ifnum;
04e482ff
GKH
967 ret = checkintf(ps, ifnum);
968 if (ret)
1da177e4
LT
969 return ret;
970 }
93cf9b90
AS
971 if ((uurb->endpoint & USB_ENDPOINT_DIR_MASK) != 0) {
972 is_in = 1;
973 ep = ps->dev->ep_in[uurb->endpoint & USB_ENDPOINT_NUMBER_MASK];
974 } else {
975 is_in = 0;
976 ep = ps->dev->ep_out[uurb->endpoint & USB_ENDPOINT_NUMBER_MASK];
977 }
1da177e4
LT
978 if (!ep)
979 return -ENOENT;
980 switch(uurb->type) {
981 case USBDEVFS_URB_TYPE_CONTROL:
93cf9b90 982 if (!usb_endpoint_xfer_control(&ep->desc))
1da177e4 983 return -EINVAL;
04e482ff
GKH
984 /* min 8 byte setup packet,
985 * max 8 byte setup plus an arbitrary data stage */
986 if (uurb->buffer_length < 8 ||
987 uurb->buffer_length > (8 + MAX_USBFS_BUFFER_SIZE))
1da177e4 988 return -EINVAL;
04e482ff
GKH
989 dr = kmalloc(sizeof(struct usb_ctrlrequest), GFP_KERNEL);
990 if (!dr)
1da177e4
LT
991 return -ENOMEM;
992 if (copy_from_user(dr, uurb->buffer, 8)) {
993 kfree(dr);
994 return -EFAULT;
995 }
996 if (uurb->buffer_length < (le16_to_cpup(&dr->wLength) + 8)) {
997 kfree(dr);
998 return -EINVAL;
999 }
04e482ff
GKH
1000 ret = check_ctrlrecip(ps, dr->bRequestType,
1001 le16_to_cpup(&dr->wIndex));
1002 if (ret) {
1da177e4
LT
1003 kfree(dr);
1004 return ret;
1005 }
1da177e4
LT
1006 uurb->number_of_packets = 0;
1007 uurb->buffer_length = le16_to_cpup(&dr->wLength);
1008 uurb->buffer += 8;
93cf9b90
AS
1009 if ((dr->bRequestType & USB_DIR_IN) && uurb->buffer_length) {
1010 is_in = 1;
1011 uurb->endpoint |= USB_DIR_IN;
1012 } else {
1013 is_in = 0;
1014 uurb->endpoint &= ~USB_DIR_IN;
1015 }
1016 if (!access_ok(is_in ? VERIFY_WRITE : VERIFY_READ,
1017 uurb->buffer, uurb->buffer_length)) {
1da177e4
LT
1018 kfree(dr);
1019 return -EFAULT;
1020 }
df251b8b
CF
1021 snoop(&ps->dev->dev, "control urb: bRequest=%02x "
1022 "bRrequestType=%02x wValue=%04x "
1023 "wIndex=%04x wLength=%04x\n",
93cf9b90
AS
1024 dr->bRequest, dr->bRequestType,
1025 __le16_to_cpup(&dr->wValue),
1026 __le16_to_cpup(&dr->wIndex),
1027 __le16_to_cpup(&dr->wLength));
1da177e4
LT
1028 break;
1029
1030 case USBDEVFS_URB_TYPE_BULK:
93cf9b90 1031 switch (usb_endpoint_type(&ep->desc)) {
1da177e4
LT
1032 case USB_ENDPOINT_XFER_CONTROL:
1033 case USB_ENDPOINT_XFER_ISOC:
1034 return -EINVAL;
1035 /* allow single-shot interrupt transfers, at bogus rates */
1036 }
1037 uurb->number_of_packets = 0;
1038 if (uurb->buffer_length > MAX_USBFS_BUFFER_SIZE)
1039 return -EINVAL;
93cf9b90
AS
1040 if (!access_ok(is_in ? VERIFY_WRITE : VERIFY_READ,
1041 uurb->buffer, uurb->buffer_length))
1da177e4 1042 return -EFAULT;
e639dd3f 1043 snoop(&ps->dev->dev, "bulk urb\n");
1da177e4
LT
1044 break;
1045
1046 case USBDEVFS_URB_TYPE_ISO:
1047 /* arbitrary limit */
04e482ff
GKH
1048 if (uurb->number_of_packets < 1 ||
1049 uurb->number_of_packets > 128)
1da177e4 1050 return -EINVAL;
93cf9b90 1051 if (!usb_endpoint_xfer_isoc(&ep->desc))
1da177e4 1052 return -EINVAL;
04e482ff
GKH
1053 isofrmlen = sizeof(struct usbdevfs_iso_packet_desc) *
1054 uurb->number_of_packets;
1da177e4
LT
1055 if (!(isopkt = kmalloc(isofrmlen, GFP_KERNEL)))
1056 return -ENOMEM;
1057 if (copy_from_user(isopkt, iso_frame_desc, isofrmlen)) {
1058 kfree(isopkt);
1059 return -EFAULT;
1060 }
1061 for (totlen = u = 0; u < uurb->number_of_packets; u++) {
04e482ff
GKH
1062 /* arbitrary limit,
1063 * sufficient for USB 2.0 high-bandwidth iso */
3612242e 1064 if (isopkt[u].length > 8192) {
1da177e4
LT
1065 kfree(isopkt);
1066 return -EINVAL;
1067 }
1068 totlen += isopkt[u].length;
1069 }
1070 if (totlen > 32768) {
1071 kfree(isopkt);
1072 return -EINVAL;
1073 }
1074 uurb->buffer_length = totlen;
e639dd3f 1075 snoop(&ps->dev->dev, "iso urb\n");
1da177e4
LT
1076 break;
1077
1078 case USBDEVFS_URB_TYPE_INTERRUPT:
1079 uurb->number_of_packets = 0;
93cf9b90 1080 if (!usb_endpoint_xfer_int(&ep->desc))
1da177e4 1081 return -EINVAL;
1da177e4
LT
1082 if (uurb->buffer_length > MAX_USBFS_BUFFER_SIZE)
1083 return -EINVAL;
93cf9b90
AS
1084 if (!access_ok(is_in ? VERIFY_WRITE : VERIFY_READ,
1085 uurb->buffer, uurb->buffer_length))
1da177e4 1086 return -EFAULT;
e639dd3f 1087 snoop(&ps->dev->dev, "interrupt urb\n");
1da177e4
LT
1088 break;
1089
1090 default:
1091 return -EINVAL;
1092 }
04e482ff
GKH
1093 as = alloc_async(uurb->number_of_packets);
1094 if (!as) {
6fd19f4b
JJ
1095 kfree(isopkt);
1096 kfree(dr);
1da177e4
LT
1097 return -ENOMEM;
1098 }
04e482ff
GKH
1099 as->urb->transfer_buffer = kmalloc(uurb->buffer_length, GFP_KERNEL);
1100 if (!as->urb->transfer_buffer) {
6fd19f4b
JJ
1101 kfree(isopkt);
1102 kfree(dr);
1da177e4
LT
1103 free_async(as);
1104 return -ENOMEM;
1105 }
04e482ff
GKH
1106 as->urb->dev = ps->dev;
1107 as->urb->pipe = (uurb->type << 30) |
93cf9b90
AS
1108 __create_pipe(ps->dev, uurb->endpoint & 0xf) |
1109 (uurb->endpoint & USB_DIR_IN);
14722ef4
AS
1110
1111 /* This tedious sequence is necessary because the URB_* flags
1112 * are internal to the kernel and subject to change, whereas
1113 * the USBDEVFS_URB_* flags are a user API and must not be changed.
1114 */
1115 u = (is_in ? URB_DIR_IN : URB_DIR_OUT);
1116 if (uurb->flags & USBDEVFS_URB_ISO_ASAP)
1117 u |= URB_ISO_ASAP;
1118 if (uurb->flags & USBDEVFS_URB_SHORT_NOT_OK)
1119 u |= URB_SHORT_NOT_OK;
1120 if (uurb->flags & USBDEVFS_URB_NO_FSBR)
1121 u |= URB_NO_FSBR;
1122 if (uurb->flags & USBDEVFS_URB_ZERO_PACKET)
1123 u |= URB_ZERO_PACKET;
1124 if (uurb->flags & USBDEVFS_URB_NO_INTERRUPT)
1125 u |= URB_NO_INTERRUPT;
1126 as->urb->transfer_flags = u;
1127
1da177e4 1128 as->urb->transfer_buffer_length = uurb->buffer_length;
04e482ff 1129 as->urb->setup_packet = (unsigned char *)dr;
1da177e4
LT
1130 as->urb->start_frame = uurb->start_frame;
1131 as->urb->number_of_packets = uurb->number_of_packets;
97b9eb91
AS
1132 if (uurb->type == USBDEVFS_URB_TYPE_ISO ||
1133 ps->dev->speed == USB_SPEED_HIGH)
1134 as->urb->interval = 1 << min(15, ep->desc.bInterval - 1);
1135 else
1136 as->urb->interval = ep->desc.bInterval;
04e482ff
GKH
1137 as->urb->context = as;
1138 as->urb->complete = async_completed;
1da177e4
LT
1139 for (totlen = u = 0; u < uurb->number_of_packets; u++) {
1140 as->urb->iso_frame_desc[u].offset = totlen;
1141 as->urb->iso_frame_desc[u].length = isopkt[u].length;
1142 totlen += isopkt[u].length;
1143 }
6fd19f4b 1144 kfree(isopkt);
1da177e4 1145 as->ps = ps;
04e482ff 1146 as->userurb = arg;
1da177e4
LT
1147 if (uurb->endpoint & USB_DIR_IN)
1148 as->userbuffer = uurb->buffer;
1149 else
1150 as->userbuffer = NULL;
1151 as->signr = uurb->signr;
1152 as->ifnum = ifnum;
2425c08b 1153 as->pid = get_pid(task_pid(current));
46113830
HW
1154 as->uid = current->uid;
1155 as->euid = current->euid;
7a01955f 1156 security_task_getsecid(current, &as->secid);
93cf9b90
AS
1157 if (!is_in) {
1158 if (copy_from_user(as->urb->transfer_buffer, uurb->buffer,
1159 as->urb->transfer_buffer_length)) {
1da177e4
LT
1160 free_async(as);
1161 return -EFAULT;
1162 }
1163 }
e639dd3f 1164 snoop_urb(as->urb, as->userurb);
04e482ff
GKH
1165 async_newpending(as);
1166 if ((ret = usb_submit_urb(as->urb, GFP_KERNEL))) {
1167 dev_printk(KERN_DEBUG, &ps->dev->dev,
1168 "usbfs: usb_submit_urb returned %d\n", ret);
1169 async_removepending(as);
1170 free_async(as);
1171 return ret;
1172 }
1173 return 0;
1da177e4
LT
1174}
1175
1176static int proc_submiturb(struct dev_state *ps, void __user *arg)
1177{
1178 struct usbdevfs_urb uurb;
1179
1180 if (copy_from_user(&uurb, arg, sizeof(uurb)))
1181 return -EFAULT;
1182
04e482ff
GKH
1183 return proc_do_submiturb(ps, &uurb,
1184 (((struct usbdevfs_urb __user *)arg)->iso_frame_desc),
1185 arg);
1da177e4
LT
1186}
1187
1188static int proc_unlinkurb(struct dev_state *ps, void __user *arg)
1189{
1190 struct async *as;
1191
1192 as = async_getpending(ps, arg);
1193 if (!as)
1194 return -EINVAL;
1195 usb_kill_urb(as->urb);
1196 return 0;
1197}
1198
1199static int processcompl(struct async *as, void __user * __user *arg)
1200{
1201 struct urb *urb = as->urb;
1202 struct usbdevfs_urb __user *userurb = as->userurb;
1203 void __user *addr = as->userurb;
1204 unsigned int i;
1205
1206 if (as->userbuffer)
04e482ff
GKH
1207 if (copy_to_user(as->userbuffer, urb->transfer_buffer,
1208 urb->transfer_buffer_length))
1da177e4 1209 return -EFAULT;
e015268d 1210 if (put_user(as->status, &userurb->status))
1da177e4
LT
1211 return -EFAULT;
1212 if (put_user(urb->actual_length, &userurb->actual_length))
1213 return -EFAULT;
1214 if (put_user(urb->error_count, &userurb->error_count))
1215 return -EFAULT;
1216
93cf9b90 1217 if (usb_endpoint_xfer_isoc(&urb->ep->desc)) {
668a9541
CL
1218 for (i = 0; i < urb->number_of_packets; i++) {
1219 if (put_user(urb->iso_frame_desc[i].actual_length,
1220 &userurb->iso_frame_desc[i].actual_length))
1221 return -EFAULT;
1222 if (put_user(urb->iso_frame_desc[i].status,
1223 &userurb->iso_frame_desc[i].status))
1224 return -EFAULT;
1225 }
1da177e4
LT
1226 }
1227
1228 free_async(as);
1229
1230 if (put_user(addr, (void __user * __user *)arg))
1231 return -EFAULT;
1232 return 0;
1233}
1234
04e482ff 1235static struct async *reap_as(struct dev_state *ps)
1da177e4 1236{
04e482ff 1237 DECLARE_WAITQUEUE(wait, current);
1da177e4
LT
1238 struct async *as = NULL;
1239 struct usb_device *dev = ps->dev;
1240
1241 add_wait_queue(&ps->wait, &wait);
1242 for (;;) {
1243 __set_current_state(TASK_INTERRUPTIBLE);
04e482ff
GKH
1244 as = async_getcompleted(ps);
1245 if (as)
1da177e4
LT
1246 break;
1247 if (signal_pending(current))
1248 break;
1249 usb_unlock_device(dev);
1250 schedule();
1251 usb_lock_device(dev);
1252 }
1253 remove_wait_queue(&ps->wait, &wait);
1254 set_current_state(TASK_RUNNING);
1255 return as;
1256}
1257
1258static int proc_reapurb(struct dev_state *ps, void __user *arg)
1259{
1260 struct async *as = reap_as(ps);
1261 if (as)
1262 return processcompl(as, (void __user * __user *)arg);
1263 if (signal_pending(current))
1264 return -EINTR;
1265 return -EIO;
1266}
1267
1268static int proc_reapurbnonblock(struct dev_state *ps, void __user *arg)
1269{
1270 struct async *as;
1271
1272 if (!(as = async_getcompleted(ps)))
1273 return -EAGAIN;
1274 return processcompl(as, (void __user * __user *)arg);
1275}
1276
1277#ifdef CONFIG_COMPAT
1278
1279static int get_urb32(struct usbdevfs_urb *kurb,
1280 struct usbdevfs_urb32 __user *uurb)
1281{
1282 __u32 uptr;
1283 if (get_user(kurb->type, &uurb->type) ||
1284 __get_user(kurb->endpoint, &uurb->endpoint) ||
1285 __get_user(kurb->status, &uurb->status) ||
1286 __get_user(kurb->flags, &uurb->flags) ||
1287 __get_user(kurb->buffer_length, &uurb->buffer_length) ||
1288 __get_user(kurb->actual_length, &uurb->actual_length) ||
1289 __get_user(kurb->start_frame, &uurb->start_frame) ||
1290 __get_user(kurb->number_of_packets, &uurb->number_of_packets) ||
1291 __get_user(kurb->error_count, &uurb->error_count) ||
1292 __get_user(kurb->signr, &uurb->signr))
1293 return -EFAULT;
1294
1295 if (__get_user(uptr, &uurb->buffer))
1296 return -EFAULT;
1297 kurb->buffer = compat_ptr(uptr);
1298 if (__get_user(uptr, &uurb->buffer))
1299 return -EFAULT;
1300 kurb->usercontext = compat_ptr(uptr);
1301
1302 return 0;
1303}
1304
1305static int proc_submiturb_compat(struct dev_state *ps, void __user *arg)
1306{
1307 struct usbdevfs_urb uurb;
1308
04e482ff 1309 if (get_urb32(&uurb, (struct usbdevfs_urb32 __user *)arg))
1da177e4
LT
1310 return -EFAULT;
1311
04e482ff
GKH
1312 return proc_do_submiturb(ps, &uurb,
1313 ((struct usbdevfs_urb32 __user *)arg)->iso_frame_desc,
1314 arg);
1da177e4
LT
1315}
1316
1317static int processcompl_compat(struct async *as, void __user * __user *arg)
1318{
1319 struct urb *urb = as->urb;
1320 struct usbdevfs_urb32 __user *userurb = as->userurb;
1321 void __user *addr = as->userurb;
1322 unsigned int i;
1323
1324 if (as->userbuffer)
04e482ff
GKH
1325 if (copy_to_user(as->userbuffer, urb->transfer_buffer,
1326 urb->transfer_buffer_length))
1da177e4 1327 return -EFAULT;
e015268d 1328 if (put_user(as->status, &userurb->status))
1da177e4
LT
1329 return -EFAULT;
1330 if (put_user(urb->actual_length, &userurb->actual_length))
1331 return -EFAULT;
1332 if (put_user(urb->error_count, &userurb->error_count))
1333 return -EFAULT;
1334
93cf9b90 1335 if (usb_endpoint_xfer_isoc(&urb->ep->desc)) {
668a9541
CL
1336 for (i = 0; i < urb->number_of_packets; i++) {
1337 if (put_user(urb->iso_frame_desc[i].actual_length,
1338 &userurb->iso_frame_desc[i].actual_length))
1339 return -EFAULT;
1340 if (put_user(urb->iso_frame_desc[i].status,
1341 &userurb->iso_frame_desc[i].status))
1342 return -EFAULT;
1343 }
1da177e4
LT
1344 }
1345
1346 free_async(as);
c714de5d 1347 if (put_user(ptr_to_compat(addr), (u32 __user *)arg))
1da177e4
LT
1348 return -EFAULT;
1349 return 0;
1350}
1351
1352static int proc_reapurb_compat(struct dev_state *ps, void __user *arg)
1353{
1354 struct async *as = reap_as(ps);
1355 if (as)
1356 return processcompl_compat(as, (void __user * __user *)arg);
1357 if (signal_pending(current))
1358 return -EINTR;
1359 return -EIO;
1360}
1361
1362static int proc_reapurbnonblock_compat(struct dev_state *ps, void __user *arg)
1363{
1364 struct async *as;
1365
1da177e4
LT
1366 if (!(as = async_getcompleted(ps)))
1367 return -EAGAIN;
1da177e4
LT
1368 return processcompl_compat(as, (void __user * __user *)arg);
1369}
1370
1371#endif
1372
1373static int proc_disconnectsignal(struct dev_state *ps, void __user *arg)
1374{
1375 struct usbdevfs_disconnectsignal ds;
1376
1377 if (copy_from_user(&ds, arg, sizeof(ds)))
1378 return -EFAULT;
1379 if (ds.signr != 0 && (ds.signr < SIGRTMIN || ds.signr > SIGRTMAX))
1380 return -EINVAL;
1381 ps->discsignr = ds.signr;
1382 ps->disccontext = ds.context;
1383 return 0;
1384}
1385
1386static int proc_claiminterface(struct dev_state *ps, void __user *arg)
1387{
1388 unsigned int ifnum;
1389
1390 if (get_user(ifnum, (unsigned int __user *)arg))
1391 return -EFAULT;
1392 return claimintf(ps, ifnum);
1393}
1394
1395static int proc_releaseinterface(struct dev_state *ps, void __user *arg)
1396{
1397 unsigned int ifnum;
1398 int ret;
1399
1400 if (get_user(ifnum, (unsigned int __user *)arg))
1401 return -EFAULT;
1402 if ((ret = releaseintf(ps, ifnum)) < 0)
1403 return ret;
1404 destroy_async_on_interface (ps, ifnum);
1405 return 0;
1406}
1407
c36fc889 1408static int proc_ioctl(struct dev_state *ps, struct usbdevfs_ioctl *ctl)
1da177e4 1409{
1da177e4
LT
1410 int size;
1411 void *buf = NULL;
1412 int retval = 0;
1413 struct usb_interface *intf = NULL;
1414 struct usb_driver *driver = NULL;
1da177e4 1415
c36fc889 1416 /* alloc buffer */
04e482ff
GKH
1417 if ((size = _IOC_SIZE(ctl->ioctl_code)) > 0) {
1418 if ((buf = kmalloc(size, GFP_KERNEL)) == NULL)
1da177e4 1419 return -ENOMEM;
c36fc889 1420 if ((_IOC_DIR(ctl->ioctl_code) & _IOC_WRITE)) {
04e482ff 1421 if (copy_from_user(buf, ctl->data, size)) {
6fd19f4b 1422 kfree(buf);
1da177e4
LT
1423 return -EFAULT;
1424 }
1425 } else {
04e482ff 1426 memset(buf, 0, size);
1da177e4
LT
1427 }
1428 }
1429
349710c3 1430 if (!connected(ps)) {
6fd19f4b 1431 kfree(buf);
1da177e4
LT
1432 return -ENODEV;
1433 }
1434
1435 if (ps->dev->state != USB_STATE_CONFIGURED)
1436 retval = -EHOSTUNREACH;
04e482ff
GKH
1437 else if (!(intf = usb_ifnum_to_if(ps->dev, ctl->ifno)))
1438 retval = -EINVAL;
c36fc889 1439 else switch (ctl->ioctl_code) {
1da177e4
LT
1440
1441 /* disconnect kernel driver from interface */
1442 case USBDEVFS_DISCONNECT:
1da177e4
LT
1443 if (intf->dev.driver) {
1444 driver = to_usb_driver(intf->dev.driver);
04e482ff 1445 dev_dbg(&intf->dev, "disconnect by usbfs\n");
1da177e4
LT
1446 usb_driver_release_interface(driver, intf);
1447 } else
1448 retval = -ENODATA;
1da177e4
LT
1449 break;
1450
1451 /* let kernel drivers try to (re)bind to the interface */
1452 case USBDEVFS_CONNECT:
885e9747
AS
1453 if (!intf->dev.driver)
1454 retval = device_attach(&intf->dev);
1455 else
1456 retval = -EBUSY;
1da177e4
LT
1457 break;
1458
1459 /* talk directly to the interface's driver */
1460 default:
1da177e4
LT
1461 if (intf->dev.driver)
1462 driver = to_usb_driver(intf->dev.driver);
1463 if (driver == NULL || driver->ioctl == NULL) {
1464 retval = -ENOTTY;
1465 } else {
04e482ff 1466 retval = driver->ioctl(intf, ctl->ioctl_code, buf);
1da177e4
LT
1467 if (retval == -ENOIOCTLCMD)
1468 retval = -ENOTTY;
1469 }
1da177e4
LT
1470 }
1471
1472 /* cleanup and return */
1473 if (retval >= 0
04e482ff 1474 && (_IOC_DIR(ctl->ioctl_code) & _IOC_READ) != 0
1da177e4 1475 && size > 0
04e482ff 1476 && copy_to_user(ctl->data, buf, size) != 0)
1da177e4 1477 retval = -EFAULT;
6fd19f4b
JJ
1478
1479 kfree(buf);
1da177e4
LT
1480 return retval;
1481}
1482
c36fc889
PZ
1483static int proc_ioctl_default(struct dev_state *ps, void __user *arg)
1484{
1485 struct usbdevfs_ioctl ctrl;
1486
04e482ff 1487 if (copy_from_user(&ctrl, arg, sizeof(ctrl)))
c36fc889
PZ
1488 return -EFAULT;
1489 return proc_ioctl(ps, &ctrl);
1490}
1491
1492#ifdef CONFIG_COMPAT
777da590 1493static int proc_ioctl_compat(struct dev_state *ps, compat_uptr_t arg)
c36fc889
PZ
1494{
1495 struct usbdevfs_ioctl32 __user *uioc;
1496 struct usbdevfs_ioctl ctrl;
1497 u32 udata;
1498
058120d7 1499 uioc = compat_ptr((long)arg);
c36fc889
PZ
1500 if (get_user(ctrl.ifno, &uioc->ifno) ||
1501 get_user(ctrl.ioctl_code, &uioc->ioctl_code) ||
1502 __get_user(udata, &uioc->data))
1503 return -EFAULT;
1504 ctrl.data = compat_ptr(udata);
1505
1506 return proc_ioctl(ps, &ctrl);
1507}
1508#endif
1509
1da177e4
LT
1510/*
1511 * NOTE: All requests here that have interface numbers as parameters
1512 * are assuming that somehow the configuration has been prevented from
1513 * changing. But there's no mechanism to ensure that...
1514 */
04e482ff
GKH
1515static int usbdev_ioctl(struct inode *inode, struct file *file,
1516 unsigned int cmd, unsigned long arg)
1da177e4 1517{
ec17cf1c 1518 struct dev_state *ps = file->private_data;
1da177e4
LT
1519 struct usb_device *dev = ps->dev;
1520 void __user *p = (void __user *)arg;
1521 int ret = -ENOTTY;
1522
1523 if (!(file->f_mode & FMODE_WRITE))
1524 return -EPERM;
1525 usb_lock_device(dev);
349710c3 1526 if (!connected(ps)) {
1da177e4
LT
1527 usb_unlock_device(dev);
1528 return -ENODEV;
1529 }
1530
1531 switch (cmd) {
1532 case USBDEVFS_CONTROL:
441b62c1 1533 snoop(&dev->dev, "%s: CONTROL\n", __func__);
1da177e4
LT
1534 ret = proc_control(ps, p);
1535 if (ret >= 0)
1536 inode->i_mtime = CURRENT_TIME;
1537 break;
1538
1539 case USBDEVFS_BULK:
441b62c1 1540 snoop(&dev->dev, "%s: BULK\n", __func__);
1da177e4
LT
1541 ret = proc_bulk(ps, p);
1542 if (ret >= 0)
1543 inode->i_mtime = CURRENT_TIME;
1544 break;
1545
1546 case USBDEVFS_RESETEP:
441b62c1 1547 snoop(&dev->dev, "%s: RESETEP\n", __func__);
1da177e4
LT
1548 ret = proc_resetep(ps, p);
1549 if (ret >= 0)
1550 inode->i_mtime = CURRENT_TIME;
1551 break;
1552
1553 case USBDEVFS_RESET:
441b62c1 1554 snoop(&dev->dev, "%s: RESET\n", __func__);
1da177e4
LT
1555 ret = proc_resetdevice(ps);
1556 break;
1557
1558 case USBDEVFS_CLEAR_HALT:
441b62c1 1559 snoop(&dev->dev, "%s: CLEAR_HALT\n", __func__);
1da177e4
LT
1560 ret = proc_clearhalt(ps, p);
1561 if (ret >= 0)
1562 inode->i_mtime = CURRENT_TIME;
1563 break;
1564
1565 case USBDEVFS_GETDRIVER:
441b62c1 1566 snoop(&dev->dev, "%s: GETDRIVER\n", __func__);
1da177e4
LT
1567 ret = proc_getdriver(ps, p);
1568 break;
1569
1570 case USBDEVFS_CONNECTINFO:
441b62c1 1571 snoop(&dev->dev, "%s: CONNECTINFO\n", __func__);
1da177e4
LT
1572 ret = proc_connectinfo(ps, p);
1573 break;
1574
1575 case USBDEVFS_SETINTERFACE:
441b62c1 1576 snoop(&dev->dev, "%s: SETINTERFACE\n", __func__);
1da177e4
LT
1577 ret = proc_setintf(ps, p);
1578 break;
1579
1580 case USBDEVFS_SETCONFIGURATION:
441b62c1 1581 snoop(&dev->dev, "%s: SETCONFIGURATION\n", __func__);
1da177e4
LT
1582 ret = proc_setconfig(ps, p);
1583 break;
1584
1585 case USBDEVFS_SUBMITURB:
441b62c1 1586 snoop(&dev->dev, "%s: SUBMITURB\n", __func__);
1da177e4
LT
1587 ret = proc_submiturb(ps, p);
1588 if (ret >= 0)
1589 inode->i_mtime = CURRENT_TIME;
1590 break;
1591
1592#ifdef CONFIG_COMPAT
1593
1594 case USBDEVFS_SUBMITURB32:
441b62c1 1595 snoop(&dev->dev, "%s: SUBMITURB32\n", __func__);
1da177e4
LT
1596 ret = proc_submiturb_compat(ps, p);
1597 if (ret >= 0)
1598 inode->i_mtime = CURRENT_TIME;
1599 break;
1600
1601 case USBDEVFS_REAPURB32:
441b62c1 1602 snoop(&dev->dev, "%s: REAPURB32\n", __func__);
1da177e4
LT
1603 ret = proc_reapurb_compat(ps, p);
1604 break;
1605
1606 case USBDEVFS_REAPURBNDELAY32:
441b62c1 1607 snoop(&dev->dev, "%s: REAPURBDELAY32\n", __func__);
1da177e4
LT
1608 ret = proc_reapurbnonblock_compat(ps, p);
1609 break;
1610
c36fc889 1611 case USBDEVFS_IOCTL32:
441b62c1 1612 snoop(&dev->dev, "%s: IOCTL\n", __func__);
c714de5d 1613 ret = proc_ioctl_compat(ps, ptr_to_compat(p));
c36fc889 1614 break;
1da177e4
LT
1615#endif
1616
1617 case USBDEVFS_DISCARDURB:
441b62c1 1618 snoop(&dev->dev, "%s: DISCARDURB\n", __func__);
1da177e4
LT
1619 ret = proc_unlinkurb(ps, p);
1620 break;
1621
1622 case USBDEVFS_REAPURB:
441b62c1 1623 snoop(&dev->dev, "%s: REAPURB\n", __func__);
1da177e4
LT
1624 ret = proc_reapurb(ps, p);
1625 break;
1626
1627 case USBDEVFS_REAPURBNDELAY:
441b62c1 1628 snoop(&dev->dev, "%s: REAPURBDELAY\n", __func__);
1da177e4
LT
1629 ret = proc_reapurbnonblock(ps, p);
1630 break;
1631
1632 case USBDEVFS_DISCSIGNAL:
441b62c1 1633 snoop(&dev->dev, "%s: DISCSIGNAL\n", __func__);
1da177e4
LT
1634 ret = proc_disconnectsignal(ps, p);
1635 break;
1636
1637 case USBDEVFS_CLAIMINTERFACE:
441b62c1 1638 snoop(&dev->dev, "%s: CLAIMINTERFACE\n", __func__);
1da177e4
LT
1639 ret = proc_claiminterface(ps, p);
1640 break;
1641
1642 case USBDEVFS_RELEASEINTERFACE:
441b62c1 1643 snoop(&dev->dev, "%s: RELEASEINTERFACE\n", __func__);
1da177e4
LT
1644 ret = proc_releaseinterface(ps, p);
1645 break;
1646
1647 case USBDEVFS_IOCTL:
441b62c1 1648 snoop(&dev->dev, "%s: IOCTL\n", __func__);
c36fc889 1649 ret = proc_ioctl_default(ps, p);
1da177e4
LT
1650 break;
1651 }
1652 usb_unlock_device(dev);
1653 if (ret >= 0)
1654 inode->i_atime = CURRENT_TIME;
1655 return ret;
1656}
1657
1658/* No kernel lock - fine */
04e482ff
GKH
1659static unsigned int usbdev_poll(struct file *file,
1660 struct poll_table_struct *wait)
1da177e4 1661{
ec17cf1c
TK
1662 struct dev_state *ps = file->private_data;
1663 unsigned int mask = 0;
1da177e4
LT
1664
1665 poll_wait(file, &ps->wait, wait);
1666 if (file->f_mode & FMODE_WRITE && !list_empty(&ps->async_completed))
1667 mask |= POLLOUT | POLLWRNORM;
349710c3 1668 if (!connected(ps))
1da177e4
LT
1669 mask |= POLLERR | POLLHUP;
1670 return mask;
1671}
1672
9f8b17e6 1673const struct file_operations usbdev_file_operations = {
7e7654a9 1674 .owner = THIS_MODULE,
1da177e4
LT
1675 .llseek = usbdev_lseek,
1676 .read = usbdev_read,
1677 .poll = usbdev_poll,
1678 .ioctl = usbdev_ioctl,
1679 .open = usbdev_open,
1680 .release = usbdev_release,
1681};
fbf82fd2 1682
9f8b17e6
KS
1683#ifdef CONFIG_USB_DEVICE_CLASS
1684static struct class *usb_classdev_class;
1685
1686static int usb_classdev_add(struct usb_device *dev)
fbf82fd2
KS
1687{
1688 int minor = ((dev->bus->busnum-1) * 128) + (dev->devnum-1);
1689
9f8b17e6 1690 dev->usb_classdev = device_create(usb_classdev_class, &dev->dev,
7bc3d635 1691 MKDEV(USB_DEVICE_MAJOR, minor),
fbf82fd2 1692 "usbdev%d.%d", dev->bus->busnum, dev->devnum);
9f8b17e6
KS
1693 if (IS_ERR(dev->usb_classdev))
1694 return PTR_ERR(dev->usb_classdev);
fbf82fd2 1695
27d39e26 1696 return 0;
fbf82fd2
KS
1697}
1698
9f8b17e6 1699static void usb_classdev_remove(struct usb_device *dev)
fbf82fd2 1700{
9f8b17e6 1701 device_unregister(dev->usb_classdev);
fbf82fd2
KS
1702}
1703
9f8b17e6
KS
1704static int usb_classdev_notify(struct notifier_block *self,
1705 unsigned long action, void *dev)
a7b986b3
GKH
1706{
1707 switch (action) {
1708 case USB_DEVICE_ADD:
9f8b17e6 1709 if (usb_classdev_add(dev))
27d39e26 1710 return NOTIFY_BAD;
a7b986b3
GKH
1711 break;
1712 case USB_DEVICE_REMOVE:
9f8b17e6 1713 usb_classdev_remove(dev);
a7b986b3
GKH
1714 break;
1715 }
1716 return NOTIFY_OK;
1717}
1718
1719static struct notifier_block usbdev_nb = {
9f8b17e6 1720 .notifier_call = usb_classdev_notify,
a7b986b3 1721};
9f8b17e6 1722#endif
a7b986b3 1723
7e7654a9 1724static struct cdev usb_device_cdev;
fbf82fd2 1725
9f8b17e6 1726int __init usb_devio_init(void)
fbf82fd2
KS
1727{
1728 int retval;
1729
fad21bdf 1730 retval = register_chrdev_region(USB_DEVICE_DEV, USB_DEVICE_MAX,
04e482ff 1731 "usb_device");
fbf82fd2
KS
1732 if (retval) {
1733 err("unable to register minors for usb_device");
1734 goto out;
1735 }
9f8b17e6 1736 cdev_init(&usb_device_cdev, &usbdev_file_operations);
fad21bdf 1737 retval = cdev_add(&usb_device_cdev, USB_DEVICE_DEV, USB_DEVICE_MAX);
fbf82fd2
KS
1738 if (retval) {
1739 err("unable to get usb_device major %d", USB_DEVICE_MAJOR);
a7b986b3 1740 goto error_cdev;
fbf82fd2 1741 }
9f8b17e6
KS
1742#ifdef CONFIG_USB_DEVICE_CLASS
1743 usb_classdev_class = class_create(THIS_MODULE, "usb_device");
1744 if (IS_ERR(usb_classdev_class)) {
fbf82fd2 1745 err("unable to register usb_device class");
9f8b17e6
KS
1746 retval = PTR_ERR(usb_classdev_class);
1747 cdev_del(&usb_device_cdev);
1748 usb_classdev_class = NULL;
1749 goto out;
fbf82fd2
KS
1750 }
1751
a7b986b3 1752 usb_register_notify(&usbdev_nb);
9f8b17e6 1753#endif
fbf82fd2
KS
1754out:
1755 return retval;
a7b986b3 1756
a7b986b3
GKH
1757error_cdev:
1758 unregister_chrdev_region(USB_DEVICE_DEV, USB_DEVICE_MAX);
1759 goto out;
fbf82fd2
KS
1760}
1761
9f8b17e6 1762void usb_devio_cleanup(void)
fbf82fd2 1763{
9f8b17e6 1764#ifdef CONFIG_USB_DEVICE_CLASS
a7b986b3 1765 usb_unregister_notify(&usbdev_nb);
9f8b17e6
KS
1766 class_destroy(usb_classdev_class);
1767#endif
fbf82fd2 1768 cdev_del(&usb_device_cdev);
fad21bdf 1769 unregister_chrdev_region(USB_DEVICE_DEV, USB_DEVICE_MAX);
fbf82fd2 1770}