2121 lines · 51.8 KB · C
RawDownload
/*****************************************************************************/ /* *      devio.c  --  User space communication with USB devices. * *      Copyright (C) 1999-2000  Thomas Sailer (sailer@ife.ee.ethz.ch) * *      This program is free software; you can redistribute it and/or modify *      it under the terms of the GNU General Public License as published by *      the Free Software Foundation; either version 2 of the License, or *      (at your option) any later version. * *      This program is distributed in the hope that it will be useful, *      but WITHOUT ANY WARRANTY; without even the implied warranty of *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the *      GNU General Public License for more details. * *      You should have received a copy of the GNU General Public License *      along with this program; if not, write to the Free Software *      Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. * *  This file implements the usbfs/x/y files, where *  x is the bus number and y the device number. * *  It allows user space programs/"drivers" to communicate directly *  with USB devices without intervening kernel driver. * *  Revision history *    22.12.1999   0.1   Initial release (split from proc_usb.c) *    04.01.2000   0.2   Turned into its own filesystem *    30.09.2005   0.3   Fix user-triggerable oops in async URB delivery *    			 (CAN-2005-3055) */ /*****************************************************************************/ #include <linux/fs.h>#include <linux/mm.h>#include <linux/slab.h>#include <linux/signal.h>#include <linux/poll.h>#include <linux/module.h>#include <linux/usb.h>#include <linux/usbdevice_fs.h>#include <linux/usb/hcd.h>	/* for usbcore internals */#include <linux/cdev.h>#include <linux/notifier.h>#include <linux/security.h>#include <linux/user_namespace.h>#include <asm/uaccess.h>#include <asm/byteorder.h>#include <linux/moduleparam.h> #include "usb.h" #define USB_MAXBUS			64#define USB_DEVICE_MAX			USB_MAXBUS * 128 /* Mutual exclusion for removal, open, and release */DEFINE_MUTEX(usbfs_mutex); struct dev_state {	struct list_head list;      /* state list */	struct usb_device *dev;	struct file *file;	spinlock_t lock;            /* protects the async urb lists */	struct list_head async_pending;	struct list_head async_completed;	wait_queue_head_t wait;     /* wake up if a request completed */	unsigned int discsignr;	struct pid *disc_pid;	const struct cred *cred;	void __user *disccontext;	unsigned long ifclaimed;	u32 secid;	u32 disabled_bulk_eps;}; struct async {	struct list_head asynclist;	struct dev_state *ps;	struct pid *pid;	const struct cred *cred;	unsigned int signr;	unsigned int ifnum;	void __user *userbuffer;	void __user *userurb;	struct urb *urb;	unsigned int mem_usage;	int status;	u32 secid;	u8 bulk_addr;	u8 bulk_status;}; static bool usbfs_snoop;module_param(usbfs_snoop, bool, S_IRUGO | S_IWUSR);MODULE_PARM_DESC(usbfs_snoop, "true to log all usbfs traffic"); #define snoop(dev, format, arg...)				\	do {							\		if (usbfs_snoop)				\			dev_info(dev , format , ## arg);	\	} while (0) enum snoop_when {	SUBMIT, COMPLETE}; #define USB_DEVICE_DEV		MKDEV(USB_DEVICE_MAJOR, 0) /* Limit on the total amount of memory we can allocate for transfers */static unsigned usbfs_memory_mb = 16;module_param(usbfs_memory_mb, uint, 0644);MODULE_PARM_DESC(usbfs_memory_mb,		"maximum MB allowed for usbfs buffers (0 = no limit)"); /* Hard limit, necessary to avoid aithmetic overflow */#define USBFS_XFER_MAX		(UINT_MAX / 2 - 1000000) static atomic_t usbfs_memory_usage;	/* Total memory currently allocated */ /* Check whether it's okay to allocate more memory for a transfer */static int usbfs_increase_memory_usage(unsigned amount){	unsigned lim; 	/*	 * Convert usbfs_memory_mb to bytes, avoiding overflows.	 * 0 means use the hard limit (effectively unlimited).	 */	lim = ACCESS_ONCE(usbfs_memory_mb);	if (lim == 0 || lim > (USBFS_XFER_MAX >> 20))		lim = USBFS_XFER_MAX;	else		lim <<= 20; 	atomic_add(amount, &usbfs_memory_usage);	if (atomic_read(&usbfs_memory_usage) <= lim)		return 0;	atomic_sub(amount, &usbfs_memory_usage);	return -ENOMEM;} /* Memory for a transfer is being deallocated */static void usbfs_decrease_memory_usage(unsigned amount){	atomic_sub(amount, &usbfs_memory_usage);} static int connected(struct dev_state *ps){	return (!list_empty(&ps->list) &&			ps->dev->state != USB_STATE_NOTATTACHED);} static loff_t usbdev_lseek(struct file *file, loff_t offset, int orig){	loff_t ret; 	mutex_lock(&file->f_dentry->d_inode->i_mutex); 	switch (orig) {	case 0:		file->f_pos = offset;		ret = file->f_pos;		break;	case 1:		file->f_pos += offset;		ret = file->f_pos;		break;	case 2:	default:		ret = -EINVAL;	} 	mutex_unlock(&file->f_dentry->d_inode->i_mutex);	return ret;} static ssize_t usbdev_read(struct file *file, char __user *buf, size_t nbytes,			   loff_t *ppos){	struct dev_state *ps = file->private_data;	struct usb_device *dev = ps->dev;	ssize_t ret = 0;	unsigned len;	loff_t pos;	int i; 	pos = *ppos;	usb_lock_device(dev);	if (!connected(ps)) {		ret = -ENODEV;		goto err;	} else if (pos < 0) {		ret = -EINVAL;		goto err;	} 	if (pos < sizeof(struct usb_device_descriptor)) {		/* 18 bytes - fits on the stack */		struct usb_device_descriptor temp_desc; 		memcpy(&temp_desc, &dev->descriptor, sizeof(dev->descriptor));		le16_to_cpus(&temp_desc.bcdUSB);		le16_to_cpus(&temp_desc.idVendor);		le16_to_cpus(&temp_desc.idProduct);		le16_to_cpus(&temp_desc.bcdDevice); 		len = sizeof(struct usb_device_descriptor) - pos;		if (len > nbytes)			len = nbytes;		if (copy_to_user(buf, ((char *)&temp_desc) + pos, len)) {			ret = -EFAULT;			goto err;		} 		*ppos += len;		buf += len;		nbytes -= len;		ret += len;	} 	pos = sizeof(struct usb_device_descriptor);	for (i = 0; nbytes && i < dev->descriptor.bNumConfigurations; i++) {		struct usb_config_descriptor *config =			(struct usb_config_descriptor *)dev->rawdescriptors[i];		unsigned int length = le16_to_cpu(config->wTotalLength); 		if (*ppos < pos + length) { 			/* The descriptor may claim to be longer than it			 * really is.  Here is the actual allocated length. */			unsigned alloclen =				le16_to_cpu(dev->config[i].desc.wTotalLength); 			len = length - (*ppos - pos);			if (len > nbytes)				len = nbytes; 			/* Simply don't write (skip over) unallocated parts */			if (alloclen > (*ppos - pos)) {				alloclen -= (*ppos - pos);				if (copy_to_user(buf,				    dev->rawdescriptors[i] + (*ppos - pos),				    min(len, alloclen))) {					ret = -EFAULT;					goto err;				}			} 			*ppos += len;			buf += len;			nbytes -= len;			ret += len;		} 		pos += length;	} err:	usb_unlock_device(dev);	return ret;} /* * async list handling */ static struct async *alloc_async(unsigned int numisoframes){	struct async *as; 	as = kzalloc(sizeof(struct async), GFP_KERNEL);	if (!as)		return NULL;	as->urb = usb_alloc_urb(numisoframes, GFP_KERNEL);	if (!as->urb) {		kfree(as);		return NULL;	}	return as;} static void free_async(struct async *as){	put_pid(as->pid);	if (as->cred)		put_cred(as->cred);	kfree(as->urb->transfer_buffer);	kfree(as->urb->setup_packet);	usb_free_urb(as->urb);	usbfs_decrease_memory_usage(as->mem_usage);	kfree(as);} static void async_newpending(struct async *as){	struct dev_state *ps = as->ps;	unsigned long flags; 	spin_lock_irqsave(&ps->lock, flags);	list_add_tail(&as->asynclist, &ps->async_pending);	spin_unlock_irqrestore(&ps->lock, flags);} static void async_removepending(struct async *as){	struct dev_state *ps = as->ps;	unsigned long flags; 	spin_lock_irqsave(&ps->lock, flags);	list_del_init(&as->asynclist);	spin_unlock_irqrestore(&ps->lock, flags);} static struct async *async_getcompleted(struct dev_state *ps){	unsigned long flags;	struct async *as = NULL; 	spin_lock_irqsave(&ps->lock, flags);	if (!list_empty(&ps->async_completed)) {		as = list_entry(ps->async_completed.next, struct async,				asynclist);		list_del_init(&as->asynclist);	}	spin_unlock_irqrestore(&ps->lock, flags);	return as;} static struct async *async_getpending(struct dev_state *ps,					     void __user *userurb){	struct async *as; 	list_for_each_entry(as, &ps->async_pending, asynclist)		if (as->userurb == userurb) {			list_del_init(&as->asynclist);			return as;		} 	return NULL;} static void snoop_urb(struct usb_device *udev,		void __user *userurb, int pipe, unsigned length,		int timeout_or_status, enum snoop_when when,		unsigned char *data, unsigned data_len){	static const char *types[] = {"isoc", "int", "ctrl", "bulk"};	static const char *dirs[] = {"out", "in"};	int ep;	const char *t, *d; 	if (!usbfs_snoop)		return; 	ep = usb_pipeendpoint(pipe);	t = types[usb_pipetype(pipe)];	d = dirs[!!usb_pipein(pipe)]; 	if (userurb) {		/* Async */		if (when == SUBMIT)			dev_info(&udev->dev, "userurb %p, ep%d %s-%s, "					"length %u\n",					userurb, ep, t, d, length);		else			dev_info(&udev->dev, "userurb %p, ep%d %s-%s, "					"actual_length %u status %d\n",					userurb, ep, t, d, length,					timeout_or_status);	} else {		if (when == SUBMIT)			dev_info(&udev->dev, "ep%d %s-%s, length %u, "					"timeout %d\n",					ep, t, d, length, timeout_or_status);		else			dev_info(&udev->dev, "ep%d %s-%s, actual_length %u, "					"status %d\n",					ep, t, d, length, timeout_or_status);	} 	if (data && data_len > 0) {		print_hex_dump(KERN_DEBUG, "data: ", DUMP_PREFIX_NONE, 32, 1,			data, data_len, 1);	}} #define AS_CONTINUATION	1#define AS_UNLINK	2 static void cancel_bulk_urbs(struct dev_state *ps, unsigned bulk_addr)__releases(ps->lock)__acquires(ps->lock){	struct urb *urb;	struct async *as; 	/* Mark all the pending URBs that match bulk_addr, up to but not	 * including the first one without AS_CONTINUATION.  If such an	 * URB is encountered then a new transfer has already started so	 * the endpoint doesn't need to be disabled; otherwise it does.	 */	list_for_each_entry(as, &ps->async_pending, asynclist) {		if (as->bulk_addr == bulk_addr) {			if (as->bulk_status != AS_CONTINUATION)				goto rescan;			as->bulk_status = AS_UNLINK;			as->bulk_addr = 0;		}	}	ps->disabled_bulk_eps |= (1 << bulk_addr); 	/* Now carefully unlink all the marked pending URBs */ rescan:	list_for_each_entry(as, &ps->async_pending, asynclist) {		if (as->bulk_status == AS_UNLINK) {			as->bulk_status = 0;		/* Only once */			urb = as->urb;			usb_get_urb(urb);			spin_unlock(&ps->lock);		/* Allow completions */			usb_unlink_urb(urb);			usb_put_urb(urb);			spin_lock(&ps->lock);			goto rescan;		}	}} static void async_completed(struct urb *urb){	struct async *as = urb->context;	struct dev_state *ps = as->ps;	struct siginfo sinfo;	struct pid *pid = NULL;	u32 secid = 0;	const struct cred *cred = NULL;	int signr; 	spin_lock(&ps->lock);	list_move_tail(&as->asynclist, &ps->async_completed);	as->status = urb->status;	signr = as->signr;	if (signr) {		sinfo.si_signo = as->signr;		sinfo.si_errno = as->status;		sinfo.si_code = SI_ASYNCIO;		sinfo.si_addr = as->userurb;		pid = get_pid(as->pid);		cred = get_cred(as->cred);		secid = as->secid;	}	snoop(&urb->dev->dev, "urb complete\n");	snoop_urb(urb->dev, as->userurb, urb->pipe, urb->actual_length,			as->status, COMPLETE,			((urb->transfer_flags & URB_DIR_MASK) == USB_DIR_OUT) ?				NULL : urb->transfer_buffer, urb->actual_length);	if (as->status < 0 && as->bulk_addr && as->status != -ECONNRESET &&			as->status != -ENOENT)		cancel_bulk_urbs(ps, as->bulk_addr);	spin_unlock(&ps->lock); 	if (signr) {		kill_pid_info_as_cred(sinfo.si_signo, &sinfo, pid, cred, secid);		put_pid(pid);		put_cred(cred);	} 	wake_up(&ps->wait);} static void destroy_async(struct dev_state *ps, struct list_head *list){	struct urb *urb;	struct async *as;	unsigned long flags; 	spin_lock_irqsave(&ps->lock, flags);	while (!list_empty(list)) {		as = list_entry(list->next, struct async, asynclist);		list_del_init(&as->asynclist);		urb = as->urb;		usb_get_urb(urb); 		/* drop the spinlock so the completion handler can run */		spin_unlock_irqrestore(&ps->lock, flags);		usb_kill_urb(urb);		usb_put_urb(urb);		spin_lock_irqsave(&ps->lock, flags);	}	spin_unlock_irqrestore(&ps->lock, flags);} static void destroy_async_on_interface(struct dev_state *ps,				       unsigned int ifnum){	struct list_head *p, *q, hitlist;	unsigned long flags;

Lines 1–500 of 2121.