Linux Audio

Check our new training course

Loading...
v3.5.6
 
  1/*
  2 * drivers/uio/uio.c
  3 *
  4 * Copyright(C) 2005, Benedikt Spranger <b.spranger@linutronix.de>
  5 * Copyright(C) 2005, Thomas Gleixner <tglx@linutronix.de>
  6 * Copyright(C) 2006, Hans J. Koch <hjk@hansjkoch.de>
  7 * Copyright(C) 2006, Greg Kroah-Hartman <greg@kroah.com>
  8 *
  9 * Userspace IO
 10 *
 11 * Base Functions
 12 *
 13 * Licensed under the GPLv2 only.
 14 */
 15
 16#include <linux/module.h>
 17#include <linux/init.h>
 18#include <linux/poll.h>
 19#include <linux/device.h>
 20#include <linux/slab.h>
 21#include <linux/mm.h>
 22#include <linux/idr.h>
 23#include <linux/sched.h>
 24#include <linux/string.h>
 25#include <linux/kobject.h>
 26#include <linux/cdev.h>
 27#include <linux/uio_driver.h>
 28
 29#define UIO_MAX_DEVICES		(1U << MINORBITS)
 30
 31struct uio_device {
 32	struct module		*owner;
 33	struct device		*dev;
 34	int			minor;
 35	atomic_t		event;
 36	struct fasync_struct	*async_queue;
 37	wait_queue_head_t	wait;
 38	int			vma_count;
 39	struct uio_info		*info;
 40	struct kobject		*map_dir;
 41	struct kobject		*portio_dir;
 42};
 43
 44static int uio_major;
 45static struct cdev *uio_cdev;
 46static DEFINE_IDR(uio_idr);
 47static const struct file_operations uio_fops;
 48
 49/* Protect idr accesses */
 50static DEFINE_MUTEX(minor_lock);
 51
 52/*
 53 * attributes
 54 */
 55
 56struct uio_map {
 57	struct kobject kobj;
 58	struct uio_mem *mem;
 59};
 60#define to_map(map) container_of(map, struct uio_map, kobj)
 61
 62static ssize_t map_name_show(struct uio_mem *mem, char *buf)
 63{
 64	if (unlikely(!mem->name))
 65		mem->name = "";
 66
 67	return sprintf(buf, "%s\n", mem->name);
 68}
 69
 70static ssize_t map_addr_show(struct uio_mem *mem, char *buf)
 71{
 72	return sprintf(buf, "0x%llx\n", (unsigned long long)mem->addr);
 73}
 74
 75static ssize_t map_size_show(struct uio_mem *mem, char *buf)
 76{
 77	return sprintf(buf, "0x%lx\n", mem->size);
 78}
 79
 80static ssize_t map_offset_show(struct uio_mem *mem, char *buf)
 81{
 82	return sprintf(buf, "0x%llx\n", (unsigned long long)mem->addr & ~PAGE_MASK);
 83}
 84
 85struct map_sysfs_entry {
 86	struct attribute attr;
 87	ssize_t (*show)(struct uio_mem *, char *);
 88	ssize_t (*store)(struct uio_mem *, const char *, size_t);
 89};
 90
 91static struct map_sysfs_entry name_attribute =
 92	__ATTR(name, S_IRUGO, map_name_show, NULL);
 93static struct map_sysfs_entry addr_attribute =
 94	__ATTR(addr, S_IRUGO, map_addr_show, NULL);
 95static struct map_sysfs_entry size_attribute =
 96	__ATTR(size, S_IRUGO, map_size_show, NULL);
 97static struct map_sysfs_entry offset_attribute =
 98	__ATTR(offset, S_IRUGO, map_offset_show, NULL);
 99
100static struct attribute *attrs[] = {
101	&name_attribute.attr,
102	&addr_attribute.attr,
103	&size_attribute.attr,
104	&offset_attribute.attr,
105	NULL,	/* need to NULL terminate the list of attributes */
106};
 
107
108static void map_release(struct kobject *kobj)
109{
110	struct uio_map *map = to_map(kobj);
111	kfree(map);
112}
113
114static ssize_t map_type_show(struct kobject *kobj, struct attribute *attr,
115			     char *buf)
116{
117	struct uio_map *map = to_map(kobj);
118	struct uio_mem *mem = map->mem;
119	struct map_sysfs_entry *entry;
120
121	entry = container_of(attr, struct map_sysfs_entry, attr);
122
123	if (!entry->show)
124		return -EIO;
125
126	return entry->show(mem, buf);
127}
128
129static const struct sysfs_ops map_sysfs_ops = {
130	.show = map_type_show,
131};
132
133static struct kobj_type map_attr_type = {
134	.release	= map_release,
135	.sysfs_ops	= &map_sysfs_ops,
136	.default_attrs	= attrs,
137};
138
139struct uio_portio {
140	struct kobject kobj;
141	struct uio_port *port;
142};
143#define to_portio(portio) container_of(portio, struct uio_portio, kobj)
144
145static ssize_t portio_name_show(struct uio_port *port, char *buf)
146{
147	if (unlikely(!port->name))
148		port->name = "";
149
150	return sprintf(buf, "%s\n", port->name);
151}
152
153static ssize_t portio_start_show(struct uio_port *port, char *buf)
154{
155	return sprintf(buf, "0x%lx\n", port->start);
156}
157
158static ssize_t portio_size_show(struct uio_port *port, char *buf)
159{
160	return sprintf(buf, "0x%lx\n", port->size);
161}
162
163static ssize_t portio_porttype_show(struct uio_port *port, char *buf)
164{
165	const char *porttypes[] = {"none", "x86", "gpio", "other"};
166
167	if ((port->porttype < 0) || (port->porttype > UIO_PORT_OTHER))
168		return -EINVAL;
169
170	return sprintf(buf, "port_%s\n", porttypes[port->porttype]);
171}
172
173struct portio_sysfs_entry {
174	struct attribute attr;
175	ssize_t (*show)(struct uio_port *, char *);
176	ssize_t (*store)(struct uio_port *, const char *, size_t);
177};
178
179static struct portio_sysfs_entry portio_name_attribute =
180	__ATTR(name, S_IRUGO, portio_name_show, NULL);
181static struct portio_sysfs_entry portio_start_attribute =
182	__ATTR(start, S_IRUGO, portio_start_show, NULL);
183static struct portio_sysfs_entry portio_size_attribute =
184	__ATTR(size, S_IRUGO, portio_size_show, NULL);
185static struct portio_sysfs_entry portio_porttype_attribute =
186	__ATTR(porttype, S_IRUGO, portio_porttype_show, NULL);
187
188static struct attribute *portio_attrs[] = {
189	&portio_name_attribute.attr,
190	&portio_start_attribute.attr,
191	&portio_size_attribute.attr,
192	&portio_porttype_attribute.attr,
193	NULL,
194};
 
195
196static void portio_release(struct kobject *kobj)
197{
198	struct uio_portio *portio = to_portio(kobj);
199	kfree(portio);
200}
201
202static ssize_t portio_type_show(struct kobject *kobj, struct attribute *attr,
203			     char *buf)
204{
205	struct uio_portio *portio = to_portio(kobj);
206	struct uio_port *port = portio->port;
207	struct portio_sysfs_entry *entry;
208
209	entry = container_of(attr, struct portio_sysfs_entry, attr);
210
211	if (!entry->show)
212		return -EIO;
213
214	return entry->show(port, buf);
215}
216
217static const struct sysfs_ops portio_sysfs_ops = {
218	.show = portio_type_show,
219};
220
221static struct kobj_type portio_attr_type = {
222	.release	= portio_release,
223	.sysfs_ops	= &portio_sysfs_ops,
224	.default_attrs	= portio_attrs,
225};
226
227static ssize_t show_name(struct device *dev,
228			 struct device_attribute *attr, char *buf)
229{
230	struct uio_device *idev = dev_get_drvdata(dev);
231	return sprintf(buf, "%s\n", idev->info->name);
 
 
 
 
 
 
 
 
 
 
 
 
 
232}
 
