dnotify.c 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412
  1. /*
  2. * Directory notifications for Linux.
  3. *
  4. * Copyright (C) 2000,2001,2002 Stephen Rothwell
  5. *
  6. * Copyright (C) 2009 Eric Paris <Red Hat Inc>
  7. * dnotify was largly rewritten to use the new fsnotify infrastructure
  8. *
  9. * This program is free software; you can redistribute it and/or modify it
  10. * under the terms of the GNU General Public License as published by the
  11. * Free Software Foundation; either version 2, or (at your option) any
  12. * later version.
  13. *
  14. * This program is distributed in the hope that it will be useful, but
  15. * WITHOUT ANY WARRANTY; without even the implied warranty of
  16. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17. * General Public License for more details.
  18. */
  19. #include <linux/fs.h>
  20. #include <linux/module.h>
  21. #include <linux/sched.h>
  22. #include <linux/dnotify.h>
  23. #include <linux/init.h>
  24. #include <linux/spinlock.h>
  25. #include <linux/slab.h>
  26. #include <linux/fdtable.h>
  27. #include <linux/fsnotify_backend.h>
  28. int dir_notify_enable __read_mostly = 1;
  29. static struct kmem_cache *dnotify_struct_cache __read_mostly;
  30. static struct kmem_cache *dnotify_mark_cache __read_mostly;
  31. static struct fsnotify_group *dnotify_group __read_mostly;
  32. static DEFINE_MUTEX(dnotify_mark_mutex);
  33. /*
  34. * dnotify will attach one of these to each inode (i_fsnotify_marks) which
  35. * is being watched by dnotify. If multiple userspace applications are watching
  36. * the same directory with dnotify their information is chained in dn
  37. */
  38. struct dnotify_mark {
  39. struct fsnotify_mark fsn_mark;
  40. struct dnotify_struct *dn;
  41. };
  42. /*
  43. * When a process starts or stops watching an inode the set of events which
  44. * dnotify cares about for that inode may change. This function runs the
  45. * list of everything receiving dnotify events about this directory and calculates
  46. * the set of all those events. After it updates what dnotify is interested in
  47. * it calls the fsnotify function so it can update the set of all events relevant
  48. * to this inode.
  49. */
  50. static void dnotify_recalc_inode_mask(struct fsnotify_mark *fsn_mark)
  51. {
  52. __u32 new_mask, old_mask;
  53. struct dnotify_struct *dn;
  54. struct dnotify_mark *dn_mark = container_of(fsn_mark,
  55. struct dnotify_mark,
  56. fsn_mark);
  57. assert_spin_locked(&fsn_mark->lock);
  58. old_mask = fsn_mark->mask;
  59. new_mask = 0;
  60. for (dn = dn_mark->dn; dn != NULL; dn = dn->dn_next)
  61. new_mask |= (dn->dn_mask & ~FS_DN_MULTISHOT);
  62. fsnotify_set_mark_mask_locked(fsn_mark, new_mask);
  63. if (old_mask == new_mask)
  64. return;
  65. if (fsn_mark->i.inode)
  66. fsnotify_recalc_inode_mask(fsn_mark->i.inode);
  67. }
  68. /*
  69. * Mains fsnotify call where events are delivered to dnotify.
  70. * Find the dnotify mark on the relevant inode, run the list of dnotify structs
  71. * on that mark and determine which of them has expressed interest in receiving
  72. * events of this type. When found send the correct process and signal and
  73. * destroy the dnotify struct if it was not registered to receive multiple
  74. * events.
  75. */
  76. static int dnotify_handle_event(struct fsnotify_group *group,
  77. struct fsnotify_mark *inode_mark,
  78. struct fsnotify_mark *vfsmount_mark,
  79. struct fsnotify_event *event)
  80. {
  81. struct dnotify_mark *dn_mark;
  82. struct inode *to_tell;
  83. struct dnotify_struct *dn;
  84. struct dnotify_struct **prev;
  85. struct fown_struct *fown;
  86. __u32 test_mask = event->mask & ~FS_EVENT_ON_CHILD;
  87. BUG_ON(vfsmount_mark);
  88. to_tell = event->to_tell;
  89. dn_mark = container_of(inode_mark, struct dnotify_mark, fsn_mark);
  90. spin_lock(&inode_mark->lock);
  91. prev = &dn_mark->dn;
  92. while ((dn = *prev) != NULL) {
  93. if ((dn->dn_mask & test_mask) == 0) {
  94. prev = &dn->dn_next;
  95. continue;
  96. }
  97. fown = &dn->dn_filp->f_owner;
  98. send_sigio(fown, dn->dn_fd, POLL_MSG);
  99. if (dn->dn_mask & FS_DN_MULTISHOT)
  100. prev = &dn->dn_next;
  101. else {
  102. *prev = dn->dn_next;
  103. kmem_cache_free(dnotify_struct_cache, dn);
  104. dnotify_recalc_inode_mask(inode_mark);
  105. }
  106. }
  107. spin_unlock(&inode_mark->lock);
  108. return 0;
  109. }
  110. /*
  111. * Given an inode and mask determine if dnotify would be interested in sending
  112. * userspace notification for that pair.
  113. */
  114. static bool dnotify_should_send_event(struct fsnotify_group *group,
  115. struct inode *inode,
  116. struct fsnotify_mark *inode_mark,
  117. struct fsnotify_mark *vfsmount_mark,
  118. __u32 mask, void *data, int data_type)
  119. {
  120. /* not a dir, dnotify doesn't care */
  121. if (!S_ISDIR(inode->i_mode))
  122. return false;
  123. return true;
  124. }
  125. static void dnotify_free_mark(struct fsnotify_mark *fsn_mark)
  126. {
  127. struct dnotify_mark *dn_mark = container_of(fsn_mark,
  128. struct dnotify_mark,
  129. fsn_mark);
  130. BUG_ON(dn_mark->dn);
  131. kmem_cache_free(dnotify_mark_cache, dn_mark);
  132. }
  133. static struct fsnotify_ops dnotify_fsnotify_ops = {
  134. .handle_event = dnotify_handle_event,
  135. .should_send_event = dnotify_should_send_event,
  136. .free_group_priv = NULL,
  137. .freeing_mark = NULL,
  138. .free_event_priv = NULL,
  139. };
  140. /*
  141. * Called every time a file is closed. Looks first for a dnotify mark on the
  142. * inode. If one is found run all of the ->dn structures attached to that
  143. * mark for one relevant to this process closing the file and remove that
  144. * dnotify_struct. If that was the last dnotify_struct also remove the
  145. * fsnotify_mark.
  146. */
  147. void dnotify_flush(struct file *filp, fl_owner_t id)
  148. {
  149. struct fsnotify_mark *fsn_mark;
  150. struct dnotify_mark *dn_mark;
  151. struct dnotify_struct *dn;
  152. struct dnotify_struct **prev;
  153. struct inode *inode;
  154. inode = filp->f_path.dentry->d_inode;
  155. if (!S_ISDIR(inode->i_mode))
  156. return;
  157. fsn_mark = fsnotify_find_inode_mark(dnotify_group, inode);
  158. if (!fsn_mark)
  159. return;
  160. dn_mark = container_of(fsn_mark, struct dnotify_mark, fsn_mark);
  161. mutex_lock(&dnotify_mark_mutex);
  162. spin_lock(&fsn_mark->lock);
  163. prev = &dn_mark->dn;
  164. while ((dn = *prev) != NULL) {
  165. if ((dn->dn_owner == id) && (dn->dn_filp == filp)) {
  166. *prev = dn->dn_next;
  167. kmem_cache_free(dnotify_struct_cache, dn);
  168. dnotify_recalc_inode_mask(fsn_mark);
  169. break;
  170. }
  171. prev = &dn->dn_next;
  172. }
  173. spin_unlock(&fsn_mark->lock);
  174. /* nothing else could have found us thanks to the dnotify_mark_mutex */
  175. if (dn_mark->dn == NULL)
  176. fsnotify_destroy_mark(fsn_mark);
  177. mutex_unlock(&dnotify_mark_mutex);
  178. fsnotify_put_mark(fsn_mark);
  179. }
  180. /* this conversion is done only at watch creation */
  181. static __u32 convert_arg(unsigned long arg)
  182. {
  183. __u32 new_mask = FS_EVENT_ON_CHILD;
  184. if (arg & DN_MULTISHOT)
  185. new_mask |= FS_DN_MULTISHOT;
  186. if (arg & DN_DELETE)
  187. new_mask |= (FS_DELETE | FS_MOVED_FROM);
  188. if (arg & DN_MODIFY)
  189. new_mask |= FS_MODIFY;
  190. if (arg & DN_ACCESS)
  191. new_mask |= FS_ACCESS;
  192. if (arg & DN_ATTRIB)
  193. new_mask |= FS_ATTRIB;
  194. if (arg & DN_RENAME)
  195. new_mask |= FS_DN_RENAME;
  196. if (arg & DN_CREATE)
  197. new_mask |= (FS_CREATE | FS_MOVED_TO);
  198. return new_mask;
  199. }
  200. /*
  201. * If multiple processes watch the same inode with dnotify there is only one
  202. * dnotify mark in inode->i_fsnotify_marks but we chain a dnotify_struct
  203. * onto that mark. This function either attaches the new dnotify_struct onto
  204. * that list, or it |= the mask onto an existing dnofiy_struct.
  205. */
  206. static int attach_dn(struct dnotify_struct *dn, struct dnotify_mark *dn_mark,
  207. fl_owner_t id, int fd, struct file *filp, __u32 mask)
  208. {
  209. struct dnotify_struct *odn;
  210. odn = dn_mark->dn;
  211. while (odn != NULL) {
  212. /* adding more events to existing dnofiy_struct? */
  213. if ((odn->dn_owner == id) && (odn->dn_filp == filp)) {
  214. odn->dn_fd = fd;
  215. odn->dn_mask |= mask;
  216. return -EEXIST;
  217. }
  218. odn = odn->dn_next;
  219. }
  220. dn->dn_mask = mask;
  221. dn->dn_fd = fd;
  222. dn->dn_filp = filp;
  223. dn->dn_owner = id;
  224. dn->dn_next = dn_mark->dn;
  225. dn_mark->dn = dn;
  226. return 0;
  227. }
  228. /*
  229. * When a process calls fcntl to attach a dnotify watch to a directory it ends
  230. * up here. Allocate both a mark for fsnotify to add and a dnotify_struct to be
  231. * attached to the fsnotify_mark.
  232. */
  233. int fcntl_dirnotify(int fd, struct file *filp, unsigned long arg)
  234. {
  235. struct dnotify_mark *new_dn_mark, *dn_mark;
  236. struct fsnotify_mark *new_fsn_mark, *fsn_mark;
  237. struct dnotify_struct *dn;
  238. struct inode *inode;
  239. fl_owner_t id = current->files;
  240. struct file *f;
  241. int destroy = 0, error = 0;
  242. __u32 mask;
  243. /* we use these to tell if we need to kfree */
  244. new_fsn_mark = NULL;
  245. dn = NULL;
  246. if (!dir_notify_enable) {
  247. error = -EINVAL;
  248. goto out_err;
  249. }
  250. /* a 0 mask means we are explicitly removing the watch */
  251. if ((arg & ~DN_MULTISHOT) == 0) {
  252. dnotify_flush(filp, id);
  253. error = 0;
  254. goto out_err;
  255. }
  256. /* dnotify only works on directories */
  257. inode = filp->f_path.dentry->d_inode;
  258. if (!S_ISDIR(inode->i_mode)) {
  259. error = -ENOTDIR;
  260. goto out_err;
  261. }
  262. /* expect most fcntl to add new rather than augment old */
  263. dn = kmem_cache_alloc(dnotify_struct_cache, GFP_KERNEL);
  264. if (!dn) {
  265. error = -ENOMEM;
  266. goto out_err;
  267. }
  268. /* new fsnotify mark, we expect most fcntl calls to add a new mark */
  269. new_dn_mark = kmem_cache_alloc(dnotify_mark_cache, GFP_KERNEL);
  270. if (!new_dn_mark) {
  271. error = -ENOMEM;
  272. goto out_err;
  273. }
  274. /* convert the userspace DN_* "arg" to the internal FS_* defines in fsnotify */
  275. mask = convert_arg(arg);
  276. /* set up the new_fsn_mark and new_dn_mark */
  277. new_fsn_mark = &new_dn_mark->fsn_mark;
  278. fsnotify_init_mark(new_fsn_mark, dnotify_free_mark);
  279. new_fsn_mark->mask = mask;
  280. new_dn_mark->dn = NULL;
  281. /* this is needed to prevent the fcntl/close race described below */
  282. mutex_lock(&dnotify_mark_mutex);
  283. /* add the new_fsn_mark or find an old one. */
  284. fsn_mark = fsnotify_find_inode_mark(dnotify_group, inode);
  285. if (fsn_mark) {
  286. dn_mark = container_of(fsn_mark, struct dnotify_mark, fsn_mark);
  287. spin_lock(&fsn_mark->lock);
  288. } else {
  289. fsnotify_add_mark(new_fsn_mark, dnotify_group, inode, NULL, 0);
  290. spin_lock(&new_fsn_mark->lock);
  291. fsn_mark = new_fsn_mark;
  292. dn_mark = new_dn_mark;
  293. /* we used new_fsn_mark, so don't free it */
  294. new_fsn_mark = NULL;
  295. }
  296. rcu_read_lock();
  297. f = fcheck(fd);
  298. rcu_read_unlock();
  299. /* if (f != filp) means that we lost a race and another task/thread
  300. * actually closed the fd we are still playing with before we grabbed
  301. * the dnotify_mark_mutex and fsn_mark->lock. Since closing the fd is the
  302. * only time we clean up the marks we need to get our mark off
  303. * the list. */
  304. if (f != filp) {
  305. /* if we added ourselves, shoot ourselves, it's possible that
  306. * the flush actually did shoot this fsn_mark. That's fine too
  307. * since multiple calls to destroy_mark is perfectly safe, if
  308. * we found a dn_mark already attached to the inode, just sod
  309. * off silently as the flush at close time dealt with it.
  310. */
  311. if (dn_mark == new_dn_mark)
  312. destroy = 1;
  313. goto out;
  314. }
  315. error = __f_setown(filp, task_pid(current), PIDTYPE_PID, 0);
  316. if (error) {
  317. /* if we added, we must shoot */
  318. if (dn_mark == new_dn_mark)
  319. destroy = 1;
  320. goto out;
  321. }
  322. error = attach_dn(dn, dn_mark, id, fd, filp, mask);
  323. /* !error means that we attached the dn to the dn_mark, so don't free it */
  324. if (!error)
  325. dn = NULL;
  326. /* -EEXIST means that we didn't add this new dn and used an old one.
  327. * that isn't an error (and the unused dn should be freed) */
  328. else if (error == -EEXIST)
  329. error = 0;
  330. dnotify_recalc_inode_mask(fsn_mark);
  331. out:
  332. spin_unlock(&fsn_mark->lock);
  333. if (destroy)
  334. fsnotify_destroy_mark(fsn_mark);
  335. mutex_unlock(&dnotify_mark_mutex);
  336. fsnotify_put_mark(fsn_mark);
  337. out_err:
  338. if (new_fsn_mark)
  339. fsnotify_put_mark(new_fsn_mark);
  340. if (dn)
  341. kmem_cache_free(dnotify_struct_cache, dn);
  342. return error;
  343. }
  344. static int __init dnotify_init(void)
  345. {
  346. dnotify_struct_cache = KMEM_CACHE(dnotify_struct, SLAB_PANIC);
  347. dnotify_mark_cache = KMEM_CACHE(dnotify_mark, SLAB_PANIC);
  348. dnotify_group = fsnotify_alloc_group(&dnotify_fsnotify_ops);
  349. if (IS_ERR(dnotify_group))
  350. panic("unable to allocate fsnotify group for dnotify\n");
  351. return 0;
  352. }
  353. module_init(dnotify_init)