cuse.c 15 KB

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