233
234static ssize_t show_version(struct device *dev,
235			    struct device_attribute *attr, char *buf)
236{
237	struct uio_device *idev = dev_get_drvdata(dev);
238	return sprintf(buf, "%s\n", idev->info->version);
 
 
 
 
 
 
 
 
 
 
 
 
 
239}
 
240
241static ssize_t show_event(struct device *dev,
242			  struct device_attribute *attr, char *buf)
243{
244	struct uio_device *idev = dev_get_drvdata(dev);
245	return sprintf(buf, "%u\n", (unsigned int)atomic_read(&idev->event));
246}
 
247
248static struct device_attribute uio_class_attributes[] = {
249	__ATTR(name, S_IRUGO, show_name, NULL),
250	__ATTR(version, S_IRUGO, show_version, NULL),
251	__ATTR(event, S_IRUGO, show_event, NULL),
252	{}
253};
 
254
255/* UIO class infrastructure */
256static struct class uio_class = {
257	.name = "uio",
258	.dev_attrs = uio_class_attributes,
259};
260
 
 
261/*
262 * device functions
263 */
264static int uio_dev_add_attributes(struct uio_device *idev)
265{
266	int ret;
267	int mi, pi;
268	int map_found = 0;
269	int portio_found = 0;
270	struct uio_mem *mem;
271	struct uio_map *map;
272	struct uio_port *port;
273	struct uio_portio *portio;
274
275	for (mi = 0; mi < MAX_UIO_MAPS; mi++) {
276		mem = &idev->info->mem[mi];
277		if (mem->size == 0)
278			break;
279		if (!map_found) {
280			map_found = 1;
281			idev->map_dir = kobject_create_and_add("maps",
282							&idev->dev->kobj);
283			if (!idev->map_dir)
 
284				goto err_map;
 
285		}
286		map = kzalloc(sizeof(*map), GFP_KERNEL);
287		if (!map)
 
288			goto err_map;
 
289		kobject_init(&map->kobj, &map_attr_type);
290		map->mem = mem;
291		mem->map = map;
292		ret = kobject_add(&map->kobj, idev->map_dir, "map%d", mi);
293		if (ret)
294			goto err_map;
295		ret = kobject_uevent(&map->kobj, KOBJ_ADD);
296		if (ret)
297			goto err_map;
298	}
299
300	for (pi = 0; pi < MAX_UIO_PORT_REGIONS; pi++) {
301		port = &idev->info->port[pi];
302		if (port->size == 0)
303			break;
304		if (!portio_found) {
305			portio_found = 1;
306			idev->portio_dir = kobject_create_and_add("portio",
307							&idev->dev->kobj);
308			if (!idev->portio_dir)
 
309				goto err_portio;
 
310		}
311		portio = kzalloc(sizeof(*portio), GFP_KERNEL);
312		if (!portio)
 
313			goto err_portio;
 
314		kobject_init(&portio->kobj, &portio_attr_type);
315		portio->port = port;
316		port->portio = portio;
317		ret = kobject_add(&portio->kobj, idev->portio_dir,
318							"port%d", pi);
319		if (ret)
320			goto err_portio;
321		ret = kobject_uevent(&portio->kobj, KOBJ_ADD);
322		if (ret)
323			goto err_portio;
324	}
325
326	return 0;
327
328err_portio:
329	for (pi--; pi >= 0; pi--) {
 
 
330		port = &idev->info->port[pi];
331		portio = port->portio;
332		kobject_put(&portio->kobj);
333	}
334	kobject_put(idev->portio_dir);
335err_map:
336	for (mi--; mi>=0; mi--) {
 
 
337		mem = &idev->info->mem[mi];
338		map = mem->map;
339		kobject_put(&map->kobj);
340	}
341	kobject_put(idev->map_dir);
342	dev_err(idev->dev, "error creating sysfs files (%d)\n", ret);
343	return ret;
344}
345
346static void uio_dev_del_attributes(struct uio_device *idev)
347{
348	int i;
349	struct uio_mem *mem;
350	struct uio_port *port;
351
352	for (i = 0; i < MAX_UIO_MAPS; i++) {
353		mem = &idev->info->mem[i];
354		if (mem->size == 0)
355			break;
356		kobject_put(&mem->map->kobj);
357	}
358	kobject_put(idev->map_dir);
359
360	for (i = 0; i < MAX_UIO_PORT_REGIONS; i++) {
361		port = &idev->info->port[i];
362		if (port->size == 0)
363			break;
364		kobject_put(&port->portio->kobj);
365	}
366	kobject_put(idev->portio_dir);
367}
368
369static int uio_get_minor(struct uio_device *idev)
370{
371	int retval = -ENOMEM;
372	int id;
373
374	mutex_lock(&minor_lock);
375	if (idr_pre_get(&uio_idr, GFP_KERNEL) == 0)
376		goto exit;
377
378	retval = idr_get_new(&uio_idr, idev, &id);
379	if (retval < 0) {
380		if (retval == -EAGAIN)
381			retval = -ENOMEM;
382		goto exit;
383	}
384	if (id < UIO_MAX_DEVICES) {
385		idev->minor = id;
386	} else {
387		dev_err(idev->dev, "too many uio devices\n");
388		retval = -EINVAL;
389		idr_remove(&uio_idr, id);
390	}
391exit:
392	mutex_unlock(&minor_lock);
393	return retval;
394}
395
396static void uio_free_minor(struct uio_device *idev)
397{
398	mutex_lock(&minor_lock);
399	idr_remove(&uio_idr, idev->minor);
400	mutex_unlock(&minor_lock);
401}
402
403/**
404 * uio_event_notify - trigger an interrupt event
405 * @info: UIO device capabilities
406 */
407void uio_event_notify(struct uio_info *info)
408{
409	struct uio_device *idev = info->uio_dev;
410
411	atomic_inc(&idev->event);
412	wake_up_interruptible(&idev->wait);
413	kill_fasync(&idev->async_queue, SIGIO, POLL_IN);
414}
415EXPORT_SYMBOL_GPL(uio_event_notify);
416
417/**
418 * uio_interrupt - hardware interrupt handler
419 * @irq: IRQ number, can be UIO_IRQ_CYCLIC for cyclic timer
420 * @dev_id: Pointer to the devices uio_device structure
421 */
422static irqreturn_t uio_interrupt(int irq, void *dev_id)
423{
424	struct uio_device *idev = (struct uio_device *)dev_id;
425	irqreturn_t ret = idev->info->handler(irq, idev->info);
426
 
427	if (ret == IRQ_HANDLED)
428		uio_event_notify(idev->info);
429
430	return ret;
431}
432
433struct uio_listener {
434	struct uio_device *dev;
435	s32 event_count;
436};
437
438static int uio_open(struct inode *inode, struct file *filep)
439{
440	struct uio_device *idev;
441	struct uio_listener *listener;
442	int ret = 0;
443
444	mutex_lock(&minor_lock);
445	idev = idr_find(&uio_idr, iminor(inode));
446	mutex_unlock(&minor_lock);
447	if (!idev) {
448		ret = -ENODEV;
 
449		goto out;
450	}
 
 
451
452	if (!try_module_get(idev->owner)) {
453		ret = -ENODEV;
454		goto out;
455	}
456
457	listener = kmalloc(sizeof(*listener), GFP_KERNEL);
458	if (!listener) {
459		ret = -ENOMEM;
460		goto err_alloc_listener;
461	}
462
463	listener->dev = idev;
464	listener->event_count = atomic_read(&idev->event);
465	filep->private_data = listener;
466
467	if (idev->info->open) {
468		ret = idev->info->open(idev->info, inode);
469		if (ret)
470			goto err_infoopen;
 
471	}
 
 
 
 
 
 
 
472	return 0;
473
474err_infoopen:
475	kfree(listener);
476
477err_alloc_listener:
478	module_put(idev->owner);
479
 
 
 
480out:
481	return ret;
482}
483
484static int uio_fasync(int fd, struct file *filep, int on)
485{
486	struct uio_listener *listener = filep->private_data;
487	struct uio_device *idev = listener->dev;
488
489	return fasync_helper(fd, filep, on, &idev->async_queue);
490}
491
492static int uio_release(struct inode *inode, struct file *filep)
493{
494	int ret = 0;
495	struct uio_listener *listener = filep->private_data;
496	struct uio_device *idev = listener->dev;
497
498	if (idev->info->release)
 
499		ret = idev->info->release(idev->info, inode);
 
500
501	module_put(idev->owner);
502	kfree(listener);
 
503	return ret;
504}
505
506static unsigned int uio_poll(struct file *filep, poll_table *wait)
507{
508	struct uio_listener *listener = filep->private_data;
509	struct uio_device *idev = listener->dev;
 
510
511	if (!idev->info->irq)
512		return -EIO;
 
 
 
 
 
513
514	poll_wait(filep, &idev->wait, wait);
515	if (listener->event_count != atomic_read(&idev->event))
516		return POLLIN | POLLRDNORM;
517	return 0;
518}
519
520static ssize_t uio_read(struct file *filep, char __user *buf,
521			size_t count, loff_t *ppos)
522{
523	struct uio_listener *listener = filep->private_data;
524	struct uio_device *idev = listener->dev;
525	DECLARE_WAITQUEUE(wait, current);
526	ssize_t retval;
527	s32 event_count;
528
529	if (!idev->info->irq)
530		return -EIO;
531
532	if (count != sizeof(s32))
533		return -EINVAL;
534
535	add_wait_queue(&idev->wait, &wait);
536
537	do {
 
 
 
 
 
 
 
 
538		set_current_state(TASK_INTERRUPTIBLE);
539
540		event_count = atomic_read(&idev->event);
541		if (event_count != listener->event_count) {
 
542			if (copy_to_user(buf, &event_count, count))
543				retval = -EFAULT;
544			else {
545				listener->event_count = event_count;
546				retval = count;
547			}
548			break;
549		}
550
551		if (filep->f_flags & O_NONBLOCK) {
552			retval = -EAGAIN;
553			break;
554		}
555
556		if (signal_pending(current)) {
557			retval = -ERESTARTSYS;
558			break;
559		}
560		schedule();
561	} while (1);
562
563	__set_current_state(TASK_RUNNING);
564	remove_wait_queue(&idev->wait, &wait);
565
566	return retval;
567}
568
569static ssize_t uio_write(struct file *filep, const char __user *buf,
570			size_t count, loff_t *ppos)
571{
572	struct uio_listener *listener = filep->private_data;
573	struct uio_device *idev = listener->dev;
574	ssize_t retval;
575	s32 irq_on;
576
577	if (!idev->info->irq)
578		return -EIO;
579
580	if (count != sizeof(s32))
581		return -EINVAL;
582
583	if (!idev->info->irqcontrol)
584		return -ENOSYS;
585
586	if (copy_from_user(&irq_on, buf, count))
587		return -EFAULT;
588
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
589	retval = idev->info->irqcontrol(idev->info, irq_on);
590
 
 
591	return retval ? retval : sizeof(s32);
592}
593
594static int uio_find_mem_index(struct vm_area_struct *vma)
595{
596	struct uio_device *idev = vma->vm_private_data;
597
598	if (vma->vm_pgoff < MAX_UIO_MAPS) {
599		if (idev->info->mem[vma->vm_pgoff].size == 0)
600			return -1;
601		return (int)vma->vm_pgoff;
602	}
603	return -1;
604}
605
606static void uio_vma_open(struct vm_area_struct *vma)
607{
608	struct uio_device *idev = vma->vm_private_data;
609	idev->vma_count++;
610}
611
612static void uio_vma_close(struct vm_area_struct *vma)
613{
614	struct uio_device *idev = vma->vm_private_data;
615	idev->vma_count--;
616}
617
618static int uio_vma_fault(struct vm_area_struct *vma, struct vm_fault *vmf)
619{
620	struct uio_device *idev = vma->vm_private_data;
621	struct page *page;
622	unsigned long offset;
 
 
 
623
624	int mi = uio_find_mem_index(vma);
625	if (mi < 0)
626		return VM_FAULT_SIGBUS;
 
 
 
 
 
 
 
 
627
628	/*
629	 * We need to subtract mi because userspace uses offset = N*PAGE_SIZE
630	 * to use mem[N].
631	 */
632	offset = (vmf->pgoff - mi) << PAGE_SHIFT;
633
 
634	if (idev->info->mem[mi].memtype == UIO_MEM_LOGICAL)
635		page = virt_to_page(idev->info->mem[mi].addr + offset);
636	else
637		page = vmalloc_to_page((void *)(unsigned long)idev->info->mem[mi].addr + offset);
638	get_page(page);
639	vmf->page = page;
640	return 0;
 
 
 
 
641}
642
643static const struct vm_operations_struct uio_vm_ops = {
644	.open = uio_vma_open,
645	.close = uio_vma_close,
646	.fault = uio_vma_fault,
647};
648
 
 
 
 
 
 
 
 
 
 
 
 
 
