misc.c 6.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293
  1. // SPDX-License-Identifier: GPL-2.0
  2. /*
  3. * linux/drivers/char/misc.c
  4. *
  5. * Generic misc open routine by Johan Myreen
  6. *
  7. * Based on code from Linus
  8. *
  9. * Teemu Rantanen's Microsoft Busmouse support and Derrick Cole's
  10. * changes incorporated into 0.97pl4
  11. * by Peter Cervasio (pete%[email protected]) (08SEP92)
  12. * See busmouse.c for particulars.
  13. *
  14. * Made things a lot mode modular - easy to compile in just one or two
  15. * of the misc drivers, as they are now completely independent. Linus.
  16. *
  17. * Support for loadable modules. 8-Sep-95 Philip Blundell <[email protected]>
  18. *
  19. * Fixed a failing symbol register to free the device registration
  20. * Alan Cox <[email protected]> 21-Jan-96
  21. *
  22. * Dynamic minors and /proc/mice by Alessandro Rubini. 26-Mar-96
  23. *
  24. * Renamed to misc and miscdevice to be more accurate. Alan Cox 26-Mar-96
  25. *
  26. * Handling of mouse minor numbers for kerneld:
  27. * Idea by Jacques Gelinas <[email protected]>,
  28. * adapted by Bjorn Ekwall <[email protected]>
  29. * corrected by Alan Cox <[email protected]>
  30. *
  31. * Changes for kmod (from kerneld):
  32. * Cyrus Durgin <[email protected]>
  33. *
  34. * Added devfs support. Richard Gooch <[email protected]> 10-Jan-1998
  35. */
  36. #include <linux/module.h>
  37. #include <linux/fs.h>
  38. #include <linux/errno.h>
  39. #include <linux/miscdevice.h>
  40. #include <linux/kernel.h>
  41. #include <linux/major.h>
  42. #include <linux/mutex.h>
  43. #include <linux/proc_fs.h>
  44. #include <linux/seq_file.h>
  45. #include <linux/stat.h>
  46. #include <linux/init.h>
  47. #include <linux/device.h>
  48. #include <linux/tty.h>
  49. #include <linux/kmod.h>
  50. #include <linux/gfp.h>
  51. /*
  52. * Head entry for the doubly linked miscdevice list
  53. */
  54. static LIST_HEAD(misc_list);
  55. static DEFINE_MUTEX(misc_mtx);
  56. /*
  57. * Assigned numbers, used for dynamic minors
  58. */
  59. #define DYNAMIC_MINORS 128 /* like dynamic majors */
  60. static DECLARE_BITMAP(misc_minors, DYNAMIC_MINORS);
  61. #ifdef CONFIG_PROC_FS
  62. static void *misc_seq_start(struct seq_file *seq, loff_t *pos)
  63. {
  64. mutex_lock(&misc_mtx);
  65. return seq_list_start(&misc_list, *pos);
  66. }
  67. static void *misc_seq_next(struct seq_file *seq, void *v, loff_t *pos)
  68. {
  69. return seq_list_next(v, &misc_list, pos);
  70. }
  71. static void misc_seq_stop(struct seq_file *seq, void *v)
  72. {
  73. mutex_unlock(&misc_mtx);
  74. }
  75. static int misc_seq_show(struct seq_file *seq, void *v)
  76. {
  77. const struct miscdevice *p = list_entry(v, struct miscdevice, list);
  78. seq_printf(seq, "%3i %s\n", p->minor, p->name ? p->name : "");
  79. return 0;
  80. }
  81. static const struct seq_operations misc_seq_ops = {
  82. .start = misc_seq_start,
  83. .next = misc_seq_next,
  84. .stop = misc_seq_stop,
  85. .show = misc_seq_show,
  86. };
  87. #endif
  88. static int misc_open(struct inode *inode, struct file *file)
  89. {
  90. int minor = iminor(inode);
  91. struct miscdevice *c = NULL, *iter;
  92. int err = -ENODEV;
  93. const struct file_operations *new_fops = NULL;
  94. mutex_lock(&misc_mtx);
  95. list_for_each_entry(iter, &misc_list, list) {
  96. if (iter->minor != minor)
  97. continue;
  98. c = iter;
  99. new_fops = fops_get(iter->fops);
  100. break;
  101. }
  102. if (!new_fops) {
  103. mutex_unlock(&misc_mtx);
  104. request_module("char-major-%d-%d", MISC_MAJOR, minor);
  105. mutex_lock(&misc_mtx);
  106. list_for_each_entry(iter, &misc_list, list) {
  107. if (iter->minor != minor)
  108. continue;
  109. c = iter;
  110. new_fops = fops_get(iter->fops);
  111. break;
  112. }
  113. if (!new_fops)
  114. goto fail;
  115. }
  116. /*
  117. * Place the miscdevice in the file's
  118. * private_data so it can be used by the
  119. * file operations, including f_op->open below
  120. */
  121. file->private_data = c;
  122. err = 0;
  123. replace_fops(file, new_fops);
  124. if (file->f_op->open)
  125. err = file->f_op->open(inode, file);
  126. fail:
  127. mutex_unlock(&misc_mtx);
  128. return err;
  129. }
  130. static struct class *misc_class;
  131. static const struct file_operations misc_fops = {
  132. .owner = THIS_MODULE,
  133. .open = misc_open,
  134. .llseek = noop_llseek,
  135. };
  136. /**
  137. * misc_register - register a miscellaneous device
  138. * @misc: device structure
  139. *
  140. * Register a miscellaneous device with the kernel. If the minor
  141. * number is set to %MISC_DYNAMIC_MINOR a minor number is assigned
  142. * and placed in the minor field of the structure. For other cases
  143. * the minor number requested is used.
  144. *
  145. * The structure passed is linked into the kernel and may not be
  146. * destroyed until it has been unregistered. By default, an open()
  147. * syscall to the device sets file->private_data to point to the
  148. * structure. Drivers don't need open in fops for this.
  149. *
  150. * A zero is returned on success and a negative errno code for
  151. * failure.
  152. */
  153. int misc_register(struct miscdevice *misc)
  154. {
  155. dev_t dev;
  156. int err = 0;
  157. bool is_dynamic = (misc->minor == MISC_DYNAMIC_MINOR);
  158. INIT_LIST_HEAD(&misc->list);
  159. mutex_lock(&misc_mtx);
  160. if (is_dynamic) {
  161. int i = find_first_zero_bit(misc_minors, DYNAMIC_MINORS);
  162. if (i >= DYNAMIC_MINORS) {
  163. err = -EBUSY;
  164. goto out;
  165. }
  166. misc->minor = DYNAMIC_MINORS - i - 1;
  167. set_bit(i, misc_minors);
  168. } else {
  169. struct miscdevice *c;
  170. list_for_each_entry(c, &misc_list, list) {
  171. if (c->minor == misc->minor) {
  172. err = -EBUSY;
  173. goto out;
  174. }
  175. }
  176. }
  177. dev = MKDEV(MISC_MAJOR, misc->minor);
  178. misc->this_device =
  179. device_create_with_groups(misc_class, misc->parent, dev,
  180. misc, misc->groups, "%s", misc->name);
  181. if (IS_ERR(misc->this_device)) {
  182. if (is_dynamic) {
  183. int i = DYNAMIC_MINORS - misc->minor - 1;
  184. if (i < DYNAMIC_MINORS && i >= 0)
  185. clear_bit(i, misc_minors);
  186. misc->minor = MISC_DYNAMIC_MINOR;
  187. }
  188. err = PTR_ERR(misc->this_device);
  189. goto out;
  190. }
  191. /*
  192. * Add it to the front, so that later devices can "override"
  193. * earlier defaults
  194. */
  195. list_add(&misc->list, &misc_list);
  196. out:
  197. mutex_unlock(&misc_mtx);
  198. return err;
  199. }
  200. EXPORT_SYMBOL(misc_register);
  201. /**
  202. * misc_deregister - unregister a miscellaneous device
  203. * @misc: device to unregister
  204. *
  205. * Unregister a miscellaneous device that was previously
  206. * successfully registered with misc_register().
  207. */
  208. void misc_deregister(struct miscdevice *misc)
  209. {
  210. int i = DYNAMIC_MINORS - misc->minor - 1;
  211. if (WARN_ON(list_empty(&misc->list)))
  212. return;
  213. mutex_lock(&misc_mtx);
  214. list_del(&misc->list);
  215. device_destroy(misc_class, MKDEV(MISC_MAJOR, misc->minor));
  216. if (i < DYNAMIC_MINORS && i >= 0)
  217. clear_bit(i, misc_minors);
  218. mutex_unlock(&misc_mtx);
  219. }
  220. EXPORT_SYMBOL(misc_deregister);
  221. static char *misc_devnode(struct device *dev, umode_t *mode)
  222. {
  223. struct miscdevice *c = dev_get_drvdata(dev);
  224. if (mode && c->mode)
  225. *mode = c->mode;
  226. if (c->nodename)
  227. return kstrdup(c->nodename, GFP_KERNEL);
  228. return NULL;
  229. }
  230. static int __init misc_init(void)
  231. {
  232. int err;
  233. struct proc_dir_entry *ret;
  234. ret = proc_create_seq("misc", 0, NULL, &misc_seq_ops);
  235. misc_class = class_create(THIS_MODULE, "misc");
  236. err = PTR_ERR(misc_class);
  237. if (IS_ERR(misc_class))
  238. goto fail_remove;
  239. err = -EIO;
  240. if (register_chrdev(MISC_MAJOR, "misc", &misc_fops))
  241. goto fail_printk;
  242. misc_class->devnode = misc_devnode;
  243. return 0;
  244. fail_printk:
  245. pr_err("unable to get major %d for misc devices\n", MISC_MAJOR);
  246. class_destroy(misc_class);
  247. fail_remove:
  248. if (ret)
  249. remove_proc_entry("misc", NULL);
  250. return err;
  251. }
  252. subsys_initcall(misc_init);