miscdev.c 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557
  1. /**
  2. * eCryptfs: Linux filesystem encryption layer
  3. *
  4. * Copyright (C) 2008 International Business Machines Corp.
  5. * Author(s): Michael A. Halcrow <mhalcrow@us.ibm.com>
  6. *
  7. * This program is free software; you can redistribute it and/or
  8. * modify it under the terms of the GNU General Public License version
  9. * 2 as published by the Free Software Foundation.
  10. *
  11. * This program is distributed in the hope that it will be useful, but
  12. * WITHOUT ANY WARRANTY; without even the implied warranty of
  13. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  14. * General Public License for more details.
  15. *
  16. * You should have received a copy of the GNU General Public License
  17. * along with this program; if not, write to the Free Software
  18. * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
  19. * 02111-1307, USA.
  20. */
  21. #include <linux/fs.h>
  22. #include <linux/hash.h>
  23. #include <linux/random.h>
  24. #include <linux/miscdevice.h>
  25. #include <linux/poll.h>
  26. #include <linux/slab.h>
  27. #include <linux/wait.h>
  28. #include <linux/module.h>
  29. #include "ecryptfs_kernel.h"
  30. static atomic_t ecryptfs_num_miscdev_opens;
  31. /**
  32. * ecryptfs_miscdev_poll
  33. * @file: dev file (ignored)
  34. * @pt: dev poll table (ignored)
  35. *
  36. * Returns the poll mask
  37. */
  38. static unsigned int
  39. ecryptfs_miscdev_poll(struct file *file, poll_table *pt)
  40. {
  41. struct ecryptfs_daemon *daemon;
  42. unsigned int mask = 0;
  43. uid_t euid = current_euid();
  44. int rc;
  45. mutex_lock(&ecryptfs_daemon_hash_mux);
  46. /* TODO: Just use file->private_data? */
  47. rc = ecryptfs_find_daemon_by_euid(&daemon, euid, current_user_ns());
  48. BUG_ON(rc || !daemon);
  49. mutex_lock(&daemon->mux);
  50. mutex_unlock(&ecryptfs_daemon_hash_mux);
  51. if (daemon->flags & ECRYPTFS_DAEMON_ZOMBIE) {
  52. printk(KERN_WARNING "%s: Attempt to poll on zombified "
  53. "daemon\n", __func__);
  54. goto out_unlock_daemon;
  55. }
  56. if (daemon->flags & ECRYPTFS_DAEMON_IN_READ)
  57. goto out_unlock_daemon;
  58. if (daemon->flags & ECRYPTFS_DAEMON_IN_POLL)
  59. goto out_unlock_daemon;
  60. daemon->flags |= ECRYPTFS_DAEMON_IN_POLL;
  61. mutex_unlock(&daemon->mux);
  62. poll_wait(file, &daemon->wait, pt);
  63. mutex_lock(&daemon->mux);
  64. if (!list_empty(&daemon->msg_ctx_out_queue))
  65. mask |= POLLIN | POLLRDNORM;
  66. out_unlock_daemon:
  67. daemon->flags &= ~ECRYPTFS_DAEMON_IN_POLL;
  68. mutex_unlock(&daemon->mux);
  69. return mask;
  70. }
  71. /**
  72. * ecryptfs_miscdev_open
  73. * @inode: inode of miscdev handle (ignored)
  74. * @file: file for miscdev handle (ignored)
  75. *
  76. * Returns zero on success; non-zero otherwise
  77. */
  78. static int
  79. ecryptfs_miscdev_open(struct inode *inode, struct file *file)
  80. {
  81. struct ecryptfs_daemon *daemon = NULL;
  82. uid_t euid = current_euid();
  83. int rc;
  84. mutex_lock(&ecryptfs_daemon_hash_mux);
  85. rc = try_module_get(THIS_MODULE);
  86. if (rc == 0) {
  87. rc = -EIO;
  88. printk(KERN_ERR "%s: Error attempting to increment module use "
  89. "count; rc = [%d]\n", __func__, rc);
  90. goto out_unlock_daemon_list;
  91. }
  92. rc = ecryptfs_find_daemon_by_euid(&daemon, euid, current_user_ns());
  93. if (rc || !daemon) {
  94. rc = ecryptfs_spawn_daemon(&daemon, euid, current_user_ns(),
  95. task_pid(current));
  96. if (rc) {
  97. printk(KERN_ERR "%s: Error attempting to spawn daemon; "
  98. "rc = [%d]\n", __func__, rc);
  99. goto out_module_put_unlock_daemon_list;
  100. }
  101. }
  102. mutex_lock(&daemon->mux);
  103. if (daemon->pid != task_pid(current)) {
  104. rc = -EINVAL;
  105. printk(KERN_ERR "%s: pid [0x%p] has registered with euid [%d], "
  106. "but pid [0x%p] has attempted to open the handle "
  107. "instead\n", __func__, daemon->pid, daemon->euid,
  108. task_pid(current));
  109. goto out_unlock_daemon;
  110. }
  111. if (daemon->flags & ECRYPTFS_DAEMON_MISCDEV_OPEN) {
  112. rc = -EBUSY;
  113. printk(KERN_ERR "%s: Miscellaneous device handle may only be "
  114. "opened once per daemon; pid [0x%p] already has this "
  115. "handle open\n", __func__, daemon->pid);
  116. goto out_unlock_daemon;
  117. }
  118. daemon->flags |= ECRYPTFS_DAEMON_MISCDEV_OPEN;
  119. atomic_inc(&ecryptfs_num_miscdev_opens);
  120. out_unlock_daemon:
  121. mutex_unlock(&daemon->mux);
  122. out_module_put_unlock_daemon_list:
  123. if (rc)
  124. module_put(THIS_MODULE);
  125. out_unlock_daemon_list:
  126. mutex_unlock(&ecryptfs_daemon_hash_mux);
  127. return rc;
  128. }
  129. /**
  130. * ecryptfs_miscdev_release
  131. * @inode: inode of fs/ecryptfs/euid handle (ignored)
  132. * @file: file for fs/ecryptfs/euid handle (ignored)
  133. *
  134. * This keeps the daemon registered until the daemon sends another
  135. * ioctl to fs/ecryptfs/ctl or until the kernel module unregisters.
  136. *
  137. * Returns zero on success; non-zero otherwise
  138. */
  139. static int
  140. ecryptfs_miscdev_release(struct inode *inode, struct file *file)
  141. {
  142. struct ecryptfs_daemon *daemon = NULL;
  143. uid_t euid = current_euid();
  144. int rc;
  145. mutex_lock(&ecryptfs_daemon_hash_mux);
  146. rc = ecryptfs_find_daemon_by_euid(&daemon, euid, current_user_ns());
  147. BUG_ON(rc || !daemon);
  148. mutex_lock(&daemon->mux);
  149. BUG_ON(daemon->pid != task_pid(current));
  150. BUG_ON(!(daemon->flags & ECRYPTFS_DAEMON_MISCDEV_OPEN));
  151. daemon->flags &= ~ECRYPTFS_DAEMON_MISCDEV_OPEN;
  152. atomic_dec(&ecryptfs_num_miscdev_opens);
  153. mutex_unlock(&daemon->mux);
  154. rc = ecryptfs_exorcise_daemon(daemon);
  155. if (rc) {
  156. printk(KERN_CRIT "%s: Fatal error whilst attempting to "
  157. "shut down daemon; rc = [%d]. Please report this "
  158. "bug.\n", __func__, rc);
  159. BUG();
  160. }
  161. module_put(THIS_MODULE);
  162. mutex_unlock(&ecryptfs_daemon_hash_mux);
  163. return rc;
  164. }
  165. /**
  166. * ecryptfs_send_miscdev
  167. * @data: Data to send to daemon; may be NULL
  168. * @data_size: Amount of data to send to daemon
  169. * @msg_ctx: Message context, which is used to handle the reply. If
  170. * this is NULL, then we do not expect a reply.
  171. * @msg_type: Type of message
  172. * @msg_flags: Flags for message
  173. * @daemon: eCryptfs daemon object
  174. *
  175. * Add msg_ctx to queue and then, if it exists, notify the blocked
  176. * miscdevess about the data being available. Must be called with
  177. * ecryptfs_daemon_hash_mux held.
  178. *
  179. * Returns zero on success; non-zero otherwise
  180. */
  181. int ecryptfs_send_miscdev(char *data, size_t data_size,
  182. struct ecryptfs_msg_ctx *msg_ctx, u8 msg_type,
  183. u16 msg_flags, struct ecryptfs_daemon *daemon)
  184. {
  185. int rc = 0;
  186. mutex_lock(&msg_ctx->mux);
  187. msg_ctx->msg = kmalloc((sizeof(*msg_ctx->msg) + data_size),
  188. GFP_KERNEL);
  189. if (!msg_ctx->msg) {
  190. rc = -ENOMEM;
  191. printk(KERN_ERR "%s: Out of memory whilst attempting "
  192. "to kmalloc(%zd, GFP_KERNEL)\n", __func__,
  193. (sizeof(*msg_ctx->msg) + data_size));
  194. goto out_unlock;
  195. }
  196. msg_ctx->msg->index = msg_ctx->index;
  197. msg_ctx->msg->data_len = data_size;
  198. msg_ctx->type = msg_type;
  199. memcpy(msg_ctx->msg->data, data, data_size);
  200. msg_ctx->msg_size = (sizeof(*msg_ctx->msg) + data_size);
  201. mutex_lock(&daemon->mux);
  202. list_add_tail(&msg_ctx->daemon_out_list, &daemon->msg_ctx_out_queue);
  203. daemon->num_queued_msg_ctx++;
  204. wake_up_interruptible(&daemon->wait);
  205. mutex_unlock(&daemon->mux);
  206. out_unlock:
  207. mutex_unlock(&msg_ctx->mux);
  208. return rc;
  209. }
  210. /*
  211. * miscdevfs packet format:
  212. * Octet 0: Type
  213. * Octets 1-4: network byte order msg_ctx->counter
  214. * Octets 5-N0: Size of struct ecryptfs_message to follow
  215. * Octets N0-N1: struct ecryptfs_message (including data)
  216. *
  217. * Octets 5-N1 not written if the packet type does not include a message
  218. */
  219. #define PKT_TYPE_SIZE 1
  220. #define PKT_CTR_SIZE 4
  221. #define MIN_NON_MSG_PKT_SIZE (PKT_TYPE_SIZE + PKT_CTR_SIZE)
  222. #define MIN_MSG_PKT_SIZE (PKT_TYPE_SIZE + PKT_CTR_SIZE \
  223. + ECRYPTFS_MIN_PKT_LEN_SIZE)
  224. /* 4 + ECRYPTFS_MAX_ENCRYPTED_KEY_BYTES comes from tag 65 packet format */
  225. #define MAX_MSG_PKT_SIZE (PKT_TYPE_SIZE + PKT_CTR_SIZE \
  226. + ECRYPTFS_MAX_PKT_LEN_SIZE \
  227. + sizeof(struct ecryptfs_message) \
  228. + 4 + ECRYPTFS_MAX_ENCRYPTED_KEY_BYTES)
  229. #define PKT_TYPE_OFFSET 0
  230. #define PKT_CTR_OFFSET PKT_TYPE_SIZE
  231. #define PKT_LEN_OFFSET (PKT_TYPE_SIZE + PKT_CTR_SIZE)
  232. /**
  233. * ecryptfs_miscdev_read - format and send message from queue
  234. * @file: fs/ecryptfs/euid miscdevfs handle (ignored)
  235. * @buf: User buffer into which to copy the next message on the daemon queue
  236. * @count: Amount of space available in @buf
  237. * @ppos: Offset in file (ignored)
  238. *
  239. * Pulls the most recent message from the daemon queue, formats it for
  240. * being sent via a miscdevfs handle, and copies it into @buf
  241. *
  242. * Returns the number of bytes copied into the user buffer
  243. */
  244. static ssize_t
  245. ecryptfs_miscdev_read(struct file *file, char __user *buf, size_t count,
  246. loff_t *ppos)
  247. {
  248. struct ecryptfs_daemon *daemon;
  249. struct ecryptfs_msg_ctx *msg_ctx;
  250. size_t packet_length_size;
  251. char packet_length[ECRYPTFS_MAX_PKT_LEN_SIZE];
  252. size_t i;
  253. size_t total_length;
  254. uid_t euid = current_euid();
  255. int rc;
  256. mutex_lock(&ecryptfs_daemon_hash_mux);
  257. /* TODO: Just use file->private_data? */
  258. rc = ecryptfs_find_daemon_by_euid(&daemon, euid, current_user_ns());
  259. BUG_ON(rc || !daemon);
  260. mutex_lock(&daemon->mux);
  261. if (daemon->flags & ECRYPTFS_DAEMON_ZOMBIE) {
  262. rc = 0;
  263. mutex_unlock(&ecryptfs_daemon_hash_mux);
  264. printk(KERN_WARNING "%s: Attempt to read from zombified "
  265. "daemon\n", __func__);
  266. goto out_unlock_daemon;
  267. }
  268. if (daemon->flags & ECRYPTFS_DAEMON_IN_READ) {
  269. rc = 0;
  270. mutex_unlock(&ecryptfs_daemon_hash_mux);
  271. goto out_unlock_daemon;
  272. }
  273. /* This daemon will not go away so long as this flag is set */
  274. daemon->flags |= ECRYPTFS_DAEMON_IN_READ;
  275. mutex_unlock(&ecryptfs_daemon_hash_mux);
  276. check_list:
  277. if (list_empty(&daemon->msg_ctx_out_queue)) {
  278. mutex_unlock(&daemon->mux);
  279. rc = wait_event_interruptible(
  280. daemon->wait, !list_empty(&daemon->msg_ctx_out_queue));
  281. mutex_lock(&daemon->mux);
  282. if (rc < 0) {
  283. rc = 0;
  284. goto out_unlock_daemon;
  285. }
  286. }
  287. if (daemon->flags & ECRYPTFS_DAEMON_ZOMBIE) {
  288. rc = 0;
  289. goto out_unlock_daemon;
  290. }
  291. if (list_empty(&daemon->msg_ctx_out_queue)) {
  292. /* Something else jumped in since the
  293. * wait_event_interruptable() and removed the
  294. * message from the queue; try again */
  295. goto check_list;
  296. }
  297. BUG_ON(euid != daemon->euid);
  298. BUG_ON(current_user_ns() != daemon->user_ns);
  299. BUG_ON(task_pid(current) != daemon->pid);
  300. msg_ctx = list_first_entry(&daemon->msg_ctx_out_queue,
  301. struct ecryptfs_msg_ctx, daemon_out_list);
  302. BUG_ON(!msg_ctx);
  303. mutex_lock(&msg_ctx->mux);
  304. if (msg_ctx->msg) {
  305. rc = ecryptfs_write_packet_length(packet_length,
  306. msg_ctx->msg_size,
  307. &packet_length_size);
  308. if (rc) {
  309. rc = 0;
  310. printk(KERN_WARNING "%s: Error writing packet length; "
  311. "rc = [%d]\n", __func__, rc);
  312. goto out_unlock_msg_ctx;
  313. }
  314. } else {
  315. packet_length_size = 0;
  316. msg_ctx->msg_size = 0;
  317. }
  318. total_length = (PKT_TYPE_SIZE + PKT_CTR_SIZE + packet_length_size
  319. + msg_ctx->msg_size);
  320. if (count < total_length) {
  321. rc = 0;
  322. printk(KERN_WARNING "%s: Only given user buffer of "
  323. "size [%zd], but we need [%zd] to read the "
  324. "pending message\n", __func__, count, total_length);
  325. goto out_unlock_msg_ctx;
  326. }
  327. rc = -EFAULT;
  328. if (put_user(msg_ctx->type, buf))
  329. goto out_unlock_msg_ctx;
  330. if (put_user(cpu_to_be32(msg_ctx->counter),
  331. (__be32 __user *)(&buf[PKT_CTR_OFFSET])))
  332. goto out_unlock_msg_ctx;
  333. i = PKT_TYPE_SIZE + PKT_CTR_SIZE;
  334. if (msg_ctx->msg) {
  335. if (copy_to_user(&buf[i], packet_length, packet_length_size))
  336. goto out_unlock_msg_ctx;
  337. i += packet_length_size;
  338. if (copy_to_user(&buf[i], msg_ctx->msg, msg_ctx->msg_size))
  339. goto out_unlock_msg_ctx;
  340. i += msg_ctx->msg_size;
  341. }
  342. rc = i;
  343. list_del(&msg_ctx->daemon_out_list);
  344. kfree(msg_ctx->msg);
  345. msg_ctx->msg = NULL;
  346. /* We do not expect a reply from the userspace daemon for any
  347. * message type other than ECRYPTFS_MSG_REQUEST */
  348. if (msg_ctx->type != ECRYPTFS_MSG_REQUEST)
  349. ecryptfs_msg_ctx_alloc_to_free(msg_ctx);
  350. out_unlock_msg_ctx:
  351. mutex_unlock(&msg_ctx->mux);
  352. out_unlock_daemon:
  353. daemon->flags &= ~ECRYPTFS_DAEMON_IN_READ;
  354. mutex_unlock(&daemon->mux);
  355. return rc;
  356. }
  357. /**
  358. * ecryptfs_miscdev_response - miscdevess response to message previously sent to daemon
  359. * @data: Bytes comprising struct ecryptfs_message
  360. * @data_size: sizeof(struct ecryptfs_message) + data len
  361. * @euid: Effective user id of miscdevess sending the miscdev response
  362. * @user_ns: The namespace in which @euid applies
  363. * @pid: Miscdevess id of miscdevess sending the miscdev response
  364. * @seq: Sequence number for miscdev response packet
  365. *
  366. * Returns zero on success; non-zero otherwise
  367. */
  368. static int ecryptfs_miscdev_response(char *data, size_t data_size,
  369. uid_t euid, struct user_namespace *user_ns,
  370. struct pid *pid, u32 seq)
  371. {
  372. struct ecryptfs_message *msg = (struct ecryptfs_message *)data;
  373. int rc;
  374. if ((sizeof(*msg) + msg->data_len) != data_size) {
  375. printk(KERN_WARNING "%s: (sizeof(*msg) + msg->data_len) = "
  376. "[%zd]; data_size = [%zd]. Invalid packet.\n", __func__,
  377. (sizeof(*msg) + msg->data_len), data_size);
  378. rc = -EINVAL;
  379. goto out;
  380. }
  381. rc = ecryptfs_process_response(msg, euid, user_ns, pid, seq);
  382. if (rc)
  383. printk(KERN_ERR
  384. "Error processing response message; rc = [%d]\n", rc);
  385. out:
  386. return rc;
  387. }
  388. /**
  389. * ecryptfs_miscdev_write - handle write to daemon miscdev handle
  390. * @file: File for misc dev handle (ignored)
  391. * @buf: Buffer containing user data
  392. * @count: Amount of data in @buf
  393. * @ppos: Pointer to offset in file (ignored)
  394. *
  395. * Returns the number of bytes read from @buf
  396. */
  397. static ssize_t
  398. ecryptfs_miscdev_write(struct file *file, const char __user *buf,
  399. size_t count, loff_t *ppos)
  400. {
  401. __be32 counter_nbo;
  402. u32 seq;
  403. size_t packet_size, packet_size_length;
  404. char *data;
  405. uid_t euid = current_euid();
  406. unsigned char packet_size_peek[ECRYPTFS_MAX_PKT_LEN_SIZE];
  407. ssize_t rc;
  408. if (count == 0) {
  409. return 0;
  410. } else if (count == MIN_NON_MSG_PKT_SIZE) {
  411. /* Likely a harmless MSG_HELO or MSG_QUIT - no packet length */
  412. goto memdup;
  413. } else if (count < MIN_MSG_PKT_SIZE || count > MAX_MSG_PKT_SIZE) {
  414. printk(KERN_WARNING "%s: Acceptable packet size range is "
  415. "[%d-%zu], but amount of data written is [%zu].",
  416. __func__, MIN_MSG_PKT_SIZE, MAX_MSG_PKT_SIZE, count);
  417. return -EINVAL;
  418. }
  419. if (copy_from_user(packet_size_peek, &buf[PKT_LEN_OFFSET],
  420. sizeof(packet_size_peek))) {
  421. printk(KERN_WARNING "%s: Error while inspecting packet size\n",
  422. __func__);
  423. return -EFAULT;
  424. }
  425. rc = ecryptfs_parse_packet_length(packet_size_peek, &packet_size,
  426. &packet_size_length);
  427. if (rc) {
  428. printk(KERN_WARNING "%s: Error parsing packet length; "
  429. "rc = [%zd]\n", __func__, rc);
  430. return rc;
  431. }
  432. if ((PKT_TYPE_SIZE + PKT_CTR_SIZE + packet_size_length + packet_size)
  433. != count) {
  434. printk(KERN_WARNING "%s: Invalid packet size [%zu]\n", __func__,
  435. packet_size);
  436. return -EINVAL;
  437. }
  438. memdup:
  439. data = memdup_user(buf, count);
  440. if (IS_ERR(data)) {
  441. printk(KERN_ERR "%s: memdup_user returned error [%ld]\n",
  442. __func__, PTR_ERR(data));
  443. return PTR_ERR(data);
  444. }
  445. switch (data[PKT_TYPE_OFFSET]) {
  446. case ECRYPTFS_MSG_RESPONSE:
  447. if (count < (MIN_MSG_PKT_SIZE
  448. + sizeof(struct ecryptfs_message))) {
  449. printk(KERN_WARNING "%s: Minimum acceptable packet "
  450. "size is [%zd], but amount of data written is "
  451. "only [%zd]. Discarding response packet.\n",
  452. __func__,
  453. (MIN_MSG_PKT_SIZE
  454. + sizeof(struct ecryptfs_message)), count);
  455. rc = -EINVAL;
  456. goto out_free;
  457. }
  458. memcpy(&counter_nbo, &data[PKT_CTR_OFFSET], PKT_CTR_SIZE);
  459. seq = be32_to_cpu(counter_nbo);
  460. rc = ecryptfs_miscdev_response(
  461. &data[PKT_LEN_OFFSET + packet_size_length],
  462. packet_size, euid, current_user_ns(),
  463. task_pid(current), seq);
  464. if (rc) {
  465. printk(KERN_WARNING "%s: Failed to deliver miscdev "
  466. "response to requesting operation; rc = [%zd]\n",
  467. __func__, rc);
  468. goto out_free;
  469. }
  470. break;
  471. case ECRYPTFS_MSG_HELO:
  472. case ECRYPTFS_MSG_QUIT:
  473. break;
  474. default:
  475. ecryptfs_printk(KERN_WARNING, "Dropping miscdev "
  476. "message of unrecognized type [%d]\n",
  477. data[0]);
  478. rc = -EINVAL;
  479. goto out_free;
  480. }
  481. rc = count;
  482. out_free:
  483. kfree(data);
  484. return rc;
  485. }
  486. static const struct file_operations ecryptfs_miscdev_fops = {
  487. .open = ecryptfs_miscdev_open,
  488. .poll = ecryptfs_miscdev_poll,
  489. .read = ecryptfs_miscdev_read,
  490. .write = ecryptfs_miscdev_write,
  491. .release = ecryptfs_miscdev_release,
  492. .llseek = noop_llseek,
  493. };
  494. static struct miscdevice ecryptfs_miscdev = {
  495. .minor = MISC_DYNAMIC_MINOR,
  496. .name = "ecryptfs",
  497. .fops = &ecryptfs_miscdev_fops
  498. };
  499. /**
  500. * ecryptfs_init_ecryptfs_miscdev
  501. *
  502. * Messages sent to the userspace daemon from the kernel are placed on
  503. * a queue associated with the daemon. The next read against the
  504. * miscdev handle by that daemon will return the oldest message placed
  505. * on the message queue for the daemon.
  506. *
  507. * Returns zero on success; non-zero otherwise
  508. */
  509. int __init ecryptfs_init_ecryptfs_miscdev(void)
  510. {
  511. int rc;
  512. atomic_set(&ecryptfs_num_miscdev_opens, 0);
  513. rc = misc_register(&ecryptfs_miscdev);
  514. if (rc)
  515. printk(KERN_ERR "%s: Failed to register miscellaneous device "
  516. "for communications with userspace daemons; rc = [%d]\n",
  517. __func__, rc);
  518. return rc;
  519. }
  520. /**
  521. * ecryptfs_destroy_ecryptfs_miscdev
  522. *
  523. * All of the daemons must be exorcised prior to calling this
  524. * function.
  525. */
  526. void ecryptfs_destroy_ecryptfs_miscdev(void)
  527. {
  528. BUG_ON(atomic_read(&ecryptfs_num_miscdev_opens) != 0);
  529. misc_deregister(&ecryptfs_miscdev);
  530. }