cuse.c 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634
  1. /*
  2. * CUSE: Character device in Userspace
  3. *
  4. * Copyright (C) 2008-2009 SUSE Linux Products GmbH
  5. * Copyright (C) 2008-2009 Tejun Heo <tj@kernel.org>
  6. *
  7. * This file is released under the GPLv2.
  8. *
  9. * CUSE enables character devices to be implemented from userland much
  10. * like FUSE allows filesystems. On initialization /dev/cuse is
  11. * created. By opening the file and replying to the CUSE_INIT request
  12. * userland CUSE server can create a character device. After that the
  13. * operation is very similar to FUSE.
  14. *
  15. * A CUSE instance involves the following objects.
  16. *
  17. * cuse_conn : contains fuse_conn and serves as bonding structure
  18. * channel : file handle connected to the userland CUSE server
  19. * cdev : the implemented character device
  20. * dev : generic device for cdev
  21. *
  22. * Note that 'channel' is what 'dev' is in FUSE. As CUSE deals with
  23. * devices, it's called 'channel' to reduce confusion.
  24. *
  25. * channel determines when the character device dies. When channel is
  26. * closed, everything begins to destruct. The cuse_conn is taken off
  27. * the lookup table preventing further access from cdev, cdev and
  28. * generic device are removed and the base reference of cuse_conn is
  29. * put.
  30. *
  31. * On each open, the matching cuse_conn is looked up and if found an
  32. * additional reference is taken which is released when the file is
  33. * closed.
  34. */
  35. #include <linux/fuse.h>
  36. #include <linux/cdev.h>
  37. #include <linux/device.h>
  38. #include <linux/file.h>
  39. #include <linux/fs.h>
  40. #include <linux/kdev_t.h>
  41. #include <linux/kthread.h>
  42. #include <linux/list.h>
  43. #include <linux/magic.h>
  44. #include <linux/miscdevice.h>
  45. #include <linux/mutex.h>
  46. #include <linux/slab.h>
  47. #include <linux/stat.h>
  48. #include <linux/module.h>
  49. #include "fuse_i.h"
  50. #define CUSE_CONNTBL_LEN 64
  51. struct cuse_conn {
  52. struct list_head list; /* linked on cuse_conntbl */
  53. struct fuse_conn fc; /* fuse connection */
  54. struct cdev *cdev; /* associated character device */
  55. struct device *dev; /* device representing @cdev */
  56. /* init parameters, set once during initialization */
  57. bool unrestricted_ioctl;
  58. };
  59. static DEFINE_MUTEX(cuse_lock); /* protects registration */
  60. static struct list_head cuse_conntbl[CUSE_CONNTBL_LEN];
  61. static struct class *cuse_class;
  62. static struct cuse_conn *fc_to_cc(struct fuse_conn *fc)
  63. {
  64. return container_of(fc, struct cuse_conn, fc);
  65. }
  66. static struct list_head *cuse_conntbl_head(dev_t devt)
  67. {
  68. return &cuse_conntbl[(MAJOR(devt) + MINOR(devt)) % CUSE_CONNTBL_LEN];
  69. }
  70. /**************************************************************************
  71. * CUSE frontend operations
  72. *
  73. * These are file operations for the character device.
  74. *
  75. * On open, CUSE opens a file from the FUSE mnt and stores it to
  76. * private_data of the open file. All other ops call FUSE ops on the
  77. * FUSE file.
  78. */
  79. static ssize_t cuse_read(struct file *file, char __user *buf, size_t count,
  80. loff_t *ppos)
  81. {
  82. loff_t pos = 0;
  83. struct iovec iov = { .iov_base = buf, .iov_len = count };
  84. struct fuse_io_priv io = { .async = 0, .file = file };
  85. return fuse_direct_io(&io, &iov, 1, count, &pos, 0);
  86. }
  87. static ssize_t cuse_write(struct file *file, const char __user *buf,
  88. size_t count, loff_t *ppos)
  89. {
  90. loff_t pos = 0;
  91. struct iovec iov = { .iov_base = (void __user *)buf, .iov_len = count };
  92. struct fuse_io_priv io = { .async = 0, .file = file };
  93. /*
  94. * No locking or generic_write_checks(), the server is
  95. * responsible for locking and sanity checks.
  96. */
  97. return fuse_direct_io(&io, &iov, 1, count, &pos, 1);
  98. }
  99. static int cuse_open(struct inode *inode, struct file *file)
  100. {
  101. dev_t devt = inode->i_cdev->dev;
  102. struct cuse_conn *cc = NULL, *pos;
  103. int rc;
  104. /* look up and get the connection */
  105. mutex_lock(&cuse_lock);
  106. list_for_each_entry(pos, cuse_conntbl_head(devt), list)
  107. if (pos->dev->devt == devt) {
  108. fuse_conn_get(&pos->fc);
  109. cc = pos;
  110. break;
  111. }
  112. mutex_unlock(&cuse_lock);
  113. /* dead? */
  114. if (!cc)
  115. return -ENODEV;
  116. /*
  117. * Generic permission check is already done against the chrdev
  118. * file, proceed to open.
  119. */
  120. rc = fuse_do_open(&cc->fc, 0, file, 0);
  121. if (rc)
  122. fuse_conn_put(&cc->fc);
  123. return rc;
  124. }
  125. static int cuse_release(struct inode *inode, struct file *file)
  126. {
  127. struct fuse_file *ff = file->private_data;
  128. struct fuse_conn *fc = ff->fc;
  129. fuse_sync_release(ff, file->f_flags);
  130. fuse_conn_put(fc);
  131. return 0;
  132. }
  133. static long cuse_file_ioctl(struct file *file, unsigned int cmd,
  134. unsigned long arg)
  135. {
  136. struct fuse_file *ff = file->private_data;
  137. struct cuse_conn *cc = fc_to_cc(ff->fc);
  138. unsigned int flags = 0;
  139. if (cc->unrestricted_ioctl)
  140. flags |= FUSE_IOCTL_UNRESTRICTED;
  141. return fuse_do_ioctl(file, cmd, arg, flags);
  142. }
  143. static long cuse_file_compat_ioctl(struct file *file, unsigned int cmd,
  144. unsigned long arg)
  145. {
  146. struct fuse_file *ff = file->private_data;
  147. struct cuse_conn *cc = fc_to_cc(ff->fc);
  148. unsigned int flags = FUSE_IOCTL_COMPAT;
  149. if (cc->unrestricted_ioctl)
  150. flags |= FUSE_IOCTL_UNRESTRICTED;
  151. return fuse_do_ioctl(file, cmd, arg, flags);
  152. }
  153. static const struct file_operations cuse_frontend_fops = {
  154. .owner = THIS_MODULE,
  155. .read = cuse_read,
  156. .write = cuse_write,
  157. .open = cuse_open,
  158. .release = cuse_release,
  159. .unlocked_ioctl = cuse_file_ioctl,
  160. .compat_ioctl = cuse_file_compat_ioctl,
  161. .poll = fuse_file_poll,
  162. .llseek = noop_llseek,
  163. };
  164. /**************************************************************************
  165. * CUSE channel initialization and destruction
  166. */
  167. struct cuse_devinfo {
  168. const char *name;
  169. };
  170. /**
  171. * cuse_parse_one - parse one key=value pair
  172. * @pp: i/o parameter for the current position
  173. * @end: points to one past the end of the packed string
  174. * @keyp: out parameter for key
  175. * @valp: out parameter for value
  176. *
  177. * *@pp points to packed strings - "key0=val0\0key1=val1\0" which ends
  178. * at @end - 1. This function parses one pair and set *@keyp to the
  179. * start of the key and *@valp to the start of the value. Note that
  180. * the original string is modified such that the key string is
  181. * terminated with '\0'. *@pp is updated to point to the next string.
  182. *
  183. * RETURNS:
  184. * 1 on successful parse, 0 on EOF, -errno on failure.
  185. */
  186. static int cuse_parse_one(char **pp, char *end, char **keyp, char **valp)
  187. {
  188. char *p = *pp;
  189. char *key, *val;
  190. while (p < end && *p == '\0')
  191. p++;
  192. if (p == end)
  193. return 0;
  194. if (end[-1] != '\0') {
  195. printk(KERN_ERR "CUSE: info not properly terminated\n");
  196. return -EINVAL;
  197. }
  198. key = val = p;
  199. p += strlen(p);
  200. if (valp) {
  201. strsep(&val, "=");
  202. if (!val)
  203. val = key + strlen(key);
  204. key = strstrip(key);
  205. val = strstrip(val);
  206. } else
  207. key = strstrip(key);
  208. if (!strlen(key)) {
  209. printk(KERN_ERR "CUSE: zero length info key specified\n");
  210. return -EINVAL;
  211. }
  212. *pp = p;
  213. *keyp = key;
  214. if (valp)
  215. *valp = val;
  216. return 1;
  217. }
  218. /**
  219. * cuse_parse_dev_info - parse device info
  220. * @p: device info string
  221. * @len: length of device info string
  222. * @devinfo: out parameter for parsed device info
  223. *
  224. * Parse @p to extract device info and store it into @devinfo. String
  225. * pointed to by @p is modified by parsing and @devinfo points into
  226. * them, so @p shouldn't be freed while @devinfo is in use.
  227. *
  228. * RETURNS:
  229. * 0 on success, -errno on failure.
  230. */
  231. static int cuse_parse_devinfo(char *p, size_t len, struct cuse_devinfo *devinfo)
  232. {
  233. char *end = p + len;
  234. char *uninitialized_var(key), *uninitialized_var(val);
  235. int rc;
  236. while (true) {
  237. rc = cuse_parse_one(&p, end, &key, &val);
  238. if (rc < 0)
  239. return rc;
  240. if (!rc)
  241. break;
  242. if (strcmp(key, "DEVNAME") == 0)
  243. devinfo->name = val;
  244. else
  245. printk(KERN_WARNING "CUSE: unknown device info \"%s\"\n",
  246. key);
  247. }
  248. if (!devinfo->name || !strlen(devinfo->name)) {
  249. printk(KERN_ERR "CUSE: DEVNAME unspecified\n");
  250. return -EINVAL;
  251. }
  252. return 0;
  253. }
  254. static void cuse_gendev_release(struct device *dev)
  255. {
  256. kfree(dev);
  257. }
  258. /**
  259. * cuse_process_init_reply - finish initializing CUSE channel
  260. *
  261. * This function creates the character device and sets up all the
  262. * required data structures for it. Please read the comment at the
  263. * top of this file for high level overview.
  264. */
  265. static void cuse_process_init_reply(struct fuse_conn *fc, struct fuse_req *req)
  266. {
  267. struct cuse_conn *cc = fc_to_cc(fc), *pos;
  268. struct cuse_init_out *arg = req->out.args[0].value;
  269. struct page *page = req->pages[0];
  270. struct cuse_devinfo devinfo = { };
  271. struct device *dev;
  272. struct cdev *cdev;
  273. dev_t devt;
  274. int rc, i;
  275. if (req->out.h.error ||
  276. arg->major != FUSE_KERNEL_VERSION || arg->minor < 11) {
  277. goto err;
  278. }
  279. fc->minor = arg->minor;
  280. fc->max_read = max_t(unsigned, arg->max_read, 4096);
  281. fc->max_write = max_t(unsigned, arg->max_write, 4096);
  282. /* parse init reply */
  283. cc->unrestricted_ioctl = arg->flags & CUSE_UNRESTRICTED_IOCTL;
  284. rc = cuse_parse_devinfo(page_address(page), req->out.args[1].size,
  285. &devinfo);
  286. if (rc)
  287. goto err;
  288. /* determine and reserve devt */
  289. devt = MKDEV(arg->dev_major, arg->dev_minor);
  290. if (!MAJOR(devt))
  291. rc = alloc_chrdev_region(&devt, MINOR(devt), 1, devinfo.name);
  292. else
  293. rc = register_chrdev_region(devt, 1, devinfo.name);
  294. if (rc) {
  295. printk(KERN_ERR "CUSE: failed to register chrdev region\n");
  296. goto err;
  297. }
  298. /* devt determined, create device */
  299. rc = -ENOMEM;
  300. dev = kzalloc(sizeof(*dev), GFP_KERNEL);
  301. if (!dev)
  302. goto err_region;
  303. device_initialize(dev);
  304. dev_set_uevent_suppress(dev, 1);
  305. dev->class = cuse_class;
  306. dev->devt = devt;
  307. dev->release = cuse_gendev_release;
  308. dev_set_drvdata(dev, cc);
  309. dev_set_name(dev, "%s", devinfo.name);
  310. mutex_lock(&cuse_lock);
  311. /* make sure the device-name is unique */
  312. for (i = 0; i < CUSE_CONNTBL_LEN; ++i) {
  313. list_for_each_entry(pos, &cuse_conntbl[i], list)
  314. if (!strcmp(dev_name(pos->dev), dev_name(dev)))
  315. goto err_unlock;
  316. }
  317. rc = device_add(dev);
  318. if (rc)
  319. goto err_unlock;
  320. /* register cdev */
  321. rc = -ENOMEM;
  322. cdev = cdev_alloc();
  323. if (!cdev)
  324. goto err_unlock;
  325. cdev->owner = THIS_MODULE;
  326. cdev->ops = &cuse_frontend_fops;
  327. rc = cdev_add(cdev, devt, 1);
  328. if (rc)
  329. goto err_cdev;
  330. cc->dev = dev;
  331. cc->cdev = cdev;
  332. /* make the device available */
  333. list_add(&cc->list, cuse_conntbl_head(devt));
  334. mutex_unlock(&cuse_lock);
  335. /* announce device availability */
  336. dev_set_uevent_suppress(dev, 0);
  337. kobject_uevent(&dev->kobj, KOBJ_ADD);
  338. out:
  339. kfree(arg);
  340. __free_page(page);
  341. return;
  342. err_cdev:
  343. cdev_del(cdev);
  344. err_unlock:
  345. mutex_unlock(&cuse_lock);
  346. put_device(dev);
  347. err_region:
  348. unregister_chrdev_region(devt, 1);
  349. err:
  350. fuse_conn_kill(fc);
  351. goto out;
  352. }
  353. static int cuse_send_init(struct cuse_conn *cc)
  354. {
  355. int rc;
  356. struct fuse_req *req;
  357. struct page *page;
  358. struct fuse_conn *fc = &cc->fc;
  359. struct cuse_init_in *arg;
  360. void *outarg;
  361. BUILD_BUG_ON(CUSE_INIT_INFO_MAX > PAGE_SIZE);
  362. req = fuse_get_req_for_background(fc, 1);
  363. if (IS_ERR(req)) {
  364. rc = PTR_ERR(req);
  365. goto err;
  366. }
  367. rc = -ENOMEM;
  368. page = alloc_page(GFP_KERNEL | __GFP_ZERO);
  369. if (!page)
  370. goto err_put_req;
  371. outarg = kzalloc(sizeof(struct cuse_init_out), GFP_KERNEL);
  372. if (!outarg)
  373. goto err_free_page;
  374. arg = &req->misc.cuse_init_in;
  375. arg->major = FUSE_KERNEL_VERSION;
  376. arg->minor = FUSE_KERNEL_MINOR_VERSION;
  377. arg->flags |= CUSE_UNRESTRICTED_IOCTL;
  378. req->in.h.opcode = CUSE_INIT;
  379. req->in.numargs = 1;
  380. req->in.args[0].size = sizeof(struct cuse_init_in);
  381. req->in.args[0].value = arg;
  382. req->out.numargs = 2;
  383. req->out.args[0].size = sizeof(struct cuse_init_out);
  384. req->out.args[0].value = outarg;
  385. req->out.args[1].size = CUSE_INIT_INFO_MAX;
  386. req->out.argvar = 1;
  387. req->out.argpages = 1;
  388. req->pages[0] = page;
  389. req->page_descs[0].length = req->out.args[1].size;
  390. req->num_pages = 1;
  391. req->end = cuse_process_init_reply;
  392. fuse_request_send_background(fc, req);
  393. return 0;
  394. err_free_page:
  395. __free_page(page);
  396. err_put_req:
  397. fuse_put_request(fc, req);
  398. err:
  399. return rc;
  400. }
  401. static void cuse_fc_release(struct fuse_conn *fc)
  402. {
  403. struct cuse_conn *cc = fc_to_cc(fc);
  404. kfree(cc);
  405. }
  406. /**
  407. * cuse_channel_open - open method for /dev/cuse
  408. * @inode: inode for /dev/cuse
  409. * @file: file struct being opened
  410. *
  411. * Userland CUSE server can create a CUSE device by opening /dev/cuse
  412. * and replying to the initialization request kernel sends. This
  413. * function is responsible for handling CUSE device initialization.
  414. * Because the fd opened by this function is used during
  415. * initialization, this function only creates cuse_conn and sends
  416. * init. The rest is delegated to a kthread.
  417. *
  418. * RETURNS:
  419. * 0 on success, -errno on failure.
  420. */
  421. static int cuse_channel_open(struct inode *inode, struct file *file)
  422. {
  423. struct cuse_conn *cc;
  424. int rc;
  425. /* set up cuse_conn */
  426. cc = kzalloc(sizeof(*cc), GFP_KERNEL);
  427. if (!cc)
  428. return -ENOMEM;
  429. fuse_conn_init(&cc->fc);
  430. INIT_LIST_HEAD(&cc->list);
  431. cc->fc.release = cuse_fc_release;
  432. cc->fc.connected = 1;
  433. cc->fc.initialized = 1;
  434. rc = cuse_send_init(cc);
  435. if (rc) {
  436. fuse_conn_put(&cc->fc);
  437. return rc;
  438. }
  439. file->private_data = &cc->fc; /* channel owns base reference to cc */
  440. return 0;
  441. }
  442. /**
  443. * cuse_channel_release - release method for /dev/cuse
  444. * @inode: inode for /dev/cuse
  445. * @file: file struct being closed
  446. *
  447. * Disconnect the channel, deregister CUSE device and initiate
  448. * destruction by putting the default reference.
  449. *
  450. * RETURNS:
  451. * 0 on success, -errno on failure.
  452. */
  453. static int cuse_channel_release(struct inode *inode, struct file *file)
  454. {
  455. struct cuse_conn *cc = fc_to_cc(file->private_data);
  456. int rc;
  457. /* remove from the conntbl, no more access from this point on */
  458. mutex_lock(&cuse_lock);
  459. list_del_init(&cc->list);
  460. mutex_unlock(&cuse_lock);
  461. /* remove device */
  462. if (cc->dev)
  463. device_unregister(cc->dev);
  464. if (cc->cdev) {
  465. unregister_chrdev_region(cc->cdev->dev, 1);
  466. cdev_del(cc->cdev);
  467. }
  468. rc = fuse_dev_release(inode, file); /* puts the base reference */
  469. return rc;
  470. }
  471. static struct file_operations cuse_channel_fops; /* initialized during init */
  472. /**************************************************************************
  473. * Misc stuff and module initializatiion
  474. *
  475. * CUSE exports the same set of attributes to sysfs as fusectl.
  476. */
  477. static ssize_t cuse_class_waiting_show(struct device *dev,
  478. struct device_attribute *attr, char *buf)
  479. {
  480. struct cuse_conn *cc = dev_get_drvdata(dev);
  481. return sprintf(buf, "%d\n", atomic_read(&cc->fc.num_waiting));
  482. }
  483. static ssize_t cuse_class_abort_store(struct device *dev,
  484. struct device_attribute *attr,
  485. const char *buf, size_t count)
  486. {
  487. struct cuse_conn *cc = dev_get_drvdata(dev);
  488. fuse_abort_conn(&cc->fc);
  489. return count;
  490. }
  491. static struct device_attribute cuse_class_dev_attrs[] = {
  492. __ATTR(waiting, S_IFREG | 0400, cuse_class_waiting_show, NULL),
  493. __ATTR(abort, S_IFREG | 0200, NULL, cuse_class_abort_store),
  494. { }
  495. };
  496. static struct miscdevice cuse_miscdev = {
  497. .minor = MISC_DYNAMIC_MINOR,
  498. .name = "cuse",
  499. .fops = &cuse_channel_fops,
  500. };
  501. static int __init cuse_init(void)
  502. {
  503. int i, rc;
  504. /* init conntbl */
  505. for (i = 0; i < CUSE_CONNTBL_LEN; i++)
  506. INIT_LIST_HEAD(&cuse_conntbl[i]);
  507. /* inherit and extend fuse_dev_operations */
  508. cuse_channel_fops = fuse_dev_operations;
  509. cuse_channel_fops.owner = THIS_MODULE;
  510. cuse_channel_fops.open = cuse_channel_open;
  511. cuse_channel_fops.release = cuse_channel_release;
  512. cuse_class = class_create(THIS_MODULE, "cuse");
  513. if (IS_ERR(cuse_class))
  514. return PTR_ERR(cuse_class);
  515. cuse_class->dev_attrs = cuse_class_dev_attrs;
  516. rc = misc_register(&cuse_miscdev);
  517. if (rc) {
  518. class_destroy(cuse_class);
  519. return rc;
  520. }
  521. return 0;
  522. }
  523. static void __exit cuse_exit(void)
  524. {
  525. misc_deregister(&cuse_miscdev);
  526. class_destroy(cuse_class);
  527. }
  528. module_init(cuse_init);
  529. module_exit(cuse_exit);
  530. MODULE_AUTHOR("Tejun Heo <tj@kernel.org>");
  531. MODULE_DESCRIPTION("Character device in Userspace");
  532. MODULE_LICENSE("GPL");