1 #ifndef _LINUX_FS_NOTIFY_H
2 #define _LINUX_FS_NOTIFY_H
5 * include/linux/fsnotify.h - generic hooks for filesystem notification, to
6 * reduce in-source duplication from both dnotify and inotify.
8 * We don't compile any of this away in some complicated menagerie of ifdefs.
9 * Instead, we rely on the code inside to optimize away as needed.
11 * (C) Copyright 2005 Robert Love
14 #include <linux/dnotify.h>
15 #include <linux/inotify.h>
16 #include <linux/fsnotify_backend.h>
17 #include <linux/audit.h>
20 * fsnotify_d_instantiate - instantiate a dentry for inode
21 * Called with dcache_lock held.
23 static inline void fsnotify_d_instantiate(struct dentry
*entry
,
26 __fsnotify_d_instantiate(entry
, inode
);
28 inotify_d_instantiate(entry
, inode
);
31 /* Notify this dentry's parent about a child's events. */
32 static inline void fsnotify_parent(struct dentry
*dentry
, __u32 mask
)
34 __fsnotify_parent(dentry
, mask
);
36 inotify_dentry_parent_queue_event(dentry
, mask
, 0, dentry
->d_name
.name
);
40 * fsnotify_d_move - entry has been moved
41 * Called with dcache_lock and entry->d_lock held.
43 static inline void fsnotify_d_move(struct dentry
*entry
)
46 * On move we need to update entry->d_flags to indicate if the new parent
47 * cares about events from this entry.
49 __fsnotify_update_dcache_flags(entry
);
51 inotify_d_move(entry
);
55 * fsnotify_link_count - inode's link count changed
57 static inline void fsnotify_link_count(struct inode
*inode
)
59 inotify_inode_queue_event(inode
, IN_ATTRIB
, 0, NULL
, NULL
);
61 fsnotify(inode
, FS_ATTRIB
, inode
, FSNOTIFY_EVENT_INODE
, NULL
, 0);
65 * fsnotify_move - file old_name at old_dir was moved to new_name at new_dir
67 static inline void fsnotify_move(struct inode
*old_dir
, struct inode
*new_dir
,
68 const char *old_name
, const char *new_name
,
69 int isdir
, struct inode
*target
, struct dentry
*moved
)
71 struct inode
*source
= moved
->d_inode
;
72 u32 in_cookie
= inotify_get_cookie();
73 u32 fs_cookie
= fsnotify_get_cookie();
74 __u32 old_dir_mask
= 0;
75 __u32 new_dir_mask
= 0;
77 if (old_dir
== new_dir
) {
78 old_dir_mask
= FS_DN_RENAME
;
83 old_dir_mask
|= FS_IN_ISDIR
;
84 new_dir_mask
|= FS_IN_ISDIR
;
87 old_dir_mask
|= FS_MOVED_FROM
;
88 new_dir_mask
|= FS_MOVED_TO
;
90 inotify_inode_queue_event(old_dir
, IN_MOVED_FROM
|isdir
, in_cookie
, old_name
,
92 inotify_inode_queue_event(new_dir
, IN_MOVED_TO
|isdir
, in_cookie
, new_name
,
95 fsnotify(old_dir
, old_dir_mask
, old_dir
, FSNOTIFY_EVENT_INODE
, old_name
, fs_cookie
);
96 fsnotify(new_dir
, new_dir_mask
, new_dir
, FSNOTIFY_EVENT_INODE
, new_name
, fs_cookie
);
99 inotify_inode_queue_event(target
, IN_DELETE_SELF
, 0, NULL
, NULL
);
100 inotify_inode_is_dead(target
);
102 /* this is really a link_count change not a removal */
103 fsnotify_link_count(target
);
107 inotify_inode_queue_event(source
, IN_MOVE_SELF
, 0, NULL
, NULL
);
108 fsnotify(source
, FS_MOVE_SELF
, moved
->d_inode
, FSNOTIFY_EVENT_INODE
, NULL
, 0);
110 audit_inode_child(new_name
, moved
, new_dir
);
114 * fsnotify_inode_delete - and inode is being evicted from cache, clean up is needed
116 static inline void fsnotify_inode_delete(struct inode
*inode
)
118 __fsnotify_inode_delete(inode
);
122 * fsnotify_nameremove - a filename was removed from a directory
124 static inline void fsnotify_nameremove(struct dentry
*dentry
, int isdir
)
126 __u32 mask
= FS_DELETE
;
131 fsnotify_parent(dentry
, mask
);
135 * fsnotify_inoderemove - an inode is going away
137 static inline void fsnotify_inoderemove(struct inode
*inode
)
139 inotify_inode_queue_event(inode
, IN_DELETE_SELF
, 0, NULL
, NULL
);
140 inotify_inode_is_dead(inode
);
142 fsnotify(inode
, FS_DELETE_SELF
, inode
, FSNOTIFY_EVENT_INODE
, NULL
, 0);
143 __fsnotify_inode_delete(inode
);
147 * fsnotify_create - 'name' was linked in
149 static inline void fsnotify_create(struct inode
*inode
, struct dentry
*dentry
)
151 inotify_inode_queue_event(inode
, IN_CREATE
, 0, dentry
->d_name
.name
,
153 audit_inode_child(dentry
->d_name
.name
, dentry
, inode
);
155 fsnotify(inode
, FS_CREATE
, dentry
->d_inode
, FSNOTIFY_EVENT_INODE
, dentry
->d_name
.name
, 0);
159 * fsnotify_link - new hardlink in 'inode' directory
160 * Note: We have to pass also the linked inode ptr as some filesystems leave
161 * new_dentry->d_inode NULL and instantiate inode pointer later
163 static inline void fsnotify_link(struct inode
*dir
, struct inode
*inode
, struct dentry
*new_dentry
)
165 inotify_inode_queue_event(dir
, IN_CREATE
, 0, new_dentry
->d_name
.name
,
167 fsnotify_link_count(inode
);
168 audit_inode_child(new_dentry
->d_name
.name
, new_dentry
, dir
);
170 fsnotify(dir
, FS_CREATE
, inode
, FSNOTIFY_EVENT_INODE
, new_dentry
->d_name
.name
, 0);
174 * fsnotify_mkdir - directory 'name' was created
176 static inline void fsnotify_mkdir(struct inode
*inode
, struct dentry
*dentry
)
178 __u32 mask
= (FS_CREATE
| FS_IN_ISDIR
);
179 struct inode
*d_inode
= dentry
->d_inode
;
181 inotify_inode_queue_event(inode
, mask
, 0, dentry
->d_name
.name
, d_inode
);
182 audit_inode_child(dentry
->d_name
.name
, dentry
, inode
);
184 fsnotify(inode
, mask
, d_inode
, FSNOTIFY_EVENT_INODE
, dentry
->d_name
.name
, 0);
188 * fsnotify_access - file was read
190 static inline void fsnotify_access(struct dentry
*dentry
)
192 struct inode
*inode
= dentry
->d_inode
;
193 __u32 mask
= FS_ACCESS
;
195 if (S_ISDIR(inode
->i_mode
))
198 inotify_inode_queue_event(inode
, mask
, 0, NULL
, NULL
);
200 fsnotify_parent(dentry
, mask
);
201 fsnotify(inode
, mask
, inode
, FSNOTIFY_EVENT_INODE
, NULL
, 0);
205 * fsnotify_modify - file was modified
207 static inline void fsnotify_modify(struct dentry
*dentry
)
209 struct inode
*inode
= dentry
->d_inode
;
210 __u32 mask
= FS_MODIFY
;
212 if (S_ISDIR(inode
->i_mode
))
215 inotify_inode_queue_event(inode
, mask
, 0, NULL
, NULL
);
217 fsnotify_parent(dentry
, mask
);
218 fsnotify(inode
, mask
, inode
, FSNOTIFY_EVENT_INODE
, NULL
, 0);
222 * fsnotify_open - file was opened
224 static inline void fsnotify_open(struct dentry
*dentry
)
226 struct inode
*inode
= dentry
->d_inode
;
227 __u32 mask
= FS_OPEN
;
229 if (S_ISDIR(inode
->i_mode
))
232 inotify_inode_queue_event(inode
, mask
, 0, NULL
, NULL
);
234 fsnotify_parent(dentry
, mask
);
235 fsnotify(inode
, mask
, inode
, FSNOTIFY_EVENT_INODE
, NULL
, 0);
239 * fsnotify_close - file was closed
241 static inline void fsnotify_close(struct file
*file
)
243 struct dentry
*dentry
= file
->f_path
.dentry
;
244 struct inode
*inode
= dentry
->d_inode
;
245 fmode_t mode
= file
->f_mode
;
246 __u32 mask
= (mode
& FMODE_WRITE
) ? FS_CLOSE_WRITE
: FS_CLOSE_NOWRITE
;
248 if (S_ISDIR(inode
->i_mode
))
251 inotify_inode_queue_event(inode
, mask
, 0, NULL
, NULL
);
253 fsnotify_parent(dentry
, mask
);
254 fsnotify(inode
, mask
, file
, FSNOTIFY_EVENT_FILE
, NULL
, 0);
258 * fsnotify_xattr - extended attributes were changed
260 static inline void fsnotify_xattr(struct dentry
*dentry
)
262 struct inode
*inode
= dentry
->d_inode
;
263 __u32 mask
= FS_ATTRIB
;
265 if (S_ISDIR(inode
->i_mode
))
268 inotify_inode_queue_event(inode
, mask
, 0, NULL
, NULL
);
270 fsnotify_parent(dentry
, mask
);
271 fsnotify(inode
, mask
, inode
, FSNOTIFY_EVENT_INODE
, NULL
, 0);
275 * fsnotify_change - notify_change event. file was modified and/or metadata
278 static inline void fsnotify_change(struct dentry
*dentry
, unsigned int ia_valid
)
280 struct inode
*inode
= dentry
->d_inode
;
283 if (ia_valid
& ATTR_UID
)
285 if (ia_valid
& ATTR_GID
)
287 if (ia_valid
& ATTR_SIZE
)
290 /* both times implies a utime(s) call */
291 if ((ia_valid
& (ATTR_ATIME
| ATTR_MTIME
)) == (ATTR_ATIME
| ATTR_MTIME
))
293 else if (ia_valid
& ATTR_ATIME
)
295 else if (ia_valid
& ATTR_MTIME
)
298 if (ia_valid
& ATTR_MODE
)
302 if (S_ISDIR(inode
->i_mode
))
304 inotify_inode_queue_event(inode
, mask
, 0, NULL
, NULL
);
306 fsnotify_parent(dentry
, mask
);
307 fsnotify(inode
, mask
, inode
, FSNOTIFY_EVENT_INODE
, NULL
, 0);
311 #if defined(CONFIG_INOTIFY) || defined(CONFIG_FSNOTIFY) /* notify helpers */
314 * fsnotify_oldname_init - save off the old filename before we change it
316 static inline const char *fsnotify_oldname_init(const char *name
)
318 return kstrdup(name
, GFP_KERNEL
);
322 * fsnotify_oldname_free - free the name we got from fsnotify_oldname_init
324 static inline void fsnotify_oldname_free(const char *old_name
)
329 #else /* CONFIG_INOTIFY || CONFIG_FSNOTIFY */
331 static inline const char *fsnotify_oldname_init(const char *name
)
336 static inline void fsnotify_oldname_free(const char *old_name
)
340 #endif /* ! CONFIG_INOTIFY */
342 #endif /* _LINUX_FS_NOTIFY_H */