649static int uio_mmap_physical(struct vm_area_struct *vma)
650{
651	struct uio_device *idev = vma->vm_private_data;
652	int mi = uio_find_mem_index(vma);
 
 
653	if (mi < 0)
654		return -EINVAL;
 
655
656	vma->vm_flags |= VM_IO | VM_RESERVED;
 
 
 
657
658	vma->vm_page_prot = pgprot_noncached(vma->vm_page_prot);
 
 
659
 
 
 
 
 
 
 
 
 
660	return remap_pfn_range(vma,
661			       vma->vm_start,
662			       idev->info->mem[mi].addr >> PAGE_SHIFT,
663			       vma->vm_end - vma->vm_start,
664			       vma->vm_page_prot);
665}
666
667static int uio_mmap_logical(struct vm_area_struct *vma)
668{
669	vma->vm_flags |= VM_RESERVED;
670	vma->vm_ops = &uio_vm_ops;
671	uio_vma_open(vma);
672	return 0;
673}
674
675static int uio_mmap(struct file *filep, struct vm_area_struct *vma)
676{
677	struct uio_listener *listener = filep->private_data;
678	struct uio_device *idev = listener->dev;
679	int mi;
680	unsigned long requested_pages, actual_pages;
681	int ret = 0;
682
683	if (vma->vm_end < vma->vm_start)
684		return -EINVAL;
685
686	vma->vm_private_data = idev;
687
 
 
 
 
 
 
688	mi = uio_find_mem_index(vma);
689	if (mi < 0)
690		return -EINVAL;
 
 
691
692	requested_pages = (vma->vm_end - vma->vm_start) >> PAGE_SHIFT;
693	actual_pages = ((idev->info->mem[mi].addr & ~PAGE_MASK)
694			+ idev->info->mem[mi].size + PAGE_SIZE -1) >> PAGE_SHIFT;
695	if (requested_pages > actual_pages)
696		return -EINVAL;
 
 
697
698	if (idev->info->mmap) {
699		ret = idev->info->mmap(idev->info, vma);
700		return ret;
701	}
702
703	switch (idev->info->mem[mi].memtype) {
704		case UIO_MEM_PHYS:
705			return uio_mmap_physical(vma);
706		case UIO_MEM_LOGICAL:
707		case UIO_MEM_VIRTUAL:
708			return uio_mmap_logical(vma);
709		default:
710			return -EINVAL;
 
 
 
711	}
 
 
 
 
712}
713
714static const struct file_operations uio_fops = {
715	.owner		= THIS_MODULE,
716	.open		= uio_open,
717	.release	= uio_release,
718	.read		= uio_read,
719	.write		= uio_write,
720	.mmap		= uio_mmap,
721	.poll		= uio_poll,
722	.fasync		= uio_fasync,
723	.llseek		= noop_llseek,
724};
725
726static int uio_major_init(void)
727{
728	static const char name[] = "uio";
729	struct cdev *cdev = NULL;
730	dev_t uio_dev = 0;
731	int result;
732
733	result = alloc_chrdev_region(&uio_dev, 0, UIO_MAX_DEVICES, name);
734	if (result)
735		goto out;
736
737	result = -ENOMEM;
738	cdev = cdev_alloc();
739	if (!cdev)
740		goto out_unregister;
741
742	cdev->owner = THIS_MODULE;
743	cdev->ops = &uio_fops;
744	kobject_set_name(&cdev->kobj, "%s", name);
745
746	result = cdev_add(cdev, uio_dev, UIO_MAX_DEVICES);
747	if (result)
748		goto out_put;
749
750	uio_major = MAJOR(uio_dev);
751	uio_cdev = cdev;
752	return 0;
753out_put:
754	kobject_put(&cdev->kobj);
755out_unregister:
756	unregister_chrdev_region(uio_dev, UIO_MAX_DEVICES);
757out:
758	return result;
759}
760
761static void uio_major_cleanup(void)
762{
763	unregister_chrdev_region(MKDEV(uio_major, 0), UIO_MAX_DEVICES);
764	cdev_del(uio_cdev);
765}
766
767static int init_uio_class(void)
768{
769	int ret;
770
771	/* This is the first time in here, set everything up properly */
772	ret = uio_major_init();
773	if (ret)
774		goto exit;
775
776	ret = class_register(&uio_class);
777	if (ret) {
778		printk(KERN_ERR "class_register failed for uio\n");
779		goto err_class_register;
780	}
 
 
 
781	return 0;
782
783err_class_register:
784	uio_major_cleanup();
785exit:
786	return ret;
787}
788
789static void release_uio_class(void)
790{
 
791	class_unregister(&uio_class);
792	uio_major_cleanup();
793}
794
 
 
 
 
 
 
 
