uio.c 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724
  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@linutronix.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. #include <linux/module.h>
  16. #include <linux/init.h>
  17. #include <linux/poll.h>
  18. #include <linux/device.h>
  19. #include <linux/mm.h>
  20. #include <linux/idr.h>
  21. #include <linux/string.h>
  22. #include <linux/kobject.h>
  23. #include <linux/uio_driver.h>
  24. #define UIO_MAX_DEVICES 255
  25. struct uio_device {
  26. struct module *owner;
  27. struct device *dev;
  28. int minor;
  29. atomic_t event;
  30. struct fasync_struct *async_queue;
  31. wait_queue_head_t wait;
  32. int vma_count;
  33. struct uio_info *info;
  34. struct kobject *map_dir;
  35. };
  36. static int uio_major;
  37. static DEFINE_IDR(uio_idr);
  38. static const struct file_operations uio_fops;
  39. /* UIO class infrastructure */
  40. static struct uio_class {
  41. struct kref kref;
  42. struct class *class;
  43. } *uio_class;
  44. /*
  45. * attributes
  46. */
  47. struct uio_map {
  48. struct kobject kobj;
  49. struct uio_mem *mem;
  50. };
  51. #define to_map(map) container_of(map, struct uio_map, kobj)
  52. static ssize_t map_addr_show(struct uio_mem *mem, char *buf)
  53. {
  54. return sprintf(buf, "0x%lx\n", mem->addr);
  55. }
  56. static ssize_t map_size_show(struct uio_mem *mem, char *buf)
  57. {
  58. return sprintf(buf, "0x%lx\n", mem->size);
  59. }
  60. struct uio_sysfs_entry {
  61. struct attribute attr;
  62. ssize_t (*show)(struct uio_mem *, char *);
  63. ssize_t (*store)(struct uio_mem *, const char *, size_t);
  64. };
  65. static struct uio_sysfs_entry addr_attribute =
  66. __ATTR(addr, S_IRUGO, map_addr_show, NULL);
  67. static struct uio_sysfs_entry size_attribute =
  68. __ATTR(size, S_IRUGO, map_size_show, NULL);
  69. static struct attribute *attrs[] = {
  70. &addr_attribute.attr,
  71. &size_attribute.attr,
  72. NULL, /* need to NULL terminate the list of attributes */
  73. };
  74. static void map_release(struct kobject *kobj)
  75. {
  76. struct uio_map *map = to_map(kobj);
  77. kfree(map);
  78. }
  79. static ssize_t map_type_show(struct kobject *kobj, struct attribute *attr,
  80. char *buf)
  81. {
  82. struct uio_map *map = to_map(kobj);
  83. struct uio_mem *mem = map->mem;
  84. struct uio_sysfs_entry *entry;
  85. entry = container_of(attr, struct uio_sysfs_entry, attr);
  86. if (!entry->show)
  87. return -EIO;
  88. return entry->show(mem, buf);
  89. }
  90. static struct sysfs_ops uio_sysfs_ops = {
  91. .show = map_type_show,
  92. };
  93. static struct kobj_type map_attr_type = {
  94. .release = map_release,
  95. .sysfs_ops = &uio_sysfs_ops,
  96. .default_attrs = attrs,
  97. };
  98. static ssize_t show_name(struct device *dev,
  99. struct device_attribute *attr, char *buf)
  100. {
  101. struct uio_device *idev = dev_get_drvdata(dev);
  102. if (idev)
  103. return sprintf(buf, "%s\n", idev->info->name);
  104. else
  105. return -ENODEV;
  106. }
  107. static DEVICE_ATTR(name, S_IRUGO, show_name, NULL);
  108. static ssize_t show_version(struct device *dev,
  109. struct device_attribute *attr, char *buf)
  110. {
  111. struct uio_device *idev = dev_get_drvdata(dev);
  112. if (idev)
  113. return sprintf(buf, "%s\n", idev->info->version);
  114. else
  115. return -ENODEV;
  116. }
  117. static DEVICE_ATTR(version, S_IRUGO, show_version, NULL);
  118. static ssize_t show_event(struct device *dev,
  119. struct device_attribute *attr, char *buf)
  120. {
  121. struct uio_device *idev = dev_get_drvdata(dev);
  122. if (idev)
  123. return sprintf(buf, "%u\n",
  124. (unsigned int)atomic_read(&idev->event));
  125. else
  126. return -ENODEV;
  127. }
  128. static DEVICE_ATTR(event, S_IRUGO, show_event, NULL);
  129. static struct attribute *uio_attrs[] = {
  130. &dev_attr_name.attr,
  131. &dev_attr_version.attr,
  132. &dev_attr_event.attr,
  133. NULL,
  134. };
  135. static struct attribute_group uio_attr_grp = {
  136. .attrs = uio_attrs,
  137. };
  138. /*
  139. * device functions
  140. */
  141. static int uio_dev_add_attributes(struct uio_device *idev)
  142. {
  143. int ret;
  144. int mi;
  145. int map_found = 0;
  146. struct uio_mem *mem;
  147. struct uio_map *map;
  148. ret = sysfs_create_group(&idev->dev->kobj, &uio_attr_grp);
  149. if (ret)
  150. goto err_group;
  151. for (mi = 0; mi < MAX_UIO_MAPS; mi++) {
  152. mem = &idev->info->mem[mi];
  153. if (mem->size == 0)
  154. break;
  155. if (!map_found) {
  156. map_found = 1;
  157. idev->map_dir = kobject_create_and_add("maps",
  158. &idev->dev->kobj);
  159. if (!idev->map_dir)
  160. goto err;
  161. }
  162. map = kzalloc(sizeof(*map), GFP_KERNEL);
  163. if (!map)
  164. goto err;
  165. kobject_init(&map->kobj, &map_attr_type);
  166. map->mem = mem;
  167. mem->map = map;
  168. ret = kobject_add(&map->kobj, idev->map_dir, "map%d", mi);
  169. if (ret)
  170. goto err;
  171. ret = kobject_uevent(&map->kobj, KOBJ_ADD);
  172. if (ret)
  173. goto err;
  174. }
  175. return 0;
  176. err:
  177. for (mi--; mi>=0; mi--) {
  178. mem = &idev->info->mem[mi];
  179. map = mem->map;
  180. kobject_put(&map->kobj);
  181. }
  182. kobject_put(idev->map_dir);
  183. sysfs_remove_group(&idev->dev->kobj, &uio_attr_grp);
  184. err_group:
  185. dev_err(idev->dev, "error creating sysfs files (%d)\n", ret);
  186. return ret;
  187. }
  188. static void uio_dev_del_attributes(struct uio_device *idev)
  189. {
  190. int mi;
  191. struct uio_mem *mem;
  192. for (mi = 0; mi < MAX_UIO_MAPS; mi++) {
  193. mem = &idev->info->mem[mi];
  194. if (mem->size == 0)
  195. break;
  196. kobject_put(&mem->map->kobj);
  197. }
  198. kobject_put(idev->map_dir);
  199. sysfs_remove_group(&idev->dev->kobj, &uio_attr_grp);
  200. }
  201. static int uio_get_minor(struct uio_device *idev)
  202. {
  203. static DEFINE_MUTEX(minor_lock);
  204. int retval = -ENOMEM;
  205. int id;
  206. mutex_lock(&minor_lock);
  207. if (idr_pre_get(&uio_idr, GFP_KERNEL) == 0)
  208. goto exit;
  209. retval = idr_get_new(&uio_idr, idev, &id);
  210. if (retval < 0) {
  211. if (retval == -EAGAIN)
  212. retval = -ENOMEM;
  213. goto exit;
  214. }
  215. idev->minor = id & MAX_ID_MASK;
  216. exit:
  217. mutex_unlock(&minor_lock);
  218. return retval;
  219. }
  220. static void uio_free_minor(struct uio_device *idev)
  221. {
  222. idr_remove(&uio_idr, idev->minor);
  223. }
  224. /**
  225. * uio_event_notify - trigger an interrupt event
  226. * @info: UIO device capabilities
  227. */
  228. void uio_event_notify(struct uio_info *info)
  229. {
  230. struct uio_device *idev = info->uio_dev;
  231. atomic_inc(&idev->event);
  232. wake_up_interruptible(&idev->wait);
  233. kill_fasync(&idev->async_queue, SIGIO, POLL_IN);
  234. }
  235. EXPORT_SYMBOL_GPL(uio_event_notify);
  236. /**
  237. * uio_interrupt - hardware interrupt handler
  238. * @irq: IRQ number, can be UIO_IRQ_CYCLIC for cyclic timer
  239. * @dev_id: Pointer to the devices uio_device structure
  240. */
  241. static irqreturn_t uio_interrupt(int irq, void *dev_id)
  242. {
  243. struct uio_device *idev = (struct uio_device *)dev_id;
  244. irqreturn_t ret = idev->info->handler(irq, idev->info);
  245. if (ret == IRQ_HANDLED)
  246. uio_event_notify(idev->info);
  247. return ret;
  248. }
  249. struct uio_listener {
  250. struct uio_device *dev;
  251. s32 event_count;
  252. };
  253. static int uio_open(struct inode *inode, struct file *filep)
  254. {
  255. struct uio_device *idev;
  256. struct uio_listener *listener;
  257. int ret = 0;
  258. idev = idr_find(&uio_idr, iminor(inode));
  259. if (!idev)
  260. return -ENODEV;
  261. listener = kmalloc(sizeof(*listener), GFP_KERNEL);
  262. if (!listener)
  263. return -ENOMEM;
  264. listener->dev = idev;
  265. listener->event_count = atomic_read(&idev->event);
  266. filep->private_data = listener;
  267. if (idev->info->open) {
  268. if (!try_module_get(idev->owner))
  269. return -ENODEV;
  270. ret = idev->info->open(idev->info, inode);
  271. module_put(idev->owner);
  272. }
  273. if (ret)
  274. kfree(listener);
  275. return ret;
  276. }
  277. static int uio_fasync(int fd, struct file *filep, int on)
  278. {
  279. struct uio_listener *listener = filep->private_data;
  280. struct uio_device *idev = listener->dev;
  281. return fasync_helper(fd, filep, on, &idev->async_queue);
  282. }
  283. static int uio_release(struct inode *inode, struct file *filep)
  284. {
  285. int ret = 0;
  286. struct uio_listener *listener = filep->private_data;
  287. struct uio_device *idev = listener->dev;
  288. if (idev->info->release) {
  289. if (!try_module_get(idev->owner))
  290. return -ENODEV;
  291. ret = idev->info->release(idev->info, inode);
  292. module_put(idev->owner);
  293. }
  294. if (filep->f_flags & FASYNC)
  295. ret = uio_fasync(-1, filep, 0);
  296. kfree(listener);
  297. return ret;
  298. }
  299. static unsigned int uio_poll(struct file *filep, poll_table *wait)
  300. {
  301. struct uio_listener *listener = filep->private_data;
  302. struct uio_device *idev = listener->dev;
  303. if (idev->info->irq == UIO_IRQ_NONE)
  304. return -EIO;
  305. poll_wait(filep, &idev->wait, wait);
  306. if (listener->event_count != atomic_read(&idev->event))
  307. return POLLIN | POLLRDNORM;
  308. return 0;
  309. }
  310. static ssize_t uio_read(struct file *filep, char __user *buf,
  311. size_t count, loff_t *ppos)
  312. {
  313. struct uio_listener *listener = filep->private_data;
  314. struct uio_device *idev = listener->dev;
  315. DECLARE_WAITQUEUE(wait, current);
  316. ssize_t retval;
  317. s32 event_count;
  318. if (idev->info->irq == UIO_IRQ_NONE)
  319. return -EIO;
  320. if (count != sizeof(s32))
  321. return -EINVAL;
  322. add_wait_queue(&idev->wait, &wait);
  323. do {
  324. set_current_state(TASK_INTERRUPTIBLE);
  325. event_count = atomic_read(&idev->event);
  326. if (event_count != listener->event_count) {
  327. if (copy_to_user(buf, &event_count, count))
  328. retval = -EFAULT;
  329. else {
  330. listener->event_count = event_count;
  331. retval = count;
  332. }
  333. break;
  334. }
  335. if (filep->f_flags & O_NONBLOCK) {
  336. retval = -EAGAIN;
  337. break;
  338. }
  339. if (signal_pending(current)) {
  340. retval = -ERESTARTSYS;
  341. break;
  342. }
  343. schedule();
  344. } while (1);
  345. __set_current_state(TASK_RUNNING);
  346. remove_wait_queue(&idev->wait, &wait);
  347. return retval;
  348. }
  349. static int uio_find_mem_index(struct vm_area_struct *vma)
  350. {
  351. int mi;
  352. struct uio_device *idev = vma->vm_private_data;
  353. for (mi = 0; mi < MAX_UIO_MAPS; mi++) {
  354. if (idev->info->mem[mi].size == 0)
  355. return -1;
  356. if (vma->vm_pgoff == mi)
  357. return mi;
  358. }
  359. return -1;
  360. }
  361. static void uio_vma_open(struct vm_area_struct *vma)
  362. {
  363. struct uio_device *idev = vma->vm_private_data;
  364. idev->vma_count++;
  365. }
  366. static void uio_vma_close(struct vm_area_struct *vma)
  367. {
  368. struct uio_device *idev = vma->vm_private_data;
  369. idev->vma_count--;
  370. }
  371. static int uio_vma_fault(struct vm_area_struct *vma, struct vm_fault *vmf)
  372. {
  373. struct uio_device *idev = vma->vm_private_data;
  374. struct page *page;
  375. int mi = uio_find_mem_index(vma);
  376. if (mi < 0)
  377. return VM_FAULT_SIGBUS;
  378. if (idev->info->mem[mi].memtype == UIO_MEM_LOGICAL)
  379. page = virt_to_page(idev->info->mem[mi].addr);
  380. else
  381. page = vmalloc_to_page((void*)idev->info->mem[mi].addr);
  382. get_page(page);
  383. vmf->page = page;
  384. return 0;
  385. }
  386. static struct vm_operations_struct uio_vm_ops = {
  387. .open = uio_vma_open,
  388. .close = uio_vma_close,
  389. .fault = uio_vma_fault,
  390. };
  391. static int uio_mmap_physical(struct vm_area_struct *vma)
  392. {
  393. struct uio_device *idev = vma->vm_private_data;
  394. int mi = uio_find_mem_index(vma);
  395. if (mi < 0)
  396. return -EINVAL;
  397. vma->vm_flags |= VM_IO | VM_RESERVED;
  398. return remap_pfn_range(vma,
  399. vma->vm_start,
  400. idev->info->mem[mi].addr >> PAGE_SHIFT,
  401. vma->vm_end - vma->vm_start,
  402. vma->vm_page_prot);
  403. }
  404. static int uio_mmap_logical(struct vm_area_struct *vma)
  405. {
  406. vma->vm_flags |= VM_RESERVED;
  407. vma->vm_ops = &uio_vm_ops;
  408. uio_vma_open(vma);
  409. return 0;
  410. }
  411. static int uio_mmap(struct file *filep, struct vm_area_struct *vma)
  412. {
  413. struct uio_listener *listener = filep->private_data;
  414. struct uio_device *idev = listener->dev;
  415. int mi;
  416. unsigned long requested_pages, actual_pages;
  417. int ret = 0;
  418. if (vma->vm_end < vma->vm_start)
  419. return -EINVAL;
  420. vma->vm_private_data = idev;
  421. mi = uio_find_mem_index(vma);
  422. if (mi < 0)
  423. return -EINVAL;
  424. requested_pages = (vma->vm_end - vma->vm_start) >> PAGE_SHIFT;
  425. actual_pages = (idev->info->mem[mi].size + PAGE_SIZE -1) >> PAGE_SHIFT;
  426. if (requested_pages > actual_pages)
  427. return -EINVAL;
  428. if (idev->info->mmap) {
  429. if (!try_module_get(idev->owner))
  430. return -ENODEV;
  431. ret = idev->info->mmap(idev->info, vma);
  432. module_put(idev->owner);
  433. return ret;
  434. }
  435. switch (idev->info->mem[mi].memtype) {
  436. case UIO_MEM_PHYS:
  437. return uio_mmap_physical(vma);
  438. case UIO_MEM_LOGICAL:
  439. case UIO_MEM_VIRTUAL:
  440. return uio_mmap_logical(vma);
  441. default:
  442. return -EINVAL;
  443. }
  444. }
  445. static const struct file_operations uio_fops = {
  446. .owner = THIS_MODULE,
  447. .open = uio_open,
  448. .release = uio_release,
  449. .read = uio_read,
  450. .mmap = uio_mmap,
  451. .poll = uio_poll,
  452. .fasync = uio_fasync,
  453. };
  454. static int uio_major_init(void)
  455. {
  456. uio_major = register_chrdev(0, "uio", &uio_fops);
  457. if (uio_major < 0)
  458. return uio_major;
  459. return 0;
  460. }
  461. static void uio_major_cleanup(void)
  462. {
  463. unregister_chrdev(uio_major, "uio");
  464. }
  465. static int init_uio_class(void)
  466. {
  467. int ret = 0;
  468. if (uio_class != NULL) {
  469. kref_get(&uio_class->kref);
  470. goto exit;
  471. }
  472. /* This is the first time in here, set everything up properly */
  473. ret = uio_major_init();
  474. if (ret)
  475. goto exit;
  476. uio_class = kzalloc(sizeof(*uio_class), GFP_KERNEL);
  477. if (!uio_class) {
  478. ret = -ENOMEM;
  479. goto err_kzalloc;
  480. }
  481. kref_init(&uio_class->kref);
  482. uio_class->class = class_create(THIS_MODULE, "uio");
  483. if (IS_ERR(uio_class->class)) {
  484. ret = IS_ERR(uio_class->class);
  485. printk(KERN_ERR "class_create failed for uio\n");
  486. goto err_class_create;
  487. }
  488. return 0;
  489. err_class_create:
  490. kfree(uio_class);
  491. uio_class = NULL;
  492. err_kzalloc:
  493. uio_major_cleanup();
  494. exit:
  495. return ret;
  496. }
  497. static void release_uio_class(struct kref *kref)
  498. {
  499. /* Ok, we cheat as we know we only have one uio_class */
  500. class_destroy(uio_class->class);
  501. kfree(uio_class);
  502. uio_major_cleanup();
  503. uio_class = NULL;
  504. }
  505. static void uio_class_destroy(void)
  506. {
  507. if (uio_class)
  508. kref_put(&uio_class->kref, release_uio_class);
  509. }
  510. /**
  511. * uio_register_device - register a new userspace IO device
  512. * @owner: module that creates the new device
  513. * @parent: parent device
  514. * @info: UIO device capabilities
  515. *
  516. * returns zero on success or a negative error code.
  517. */
  518. int __uio_register_device(struct module *owner,
  519. struct device *parent,
  520. struct uio_info *info)
  521. {
  522. struct uio_device *idev;
  523. int ret = 0;
  524. if (!parent || !info || !info->name || !info->version)
  525. return -EINVAL;
  526. info->uio_dev = NULL;
  527. ret = init_uio_class();
  528. if (ret)
  529. return ret;
  530. idev = kzalloc(sizeof(*idev), GFP_KERNEL);
  531. if (!idev) {
  532. ret = -ENOMEM;
  533. goto err_kzalloc;
  534. }
  535. idev->owner = owner;
  536. idev->info = info;
  537. init_waitqueue_head(&idev->wait);
  538. atomic_set(&idev->event, 0);
  539. ret = uio_get_minor(idev);
  540. if (ret)
  541. goto err_get_minor;
  542. idev->dev = device_create(uio_class->class, parent,
  543. MKDEV(uio_major, idev->minor),
  544. "uio%d", idev->minor);
  545. if (IS_ERR(idev->dev)) {
  546. printk(KERN_ERR "UIO: device register failed\n");
  547. ret = PTR_ERR(idev->dev);
  548. goto err_device_create;
  549. }
  550. dev_set_drvdata(idev->dev, idev);
  551. ret = uio_dev_add_attributes(idev);
  552. if (ret)
  553. goto err_uio_dev_add_attributes;
  554. info->uio_dev = idev;
  555. if (idev->info->irq >= 0) {
  556. ret = request_irq(idev->info->irq, uio_interrupt,
  557. idev->info->irq_flags, idev->info->name, idev);
  558. if (ret)
  559. goto err_request_irq;
  560. }
  561. return 0;
  562. err_request_irq:
  563. uio_dev_del_attributes(idev);
  564. err_uio_dev_add_attributes:
  565. device_destroy(uio_class->class, MKDEV(uio_major, idev->minor));
  566. err_device_create:
  567. uio_free_minor(idev);
  568. err_get_minor:
  569. kfree(idev);
  570. err_kzalloc:
  571. uio_class_destroy();
  572. return ret;
  573. }
  574. EXPORT_SYMBOL_GPL(__uio_register_device);
  575. /**
  576. * uio_unregister_device - unregister a industrial IO device
  577. * @info: UIO device capabilities
  578. *
  579. */
  580. void uio_unregister_device(struct uio_info *info)
  581. {
  582. struct uio_device *idev;
  583. if (!info || !info->uio_dev)
  584. return;
  585. idev = info->uio_dev;
  586. uio_free_minor(idev);
  587. if (info->irq >= 0)
  588. free_irq(info->irq, idev);
  589. uio_dev_del_attributes(idev);
  590. dev_set_drvdata(idev->dev, NULL);
  591. device_destroy(uio_class->class, MKDEV(uio_major, idev->minor));
  592. kfree(idev);
  593. uio_class_destroy();
  594. return;
  595. }
  596. EXPORT_SYMBOL_GPL(uio_unregister_device);
  597. static int __init uio_init(void)
  598. {
  599. return 0;
  600. }
  601. static void __exit uio_exit(void)
  602. {
  603. }
  604. module_init(uio_init)
  605. module_exit(uio_exit)
  606. MODULE_LICENSE("GPL v2");