795/**
796 * uio_register_device - register a new userspace IO device
797 * @owner:	module that creates the new device
798 * @parent:	parent device
799 * @info:	UIO device capabilities
800 *
801 * returns zero on success or a negative error code.
802 */
803int __uio_register_device(struct module *owner,
804			  struct device *parent,
805			  struct uio_info *info)
806{
807	struct uio_device *idev;
808	int ret = 0;
809
 
 
 
810	if (!parent || !info || !info->name || !info->version)
811		return -EINVAL;
812
813	info->uio_dev = NULL;
814
815	idev = kzalloc(sizeof(*idev), GFP_KERNEL);
816	if (!idev) {
817		ret = -ENOMEM;
818		goto err_kzalloc;
819	}
820
821	idev->owner = owner;
822	idev->info = info;
 
823	init_waitqueue_head(&idev->wait);
824	atomic_set(&idev->event, 0);
825
826	ret = uio_get_minor(idev);
 
 
 
 
 
 
 
 
 
 
 
 
 
827	if (ret)
828		goto err_get_minor;
829
830	idev->dev = device_create(&uio_class, parent,
831				  MKDEV(uio_major, idev->minor), idev,
832				  "uio%d", idev->minor);
833	if (IS_ERR(idev->dev)) {
834		printk(KERN_ERR "UIO: device register failed\n");
835		ret = PTR_ERR(idev->dev);
836		goto err_device_create;
837	}
838
839	ret = uio_dev_add_attributes(idev);
840	if (ret)
841		goto err_uio_dev_add_attributes;
842
843	info->uio_dev = idev;
844
845	if (info->irq && (info->irq != UIO_IRQ_CUSTOM)) {
 
 
 
 
 
 
 
 
846		ret = request_irq(info->irq, uio_interrupt,
847				  info->irq_flags, info->name, idev);
848		if (ret)
 
849			goto err_request_irq;
 
850	}
851
852	return 0;
853
854err_request_irq:
855	uio_dev_del_attributes(idev);
856err_uio_dev_add_attributes:
857	device_destroy(&uio_class, MKDEV(uio_major, idev->minor));
858err_device_create:
859	uio_free_minor(idev);
860err_get_minor:
861	kfree(idev);
862err_kzalloc:
863	return ret;
864}
865EXPORT_SYMBOL_GPL(__uio_register_device);
866
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
867/**
868 * uio_unregister_device - unregister a industrial IO device
869 * @info:	UIO device capabilities
870 *
871 */
872void uio_unregister_device(struct uio_info *info)
873{
874	struct uio_device *idev;
 
875
876	if (!info || !info->uio_dev)
877		return;
878
879	idev = info->uio_dev;
 
880
881	uio_free_minor(idev);
 
882
883	if (info->irq && (info->irq != UIO_IRQ_CUSTOM))
884		free_irq(info->irq, idev);
885
886	uio_dev_del_attributes(idev);
 
887
888	device_destroy(&uio_class, MKDEV(uio_major, idev->minor));
889	kfree(idev);
 
 
 
890
891	return;
892}
893EXPORT_SYMBOL_GPL(uio_unregister_device);
894
895static int __init uio_init(void)
896{
897	return init_uio_class();
898}
899
900static void __exit uio_exit(void)
901{
902	release_uio_class();
 
903}
904
905module_init(uio_init)
906module_exit(uio_exit)
907MODULE_LICENSE("GPL v2");
v6.8
   1// SPDX-License-Identifier: GPL-2.0
   2/*
   3 * drivers/uio/uio.c
   4 *
   5 * Copyright(C) 2005, Benedikt Spranger <b.spranger@linutronix.de>
   6 * Copyright(C) 2005, Thomas Gleixner <tglx@linutronix.de>
   7 * Copyright(C) 2006, Hans J. Koch <hjk@hansjkoch.de>
   8 * Copyright(C) 2006, Greg Kroah-Hartman <greg@kroah.com>
   9 *
  10 * Userspace IO
  11 *
  12 * Base Functions
 
 
  13 */
  14
  15#include <linux/module.h>
  16#include <linux/init.h>
  17#include <linux/poll.h>
  18#include <linux/device.h>
  19#include <linux/slab.h>
  20#include <linux/mm.h>
  21#include <linux/idr.h>
  22#include <linux/sched/signal.h>
  23#include <linux/string.h>
  24#include <linux/kobject.h>
  25#include <linux/cdev.h>
  26#include <linux/uio_driver.h>
  27
  28#define UIO_MAX_DEVICES		(1U << MINORBITS)
  29
 
 
 
 
 
 
 
 
 
 
 
 
 
  30static int uio_major;
  31static struct cdev *uio_cdev;
  32static DEFINE_IDR(uio_idr);
  33static const struct file_operations uio_fops;
  34
  35/* Protect idr accesses */
  36static DEFINE_MUTEX(minor_lock);
  37
  38/*
  39 * attributes
  40 */
  41
  42struct uio_map {
  43	struct kobject kobj;
  44	struct uio_mem *mem;
  45};
  46#define to_map(map) container_of(map, struct uio_map, kobj)
  47
  48static ssize_t map_name_show(struct uio_mem *mem, char *buf)
  49{
  50	if (unlikely(!mem->name))
  51		mem->name = "";
  52
  53	return sprintf(buf, "%s\n", mem->name);
  54}
  55
  56static ssize_t map_addr_show(struct uio_mem *mem, char *buf)
  57{
  58	return sprintf(buf, "%pa\n", &mem->addr);
  59}
  60
  61static ssize_t map_size_show(struct uio_mem *mem, char *buf)
  62{
  63	return sprintf(buf, "%pa\n", &mem->size);
  64}
  65
  66static ssize_t map_offset_show(struct uio_mem *mem, char *buf)
  67{
  68	return sprintf(buf, "0x%llx\n", (unsigned long long)mem->offs);
  69}
  70
  71struct map_sysfs_entry {
  72	struct attribute attr;
  73	ssize_t (*show)(struct uio_mem *, char *);
  74	ssize_t (*store)(struct uio_mem *, const char *, size_t);
  75};
  76
  77static struct map_sysfs_entry name_attribute =
  78	__ATTR(name, S_IRUGO, map_name_show, NULL);
  79static struct map_sysfs_entry addr_attribute =
  80	__ATTR(addr, S_IRUGO, map_addr_show, NULL);
  81static struct map_sysfs_entry size_attribute =
  82	__ATTR(size, S_IRUGO, map_size_show, NULL);
  83static struct map_sysfs_entry offset_attribute =
  84	__ATTR(offset, S_IRUGO, map_offset_show, NULL);
  85
  86static struct attribute *map_attrs[] = {
  87	&name_attribute.attr,
  88	&addr_attribute.attr,
  89	&size_attribute.attr,
  90	&offset_attribute.attr,
  91	NULL,	/* need to NULL terminate the list of attributes */
  92};
  93ATTRIBUTE_GROUPS(map);
  94
  95static void map_release(struct kobject *kobj)
  96{
  97	struct uio_map *map = to_map(kobj);
  98	kfree(map);
  99}
 100
 101static ssize_t map_type_show(struct kobject *kobj, struct attribute *attr,
 102			     char *buf)
 103{
 104	struct uio_map *map = to_map(kobj);
 105	struct uio_mem *mem = map->mem;
 106	struct map_sysfs_entry *entry;
 107
 108	entry = container_of(attr, struct map_sysfs_entry, attr);
 109
 110	if (!entry->show)
 111		return -EIO;
 112
 113	return entry->show(mem, buf);
 114}
 115
 116static const struct sysfs_ops map_sysfs_ops = {
 117	.show = map_type_show,
 118};
 119
 120static struct kobj_type map_attr_type = {
 121	.release	= map_release,
 122	.sysfs_ops	= &map_sysfs_ops,
 123	.default_groups	= map_groups,
 124};
 125
 126struct uio_portio {
 127	struct kobject kobj;
 128	struct uio_port *port;
 129};
 130#define to_portio(portio) container_of(portio, struct uio_portio, kobj)
 131
 132static ssize_t portio_name_show(struct uio_port *port, char *buf)
 133{
 134	if (unlikely(!port->name))
 135		port->name = "";
 136
 137	return sprintf(buf, "%s\n", port->name);
 138}
 139
 140static ssize_t portio_start_show(struct uio_port *port, char *buf)
 141{
 142	return sprintf(buf, "0x%lx\n", port->start);
 143}
 144
 145static ssize_t portio_size_show(struct uio_port *port, char *buf)
 146{
 147	return sprintf(buf, "0x%lx\n", port->size);
 148}
 149
 150static ssize_t portio_porttype_show(struct uio_port *port, char *buf)
 151{
 152	const char *porttypes[] = {"none", "x86", "gpio", "other"};
 153
 154	if ((port->porttype < 0) || (port->porttype > UIO_PORT_OTHER))
 155		return -EINVAL;
 156
 157	return sprintf(buf, "port_%s\n", porttypes[port->porttype]);
 158}
 159
 160struct portio_sysfs_entry {
 161	struct attribute attr;
 162	ssize_t (*show)(struct uio_port *, char *);
 163	ssize_t (*store)(struct uio_port *, const char *, size_t);
 164};
 165
 166static struct portio_sysfs_entry portio_name_attribute =
 167	__ATTR(name, S_IRUGO, portio_name_show, NULL);
 168static struct portio_sysfs_entry portio_start_attribute =
 169	__ATTR(start, S_IRUGO, portio_start_show, NULL);
 170static struct portio_sysfs_entry portio_size_attribute =
 171	__ATTR(size, S_IRUGO, portio_size_show, NULL);
 172static struct portio_sysfs_entry portio_porttype_attribute =
 173	__ATTR(porttype, S_IRUGO, portio_porttype_show, NULL);
 174
 175static struct attribute *portio_attrs[] = {
 176	&portio_name_attribute.attr,
 177	&portio_start_attribute.attr,
 178	&portio_size_attribute.attr,
 179	&portio_porttype_attribute.attr,
 180	NULL,
 181};
 182ATTRIBUTE_GROUPS(portio);
 183
 184static void portio_release(struct kobject *kobj)
 185{
 186	struct uio_portio *portio = to_portio(kobj);
 187	kfree(portio);
 188}
 189
 190static ssize_t portio_type_show(struct kobject *kobj, struct attribute *attr,
 191			     char *buf)
 192{
 193	struct uio_portio *portio = to_portio(kobj);
 194	struct uio_port *port = portio->port;
 195	struct portio_sysfs_entry *entry;
 196
 197	entry = container_of(attr, struct portio_sysfs_entry, attr);
 198
 199	if (!entry->show)
 200		return -EIO;
 201
 202	return entry->show(port, buf);
 203}
 204
 205static const struct sysfs_ops portio_sysfs_ops = {
 206	.show = portio_type_show,
 207};
 208
 209static struct kobj_type portio_attr_type = {
 210	.release	= portio_release,
 211	.sysfs_ops	= &portio_sysfs_ops,
 212	.default_groups	= portio_groups,
 213};
 214
 215static ssize_t name_show(struct device *dev,
 216			 struct device_attribute *attr, char *buf)
 217{
 218	struct uio_device *idev = dev_get_drvdata(dev);
 219	int ret;
 220
 221	mutex_lock(&idev->info_lock);
 222	if (!idev->info) {
 223		ret = -EINVAL;
 224		dev_err(dev, "the device has been unregistered\n");
 225		goto out;
 226	}
 227
 228	ret = sprintf(buf, "%s\n", idev->info->name);
 229
 230out:
 231	mutex_unlock(&idev->info_lock);
 232	return ret;
 233}
 234static DEVICE_ATTR_RO(name);
 235
 236static ssize_t version_show(struct device *dev,
 237			    struct device_attribute *attr, char *buf)
 238{
 239	struct uio_device *idev = dev_get_drvdata(dev);
 240	int ret;
 241
 242	mutex_lock(&idev->info_lock);
 243	if (!idev->info) {
 244		ret = -EINVAL;
 245		dev_err(dev, "the device has been unregistered\n");
 246		goto out;
 247	}
 248
 249	ret = sprintf(buf, "%s\n", idev->info->version);
 250
 251out:
 252	mutex_unlock(&idev->info_lock);
 253	return ret;
 254}
 255static DEVICE_ATTR_RO(version);
 256
 257static ssize_t event_show(struct device *dev,
 258			  struct device_attribute *attr, char *buf)
 259{
 260	struct uio_device *idev = dev_get_drvdata(dev);
 261	return sprintf(buf, "%u\n", (unsigned int)atomic_read(&idev->event));
 262}
 263static DEVICE_ATTR_RO(event);
 264
 265static struct attribute *uio_attrs[] = {
 266	&dev_attr_name.attr,
 267	&dev_attr_version.attr,
 268	&dev_attr_event.attr,
 269	NULL,
 270};
 271ATTRIBUTE_GROUPS(uio);
 272
 273/* UIO class infrastructure */
 274static struct class uio_class = {
 275	.name = "uio",
 276	.dev_groups = uio_groups,
 277};
 278
 279static bool uio_class_registered;
 280
 281/*
 282 * device functions
 283 */
 284static int uio_dev_add_attributes(struct uio_device *idev)
 285{
 286	int ret;
 287	int mi, pi;
 288	int map_found = 0;
 289	int portio_found = 0;
 290	struct uio_mem *mem;
 291	struct uio_map *map;
 292	struct uio_port *port;
 293	struct uio_portio *portio;
 294
 295	for (mi = 0; mi < MAX_UIO_MAPS; mi++) {
 296		mem = &idev->info->mem[mi];
 297		if (mem->size == 0)
 298			break;
 299		if (!map_found) {
 300			map_found = 1;
 301			idev->map_dir = kobject_create_and_add("maps",
 302							&idev->dev.kobj);
 303			if (!idev->map_dir) {
 304				ret = -ENOMEM;
 305				goto err_map;
 306			}
 307		}
 308		map = kzalloc(sizeof(*map), GFP_KERNEL);
 309		if (!map) {
 310			ret = -ENOMEM;
 311			goto err_map;
 312		}
 313		kobject_init(&map->kobj, &map_attr_type);
 314		map->mem = mem;
 315		mem->map = map;
 316		ret = kobject_add(&map->kobj, idev->map_dir, "map%d", mi);
 317		if (ret)
 318			goto err_map_kobj;
 319		ret = kobject_uevent(&map->kobj, KOBJ_ADD);
 320		if (ret)
 321			goto err_map_kobj;
 322	}
 323
 324	for (pi = 0; pi < MAX_UIO_PORT_REGIONS; pi++) {
 325		port = &idev->info->port[pi];
 326		if (port->size == 0)
 327			break;
 328		if (!portio_found) {
 329			portio_found = 1;
 330			idev->portio_dir = kobject_create_and_add("portio",
 331							&idev->dev.kobj);
 332			if (!idev->portio_dir) {
 333				ret = -ENOMEM;
 334				goto err_portio;
 335			}
 336		}
 337		portio = kzalloc(sizeof(*portio), GFP_KERNEL);
 338		if (!portio) {
 339			ret = -ENOMEM;
 340			goto err_portio;
 341		}
 342		kobject_init(&portio->kobj, &portio_attr_type);
 343		portio->port = port;
 344		port->portio = portio;
 345		ret = kobject_add(&portio->kobj, idev->portio_dir,
 346							"port%d", pi);
 347		if (ret)
 348			goto err_portio_kobj;
 349		ret = kobject_uevent(&portio->kobj, KOBJ_ADD);
 350		if (ret)
 351			goto err_portio_kobj;
 352	}
 353
 354	return 0;
 355
 356err_portio:
 357	pi--;
 358err_portio_kobj:
 359	for (; pi >= 0; pi--) {
 360		port = &idev->info->port[pi];
 361		portio = port->portio;
 362		kobject_put(&portio->kobj);
 363	}
 364	kobject_put(idev->portio_dir);
 365err_map:
 366	mi--;
 367err_map_kobj:
 368	for (; mi >= 0; mi--) {
 369		mem = &idev->info->mem[mi];
 370		map = mem->map;
 371		kobject_put(&map->kobj);
 372	}
 373	kobject_put(idev->map_dir);
 374	dev_err(&idev->dev, "error creating sysfs files (%d)\n", ret);
 375	return ret;
 376}
 377
 378static void uio_dev_del_attributes(struct uio_device *idev)
 379{
 380	int i;
 381	struct uio_mem *mem;
 382	struct uio_port *port;
 383
 384	for (i = 0; i < MAX_UIO_MAPS; i++) {
 385		mem = &idev->info->mem[i];
 386		if (mem->size == 0)
 387			break;
 388		kobject_put(&mem->map->kobj);
 389	}
 390	kobject_put(idev->map_dir);
 391
 392	for (i = 0; i < MAX_UIO_PORT_REGIONS; i++) {
 393		port = &idev->info->port[i];
 394		if (port->size == 0)
 395			break;
 396		kobject_put(&port->portio->kobj);
 397	}
 398	kobject_put(idev->portio_dir);
 399}
 400
 401static int uio_get_minor(struct uio_device *idev)
 402{
 403	int retval;
 
 404
 405	mutex_lock(&minor_lock);
 406	retval = idr_alloc(&uio_idr, idev, 0, UIO_MAX_DEVICES, GFP_KERNEL);
 407	if (retval >= 0) {
 408		idev->minor = retval;
 409		retval = 0;
 410	} else if (retval == -ENOSPC) {
 411		dev_err(&idev->dev, "too many uio devices\n");
 
 
 
 
 
 
 
 412		retval = -EINVAL;
 
 413	}
 
 414	mutex_unlock(&minor_lock);
 415	return retval;
 416}
 417
 418static void uio_free_minor(unsigned long minor)
 419{
 420	mutex_lock(&minor_lock);
 421	idr_remove(&uio_idr, minor);
 422	mutex_unlock(&minor_lock);
 423}
 424
 425/**
 426 * uio_event_notify - trigger an interrupt event
 427 * @info: UIO device capabilities
 428 */
 429void uio_event_notify(struct uio_info *info)
 430{
 431	struct uio_device *idev = info->uio_dev;
 432
 433	atomic_inc(&idev->event);
 434	wake_up_interruptible(&idev->wait);
 435	kill_fasync(&idev->async_queue, SIGIO, POLL_IN);
 436}
 437EXPORT_SYMBOL_GPL(uio_event_notify);
 438
 439/**
 440 * uio_interrupt - hardware interrupt handler
 441 * @irq: IRQ number, can be UIO_IRQ_CYCLIC for cyclic timer
 442 * @dev_id: Pointer to the devices uio_device structure
 443 */
 444static irqreturn_t uio_interrupt(int irq, void *dev_id)
 445{
 446	struct uio_device *idev = (struct uio_device *)dev_id;
 447	irqreturn_t ret;
 448
 449	ret = idev->info->handler(irq, idev->info);
 450	if (ret == IRQ_HANDLED)
 451		uio_event_notify(idev->info);
 452
 453	return ret;
 454}
 455
 456struct uio_listener {
 457	struct uio_device *dev;
 458	s32 event_count;
 459};
 460
 461static int uio_open(struct inode *inode, struct file *filep)
 462{
 463	struct uio_device *idev;
 464	struct uio_listener *listener;
 465	int ret = 0;
 466
 467	mutex_lock(&minor_lock);
 468	idev = idr_find(&uio_idr, iminor(inode));
 
 469	if (!idev) {
 470		ret = -ENODEV;
 471		mutex_unlock(&minor_lock);
 472		goto out;
 473	}
 474	get_device(&idev->dev);
 475	mutex_unlock(&minor_lock);
 476
 477	if (!try_module_get(idev->owner)) {
 478		ret = -ENODEV;
 479		goto err_module_get;
 480	}
 481
 482	listener = kmalloc(sizeof(*listener), GFP_KERNEL);
 483	if (!listener) {
 484		ret = -ENOMEM;
 485		goto err_alloc_listener;
 486	}
 487
 488	listener->dev = idev;
 489	listener->event_count = atomic_read(&idev->event);
 490	filep->private_data = listener;
 491
 492	mutex_lock(&idev->info_lock);
 493	if (!idev->info) {
 494		mutex_unlock(&idev->info_lock);
 495		ret = -EINVAL;
 496		goto err_infoopen;
 497	}
 498
 499	if (idev->info->open)
 500		ret = idev->info->open(idev->info, inode);
 501	mutex_unlock(&idev->info_lock);
 502	if (ret)
 503		goto err_infoopen;
 504
 505	return 0;
 506
 507err_infoopen:
 508	kfree(listener);
 509
 510err_alloc_listener:
 511	module_put(idev->owner);
 512
 513err_module_get:
 514	put_device(&idev->dev);
 515
 516out:
 517	return ret;
 518}
 519
 520static int uio_fasync(int fd, struct file *filep, int on)
 521{
 522	struct uio_listener *listener = filep->private_data;
 523	struct uio_device *idev = listener->dev;
 524
 525	return fasync_helper(fd, filep, on, &idev->async_queue);
 526}
 527
 528static int uio_release(struct inode *inode, struct file *filep)
 529{
 530	int ret = 0;
 531	struct uio_listener *listener = filep->private_data;
 532	struct uio_device *idev = listener->dev;
 533
 534	mutex_lock(&idev->info_lock);
 535	if (idev->info && idev->info->release)
 536		ret = idev->info->release(idev->info, inode);
 537	mutex_unlock(&idev->info_lock);
 538
 539	module_put(idev->owner);
 540	kfree(listener);
 541	put_device(&idev->dev);
 542	return ret;
 543}
 544
 545static __poll_t uio_poll(struct file *filep, poll_table *wait)
 546{
 547	struct uio_listener *listener = filep->private_data;
 548	struct uio_device *idev = listener->dev;
 549	__poll_t ret = 0;
 550
 551	mutex_lock(&idev->info_lock);
 552	if (!idev->info || !idev->info->irq)
 553		ret = -EIO;
 554	mutex_unlock(&idev->info_lock);
 555
 556	if (ret)
 557		return ret;
 558
 559	poll_wait(filep, &idev->wait, wait);
 560	if (listener->event_count != atomic_read(&idev->event))
 561		return EPOLLIN | EPOLLRDNORM;
 562	return 0;
 563}
 564
 565static ssize_t uio_read(struct file *filep, char __user *buf,
 566			size_t count, loff_t *ppos)
 567{
 568	struct uio_listener *listener = filep->private_data;
 569	struct uio_device *idev = listener->dev;
 570	DECLARE_WAITQUEUE(wait, current);
 571	ssize_t retval = 0;
 572	s32 event_count;
 573
 
 
 
 574	if (count != sizeof(s32))
 575		return -EINVAL;
 576
 577	add_wait_queue(&idev->wait, &wait);
 578
 579	do {
 580		mutex_lock(&idev->info_lock);
 581		if (!idev->info || !idev->info->irq) {
 582			retval = -EIO;
 583			mutex_unlock(&idev->info_lock);
 584			break;
 585		}
 586		mutex_unlock(&idev->info_lock);
 587
 588		set_current_state(TASK_INTERRUPTIBLE);
 589
 590		event_count = atomic_read(&idev->event);
 591		if (event_count != listener->event_count) {
 592			__set_current_state(TASK_RUNNING);
 593			if (copy_to_user(buf, &event_count, count))
 594				retval = -EFAULT;
 595			else {
 596				listener->event_count = event_count;
 597				retval = count;
 598			}
 599			break;
 600		}
 601
 602		if (filep->f_flags & O_NONBLOCK) {
 603			retval = -EAGAIN;
 604			break;
 605		}
 606
 607		if (signal_pending(current)) {
 608			retval = -ERESTARTSYS;
 609			break;
 610		}
 611		schedule();
 612	} while (1);
 613
 614	__set_current_state(TASK_RUNNING);
 615	remove_wait_queue(&idev->wait, &wait);
 616
 617	return retval;
 618}
 619
 620static ssize_t uio_write(struct file *filep, const char __user *buf,
 621			size_t count, loff_t *ppos)
 622{
 623	struct uio_listener *listener = filep->private_data;
 624	struct uio_device *idev = listener->dev;
 625	ssize_t retval;
 626	s32 irq_on;
 627
 
 
 
 628	if (count != sizeof(s32))
 629		return -EINVAL;
 630
 
 
 
 631	if (copy_from_user(&irq_on, buf, count))
 632		return -EFAULT;
 633
 634	mutex_lock(&idev->info_lock);
 635	if (!idev->info) {
 636		retval = -EINVAL;
 637		goto out;
 638	}
 639
 640	if (!idev->info->irq) {
 641		retval = -EIO;
 642		goto out;
 643	}
 644
 645	if (!idev->info->irqcontrol) {
 646		retval = -ENOSYS;
 647		goto out;
 648	}
 649
 650	retval = idev->info->irqcontrol(idev->info, irq_on);
 651
 652out:
 653	mutex_unlock(&idev->info_lock);
 654	return retval ? retval : sizeof(s32);
 655}
 656
 657static int uio_find_mem_index(struct vm_area_struct *vma)
 658{
 659	struct uio_device *idev = vma->vm_private_data;
 660
 661	if (vma->vm_pgoff < MAX_UIO_MAPS) {
 662		if (idev->info->mem[vma->vm_pgoff].size == 0)
 663			return -1;
 664		return (int)vma->vm_pgoff;
 665	}
 666	return -1;
 667}
 668
 669static vm_fault_t uio_vma_fault(struct vm_fault *vmf)
 670{
 671	struct uio_device *idev = vmf->vma->vm_private_data;
 
 
 
 
 
 
 
 
 
 
 
 
 672	struct page *page;
 673	unsigned long offset;
 674	void *addr;
 675	vm_fault_t ret = 0;
 676	int mi;
 677
 678	mutex_lock(&idev->info_lock);
 679	if (!idev->info) {
 680		ret = VM_FAULT_SIGBUS;
 681		goto out;
 682	}
 683
 684	mi = uio_find_mem_index(vmf->vma);
 685	if (mi < 0) {
 686		ret = VM_FAULT_SIGBUS;
 687		goto out;
 688	}
 689
 690	/*
 691	 * We need to subtract mi because userspace uses offset = N*PAGE_SIZE
 692	 * to use mem[N].
 693	 */
 694	offset = (vmf->pgoff - mi) << PAGE_SHIFT;
 695
 696	addr = (void *)(unsigned long)idev->info->mem[mi].addr + offset;
 697	if (idev->info->mem[mi].memtype == UIO_MEM_LOGICAL)
 698		page = virt_to_page(addr);
 699	else
 700		page = vmalloc_to_page(addr);
 701	get_page(page);
 702	vmf->page = page;
 703
 704out:
 705	mutex_unlock(&idev->info_lock);
 706
 707	return ret;
 708}
 709
 710static const struct vm_operations_struct uio_logical_vm_ops = {
 
 
 711	.fault = uio_vma_fault,
 712};
 713
 714static int uio_mmap_logical(struct vm_area_struct *vma)
 715{
 716	vm_flags_set(vma, VM_DONTEXPAND | VM_DONTDUMP);
 717	vma->vm_ops = &uio_logical_vm_ops;
 718	return 0;
 719}
 720
 721static const struct vm_operations_struct uio_physical_vm_ops = {
 722#ifdef CONFIG_HAVE_IOREMAP_PROT
 723	.access = generic_access_phys,
 724#endif
 725};
 726
 727static int uio_mmap_physical(struct vm_area_struct *vma)
 728{
 729	struct uio_device *idev = vma->vm_private_data;
 730	int mi = uio_find_mem_index(vma);
 731	struct uio_mem *mem;
 732
 733	if (mi < 0)
 734		return -EINVAL;
 735	mem = idev->info->mem + mi;
 736
 737	if (mem->addr & ~PAGE_MASK)
 738		return -ENODEV;
 739	if (vma->vm_end - vma->vm_start > mem->size)
 740		return -EINVAL;
 741
 742	vma->vm_ops = &uio_physical_vm_ops;
 743	if (idev->info->mem[mi].memtype == UIO_MEM_PHYS)
 744		vma->vm_page_prot = pgprot_noncached(vma->vm_page_prot);
 745
 746	/*
 747	 * We cannot use the vm_iomap_memory() helper here,
 748	 * because vma->vm_pgoff is the map index we looked
 749	 * up above in uio_find_mem_index(), rather than an
 750	 * actual page offset into the mmap.
 751	 *
 752	 * So we just do the physical mmap without a page
 753	 * offset.
 754	 */
 755	return remap_pfn_range(vma,
 756			       vma->vm_start,
 757			       mem->addr >> PAGE_SHIFT,
 758			       vma->vm_end - vma->vm_start,
 759			       vma->vm_page_prot);
 760}
 761
 
 
 
 
 
 
 
 
 762static int uio_mmap(struct file *filep, struct vm_area_struct *vma)
 763{
 764	struct uio_listener *listener = filep->private_data;
 765	struct uio_device *idev = listener->dev;
 766	int mi;
 767	unsigned long requested_pages, actual_pages;
 768	int ret = 0;
 769
 770	if (vma->vm_end < vma->vm_start)
 771		return -EINVAL;
 772
 773	vma->vm_private_data = idev;
 774
 775	mutex_lock(&idev->info_lock);
 776	if (!idev->info) {
 777		ret = -EINVAL;
 778		goto out;
 779	}
 780
 781	mi = uio_find_mem_index(vma);
 782	if (mi < 0) {
 783		ret = -EINVAL;
 784		goto out;
 785	}
 786
 787	requested_pages = vma_pages(vma);
 788	actual_pages = ((idev->info->mem[mi].addr & ~PAGE_MASK)
 789			+ idev->info->mem[mi].size + PAGE_SIZE -1) >> PAGE_SHIFT;
 790	if (requested_pages > actual_pages) {
 791		ret = -EINVAL;
 792		goto out;
 793	}
 794
 795	if (idev->info->mmap) {
 796		ret = idev->info->mmap(idev->info, vma);
 797		goto out;
 798	}
 799
 800	switch (idev->info->mem[mi].memtype) {
 801	case UIO_MEM_IOVA:
 802	case UIO_MEM_PHYS:
 803		ret = uio_mmap_physical(vma);
 804		break;
 805	case UIO_MEM_LOGICAL:
 806	case UIO_MEM_VIRTUAL:
 807		ret = uio_mmap_logical(vma);
 808		break;
 809	default:
 810		ret = -EINVAL;
 811	}
 812
 813 out:
 814	mutex_unlock(&idev->info_lock);
 815	return ret;
 816}
 817
 818static const struct file_operations uio_fops = {
 819	.owner		= THIS_MODULE,
 820	.open		= uio_open,
 821	.release	= uio_release,
 822	.read		= uio_read,
 823	.write		= uio_write,
 824	.mmap		= uio_mmap,
 825	.poll		= uio_poll,
 826	.fasync		= uio_fasync,
 827	.llseek		= noop_llseek,
 828};
 829
 830static int uio_major_init(void)
 831{
 832	static const char name[] = "uio";
 833	struct cdev *cdev = NULL;
 834	dev_t uio_dev = 0;
 835	int result;
 836
 837	result = alloc_chrdev_region(&uio_dev, 0, UIO_MAX_DEVICES, name);
 838	if (result)
 839		goto out;
 840
 841	result = -ENOMEM;
 842	cdev = cdev_alloc();
 843	if (!cdev)
 844		goto out_unregister;
 845
 846	cdev->owner = THIS_MODULE;
 847	cdev->ops = &uio_fops;
 848	kobject_set_name(&cdev->kobj, "%s", name);
 849
 850	result = cdev_add(cdev, uio_dev, UIO_MAX_DEVICES);
 851	if (result)
 852		goto out_put;
 853
 854	uio_major = MAJOR(uio_dev);
 855	uio_cdev = cdev;
 856	return 0;
 857out_put:
 858	kobject_put(&cdev->kobj);
 859out_unregister:
 860	unregister_chrdev_region(uio_dev, UIO_MAX_DEVICES);
 861out:
 862	return result;
 863}
 864
 865static void uio_major_cleanup(void)
 866{
 867	unregister_chrdev_region(MKDEV(uio_major, 0), UIO_MAX_DEVICES);
 868	cdev_del(uio_cdev);
 869}
 870
 871static int init_uio_class(void)
 872{
 873	int ret;
 874
 875	/* This is the first time in here, set everything up properly */
 876	ret = uio_major_init();
 877	if (ret)
 878		goto exit;
 879
 880	ret = class_register(&uio_class);
 881	if (ret) {
 882		printk(KERN_ERR "class_register failed for uio\n");
 883		goto err_class_register;
 884	}
 885
 886	uio_class_registered = true;
 887
 888	return 0;
 889
 890err_class_register:
 891	uio_major_cleanup();
 892exit:
 893	return ret;
 894}
 895
 896static void release_uio_class(void)
 897{
 898	uio_class_registered = false;
 899	class_unregister(&uio_class);
 900	uio_major_cleanup();
 901}
 902
 903static void uio_device_release(struct device *dev)
 904{
 905	struct uio_device *idev = dev_get_drvdata(dev);
 906
 907	kfree(idev);
 908}
 909
 910/**
 911 * __uio_register_device - register a new userspace IO device
 912 * @owner:	module that creates the new device
 913 * @parent:	parent device
 914 * @info:	UIO device capabilities
 915 *
 916 * returns zero on success or a negative error code.
 917 */
 918int __uio_register_device(struct module *owner,
 919			  struct device *parent,
 920			  struct uio_info *info)
 921{
 922	struct uio_device *idev;
 923	int ret = 0;
 924
 925	if (!uio_class_registered)
 926		return -EPROBE_DEFER;
 927
 928	if (!parent || !info || !info->name || !info->version)
 929		return -EINVAL;
 930
 931	info->uio_dev = NULL;
 932
 933	idev = kzalloc(sizeof(*idev), GFP_KERNEL);
 934	if (!idev) {
 935		return -ENOMEM;
 
 936	}
 937
 938	idev->owner = owner;
 939	idev->info = info;
 940	mutex_init(&idev->info_lock);
 941	init_waitqueue_head(&idev->wait);
 942	atomic_set(&idev->event, 0);
 943
 944	ret = uio_get_minor(idev);
 945	if (ret) {
 946		kfree(idev);
 947		return ret;
 948	}
 949
 950	device_initialize(&idev->dev);
 951	idev->dev.devt = MKDEV(uio_major, idev->minor);
 952	idev->dev.class = &uio_class;
 953	idev->dev.parent = parent;
 954	idev->dev.release = uio_device_release;
 955	dev_set_drvdata(&idev->dev, idev);
 956
 957	ret = dev_set_name(&idev->dev, "uio%d", idev->minor);
 958	if (ret)
 959		goto err_device_create;
 960
 961	ret = device_add(&idev->dev);
 962	if (ret)
 
 
 
 
 963		goto err_device_create;
 
 964
 965	ret = uio_dev_add_attributes(idev);
 966	if (ret)
 967		goto err_uio_dev_add_attributes;
 968
 969	info->uio_dev = idev;
 970
 971	if (info->irq && (info->irq != UIO_IRQ_CUSTOM)) {
 972		/*
 973		 * Note that we deliberately don't use devm_request_irq
 974		 * here. The parent module can unregister the UIO device
 975		 * and call pci_disable_msi, which requires that this
 976		 * irq has been freed. However, the device may have open
 977		 * FDs at the time of unregister and therefore may not be
 978		 * freed until they are released.
 979		 */
 980		ret = request_irq(info->irq, uio_interrupt,
 981				  info->irq_flags, info->name, idev);
 982		if (ret) {
 983			info->uio_dev = NULL;
 984			goto err_request_irq;
 985		}
 986	}
 987
 988	return 0;
 989
 990err_request_irq:
 991	uio_dev_del_attributes(idev);
 992err_uio_dev_add_attributes:
 993	device_del(&idev->dev);
 994err_device_create:
 995	uio_free_minor(idev->minor);
 996	put_device(&idev->dev);
 
 
 997	return ret;
 998}
 999EXPORT_SYMBOL_GPL(__uio_register_device);
1000
1001static void devm_uio_unregister_device(struct device *dev, void *res)
1002{
1003	uio_unregister_device(*(struct uio_info **)res);
1004}
1005
1006/**
1007 * __devm_uio_register_device - Resource managed uio_register_device()
1008 * @owner:	module that creates the new device
1009 * @parent:	parent device
1010 * @info:	UIO device capabilities
1011 *
1012 * returns zero on success or a negative error code.
1013 */
1014int __devm_uio_register_device(struct module *owner,
1015			       struct device *parent,
1016			       struct uio_info *info)
1017{
1018	struct uio_info **ptr;
1019	int ret;
1020
1021	ptr = devres_alloc(devm_uio_unregister_device, sizeof(*ptr),
1022			   GFP_KERNEL);
1023	if (!ptr)
1024		return -ENOMEM;
1025
1026	*ptr = info;
1027	ret = __uio_register_device(owner, parent, info);
1028	if (ret) {
1029		devres_free(ptr);
1030		return ret;
1031	}
1032
1033	devres_add(parent, ptr);
1034
1035	return 0;
1036}
1037EXPORT_SYMBOL_GPL(__devm_uio_register_device);
1038
1039/**
1040 * uio_unregister_device - unregister a industrial IO device
1041 * @info:	UIO device capabilities
1042 *
1043 */
1044void uio_unregister_device(struct uio_info *info)
1045{
1046	struct uio_device *idev;
1047	unsigned long minor;
1048
1049	if (!info || !info->uio_dev)
1050		return;
1051
1052	idev = info->uio_dev;
1053	minor = idev->minor;
1054
1055	mutex_lock(&idev->info_lock);
1056	uio_dev_del_attributes(idev);
1057
1058	if (info->irq && info->irq != UIO_IRQ_CUSTOM)
1059		free_irq(info->irq, idev);
1060
1061	idev->info = NULL;
1062	mutex_unlock(&idev->info_lock);
1063
1064	wake_up_interruptible(&idev->wait);
1065	kill_fasync(&idev->async_queue, SIGIO, POLL_HUP);
1066
1067	uio_free_minor(minor);
1068	device_unregister(&idev->dev);
1069
1070	return;
1071}
1072EXPORT_SYMBOL_GPL(uio_unregister_device);
1073
1074static int __init uio_init(void)
1075{
1076	return init_uio_class();
1077}
1078
1079static void __exit uio_exit(void)
1080{
1081	release_uio_class();
1082	idr_destroy(&uio_idr);
1083}
1084
1085module_init(uio_init)
1086module_exit(uio_exit)
1087MODULE_LICENSE("GPL v2");