Release 4.7 include/linux/fsnotify.h

Directory: include/linux
#ifndef _LINUX_FS_NOTIFY_H

#define _LINUX_FS_NOTIFY_H

/*
 * include/linux/fsnotify.h - generic hooks for filesystem notification, to
 * reduce in-source duplication from both dnotify and inotify.
 *
 * We don't compile any of this away in some complicated menagerie of ifdefs.
 * Instead, we rely on the code inside to optimize away as needed.
 *
 * (C) Copyright 2005 Robert Love
 */

#include <linux/fsnotify_backend.h>
#include <linux/audit.h>
#include <linux/slab.h>
#include <linux/bug.h>

/* Notify this dentry's parent about a child's events. */


static inline int fsnotify_parent(struct path *path, struct dentry *dentry, __u32 mask)
{
	if (!dentry)
		dentry = path->dentry;

	return __fsnotify_parent(path, dentry, mask);
}

Contributors
Person Tokens Prop Commits CommitProp
eric paris eric paris 35 85.37% 3 60.00%
linus torvalds linus torvalds 4 9.76% 1 20.00%
andreas gruenbacher andreas gruenbacher 2 4.88% 1 20.00%
Total 41 100.00% 5 100.00%

/* simple call site for access decisions */


static inline int fsnotify_perm(struct file *file, int mask)
{
	struct path *path = &file->f_path;
	struct inode *inode = file_inode(file);
	__u32 fsnotify_mask = 0;
	int ret;

	if (file->f_mode & FMODE_NONOTIFY)
		return 0;
	if (!(mask & (MAY_READ | MAY_OPEN)))
		return 0;
	if (mask & MAY_OPEN)
		fsnotify_mask = FS_OPEN_PERM;
	else if (mask & MAY_READ)
		fsnotify_mask = FS_ACCESS_PERM;
	else
		BUG();

	ret = fsnotify_parent(path, NULL, fsnotify_mask);
	if (ret)
		return ret;

	return fsnotify(inode, fsnotify_mask, path, FSNOTIFY_EVENT_PATH, NULL, 0);
}

Contributors
Person Tokens Prop Commits CommitProp
eric paris eric paris 114 88.37% 4 66.67%
linus torvalds linus torvalds 11 8.53% 1 16.67%
david howells david howells 4 3.10% 1 16.67%
Total 129 100.00% 6 100.00%

/*
 * fsnotify_d_move - dentry has been moved
 */


static inline void fsnotify_d_move(struct dentry *dentry)
{
	/*
         * On move we need to update dentry->d_flags to indicate if the new parent
         * cares about events from this dentry.
         */
	__fsnotify_update_dcache_flags(dentry);
}

Contributors
Person Tokens Prop Commits CommitProp
nick piggin nick piggin 11 61.11% 1 33.33%
eric paris eric paris 7 38.89% 2 66.67%
Total 18 100.00% 3 100.00%

/*
 * fsnotify_link_count - inode's link count changed
 */


static inline void fsnotify_link_count(struct inode *inode)
{
	fsnotify(inode, FS_ATTRIB, inode, FSNOTIFY_EVENT_INODE, NULL, 0);
}

Contributors
Person Tokens Prop Commits CommitProp
eric paris eric paris 27 100.00% 3 100.00%
Total 27 100.00% 3 100.00%

/*
 * fsnotify_move - file old_name at old_dir was moved to new_name at new_dir
 */


static inline void fsnotify_move(struct inode *old_dir, struct inode *new_dir,
				 const unsigned char *old_name,
				 int isdir, struct inode *target, struct dentry *moved)
{
	struct inode *source = moved->d_inode;
	u32 fs_cookie = fsnotify_get_cookie();
	__u32 old_dir_mask = (FS_EVENT_ON_CHILD | FS_MOVED_FROM);
	__u32 new_dir_mask = (FS_EVENT_ON_CHILD | FS_MOVED_TO);
	const unsigned char *new_name = moved->d_name.name;

	if (old_dir == new_dir)
		old_dir_mask |= FS_DN_RENAME;

	if (isdir) {
		old_dir_mask |= FS_ISDIR;
		new_dir_mask |= FS_ISDIR;
	}

	fsnotify(old_dir, old_dir_mask, source, FSNOTIFY_EVENT_INODE, old_name,
		 fs_cookie);
	fsnotify(new_dir, new_dir_mask, source, FSNOTIFY_EVENT_INODE, new_name,
		 fs_cookie);

	if (target)
		fsnotify_link_count(target);

	if (source)
		fsnotify(source, FS_MOVE_SELF, moved->d_inode, FSNOTIFY_EVENT_INODE, NULL, 0);
	audit_inode_child(new_dir, moved, AUDIT_TYPE_CHILD_CREATE);
}

Contributors
Person Tokens Prop Commits CommitProp
eric paris eric paris 89 51.15% 6 40.00%
robert love robert love 36 20.69% 1 6.67%
al viro al viro 22 12.64% 2 13.33%
john mccutchan john mccutchan 16 9.20% 2 13.33%
amy griffis amy griffis 5 2.87% 1 6.67%
jeff layton jeff layton 4 2.30% 2 13.33%
jan kara jan kara 2 1.15% 1 6.67%
Total 174 100.00% 15 100.00%

/*
 * fsnotify_inode_delete - and inode is being evicted from cache, clean up is needed
 */


static inline void fsnotify_inode_delete(struct inode *inode)
{
	__fsnotify_inode_delete(inode);
}

Contributors
Person Tokens Prop Commits CommitProp
eric paris eric paris 17 100.00% 1 100.00%
Total 17 100.00% 1 100.00%

/*
 * fsnotify_vfsmount_delete - a vfsmount is being destroyed, clean up is needed
 */


static inline void fsnotify_vfsmount_delete(struct vfsmount *mnt)
{
	__fsnotify_vfsmount_delete(mnt);
}

Contributors
Person Tokens Prop Commits CommitProp
andreas gruenbacher andreas gruenbacher 17 100.00% 1 100.00%
Total 17 100.00% 1 100.00%

/*
 * fsnotify_nameremove - a filename was removed from a directory
 */


static inline void fsnotify_nameremove(struct dentry *dentry, int isdir)
{
	__u32 mask = FS_DELETE;

	if (isdir)
		mask |= FS_ISDIR;

	fsnotify_parent(NULL, dentry, mask);
}

Contributors
Person Tokens Prop Commits CommitProp
john mccutchan john mccutchan 25 67.57% 1 20.00%
eric paris eric paris 12 32.43% 4 80.00%
Total 37 100.00% 5 100.00%

/*
 * fsnotify_inoderemove - an inode is going away
 */


static inline void fsnotify_inoderemove(struct inode *inode)
{
	fsnotify(inode, FS_DELETE_SELF, inode, FSNOTIFY_EVENT_INODE, NULL, 0);
	__fsnotify_inode_delete(inode);
}

Contributors
Person Tokens Prop Commits CommitProp
eric paris eric paris 13 40.62% 4 66.67%
john mccutchan john mccutchan 11 34.38% 1 16.67%
jan kara jan kara 8 25.00% 1 16.67%
Total 32 100.00% 6 100.00%

/*
 * fsnotify_create - 'name' was linked in
 */


static inline void fsnotify_create(struct inode *inode, struct dentry *dentry)
{
	audit_inode_child(inode, dentry, AUDIT_TYPE_CHILD_CREATE);

	fsnotify(inode, FS_CREATE, dentry->d_inode, FSNOTIFY_EVENT_INODE, dentry->d_name.name, 0);
}

Contributors
Person Tokens Prop Commits CommitProp
eric paris eric paris 21 44.68% 3 37.50%
robert love robert love 16 34.04% 1 12.50%
amy griffis amy griffis 6 12.77% 2 25.00%
jeff layton jeff layton 4 8.51% 2 25.00%
Total 47 100.00% 8 100.00%

/*
 * fsnotify_link - new hardlink in 'inode' directory
 * Note: We have to pass also the linked inode ptr as some filesystems leave
 *   new_dentry->d_inode NULL and instantiate inode pointer later
 */


static inline void fsnotify_link(struct inode *dir, struct inode *inode, struct dentry *new_dentry)
{
	fsnotify_link_count(inode);
	audit_inode_child(dir, new_dentry, AUDIT_TYPE_CHILD_CREATE);

	fsnotify(dir, FS_CREATE, inode, FSNOTIFY_EVENT_INODE, new_dentry->d_name.name, 0);
}

Contributors
Person Tokens Prop Commits CommitProp
jan kara jan kara 32 58.18% 1 16.67%
eric paris eric paris 19 34.55% 3 50.00%
jeff layton jeff layton 4 7.27% 2 33.33%
Total 55 100.00% 6 100.00%

/*
 * fsnotify_mkdir - directory 'name' was created
 */


static inline void fsnotify_mkdir(struct inode *inode, struct dentry *dentry)
{
	__u32 mask = (FS_CREATE | FS_ISDIR);
	struct inode *d_inode = dentry->d_inode;

	audit_inode_child(inode, dentry, AUDIT_TYPE_CHILD_CREATE);

	fsnotify(inode, mask, d_inode, FSNOTIFY_EVENT_INODE, dentry->d_name.name, 0);
}

Contributors
Person Tokens Prop Commits CommitProp
eric paris eric paris 37 58.73% 4 44.44%
robert love robert love 14 22.22% 1 11.11%
amy griffis amy griffis 8 12.70% 2 22.22%
jeff layton jeff layton 4 6.35% 2 22.22%
Total 63 100.00% 9 100.00%

/*
 * fsnotify_access - file was read
 */


static inline void fsnotify_access(struct file *file)
{
	struct path *path = &file->f_path;
	struct inode *inode = file_inode(file);
	__u32 mask = FS_ACCESS;

	if (S_ISDIR(inode->i_mode))
		mask |= FS_ISDIR;

	if (!(file->f_mode & FMODE_NONOTIFY)) {
		fsnotify_parent(path, NULL, mask);
		fsnotify(inode, mask, path, FSNOTIFY_EVENT_PATH, NULL, 0);
	}
}

Contributors
Person Tokens Prop Commits CommitProp
eric paris eric paris 41 47.13% 9 69.23%
robert love robert love 27 31.03% 1 7.69%
linus torvalds linus torvalds 12 13.79% 1 7.69%
david howells david howells 4 4.60% 1 7.69%
andreas gruenbacher andreas gruenbacher 3 3.45% 1 7.69%
Total 87 100.00% 13 100.00%

/*
 * fsnotify_modify - file was modified
 */


static inline void fsnotify_modify(struct file *file)
{
	struct path *path = &file->f_path;
	struct inode *inode = file_inode(file);
	__u32 mask = FS_MODIFY;

	if (S_ISDIR(inode->i_mode))
		mask |= FS_ISDIR;

	if (!(file->f_mode & FMODE_NONOTIFY)) {
		fsnotify_parent(path, NULL, mask);
		fsnotify(inode, mask, path, FSNOTIFY_EVENT_PATH, NULL, 0);
	}
}

Contributors
Person Tokens Prop Commits CommitProp
eric paris eric paris 41 47.13% 9 69.23%
robert love robert love 27 31.03% 1 7.69%
linus torvalds linus torvalds 12 13.79% 1 7.69%
david howells david howells 4 4.60% 1 7.69%
andreas gruenbacher andreas gruenbacher 3 3.45% 1 7.69%
Total 87 100.00% 13 100.00%

/*
 * fsnotify_open - file was opened
 */


static inline void fsnotify_open(struct file *file)
{
	struct path *path = &file->f_path;
	struct inode *inode = file_inode(file);
	__u32 mask = FS_OPEN;

	if (S_ISDIR(inode->i_mode))
		mask |= FS_ISDIR;

	fsnotify_parent(path, NULL, mask);
	fsnotify(inode, mask, path, FSNOTIFY_EVENT_PATH, NULL, 0);
}

Contributors
Person Tokens Prop Commits CommitProp
eric paris eric paris 28 37.84% 8 66.67%
robert love robert love 27 36.49% 1 8.33%
linus torvalds linus torvalds 12 16.22% 1 8.33%
david howells david howells 4 5.41% 1 8.33%
andreas gruenbacher andreas gruenbacher 3 4.05% 1 8.33%
Total 74 100.00% 12 100.00%

/*
 * fsnotify_close - file was closed
 */


static inline void fsnotify_close(struct file *file)
{
	struct path *path = &file->f_path;
	struct inode *inode = file_inode(file);
	fmode_t mode = file->f_mode;
	__u32 mask = (mode & FMODE_WRITE) ? FS_CLOSE_WRITE : FS_CLOSE_NOWRITE;

	if (S_ISDIR(inode->i_mode))
		mask |= FS_ISDIR;

	if (!(file->f_mode & FMODE_NONOTIFY)) {
		fsnotify_parent(path, NULL, mask);
		fsnotify(inode, mask, path, FSNOTIFY_EVENT_PATH, NULL, 0);
	}
}

Contributors
Person Tokens Prop Commits CommitProp
robert love robert love 45 44.12% 1 9.09%
eric paris eric paris 40 39.22% 7 63.64%
linus torvalds linus torvalds 13 12.75% 1 9.09%
al viro al viro 4 3.92% 2 18.18%
Total 102 100.00% 11 100.00%

/*
 * fsnotify_xattr - extended attributes were changed
 */


static inline void fsnotify_xattr(struct dentry *dentry)
{
	struct inode *inode = dentry->d_inode;
	__u32 mask = FS_ATTRIB;

	if (S_ISDIR(inode->i_mode))
		mask |= FS_ISDIR;

	fsnotify_parent(NULL, dentry, mask);
	fsnotify(inode, mask, inode, FSNOTIFY_EVENT_INODE, NULL, 0);
}

Contributors
Person Tokens Prop Commits CommitProp
robert love robert love 36 57.14% 1 14.29%
eric paris eric paris 27 42.86% 6 85.71%
Total 63 100.00% 7 100.00%

/*
 * fsnotify_change - notify_change event.  file was modified and/or metadata
 * was changed.
 */


static inline void fsnotify_change(struct dentry *dentry, unsigned int ia_valid)
{
	struct inode *inode = dentry->d_inode;
	__u32 mask = 0;

	if (ia_valid & ATTR_UID)
		mask |= FS_ATTRIB;
	if (ia_valid & ATTR_GID)
		mask |= FS_ATTRIB;
	if (ia_valid & ATTR_SIZE)
		mask |= FS_MODIFY;

	/* both times implies a utime(s) call */
	if ((ia_valid & (ATTR_ATIME | ATTR_MTIME)) == (ATTR_ATIME | ATTR_MTIME))
		mask |= FS_ATTRIB;
	else if (ia_valid & ATTR_ATIME)
		mask |= FS_ACCESS;
	else if (ia_valid & ATTR_MTIME)
		mask |= FS_MODIFY;

	if (ia_valid & ATTR_MODE)
		mask |= FS_ATTRIB;

	if (mask) {
		if (S_ISDIR(inode->i_mode))
			mask |= FS_ISDIR;

		fsnotify_parent(NULL, dentry, mask);
		fsnotify(inode, mask, inode, FSNOTIFY_EVENT_INODE, NULL, 0);
	}
}

Contributors
Person Tokens Prop Commits CommitProp
robert love robert love 120 75.95% 1 12.50%
eric paris eric paris 38 24.05% 7 87.50%
Total 158 100.00% 8 100.00%

#if defined(CONFIG_FSNOTIFY)	/* notify helpers */

/*
 * fsnotify_oldname_init - save off the old filename before we change it
 */


static inline const unsigned char *fsnotify_oldname_init(const unsigned char *name)
{
	return kstrdup(name, GFP_KERNEL);
}

Contributors
Person Tokens Prop Commits CommitProp
robert love robert love 22 91.67% 1 50.00%
eric paris eric paris 2 8.33% 1 50.00%
Total 24 100.00% 2 100.00%

/*
 * fsnotify_oldname_free - free the name we got from fsnotify_oldname_init
 */


static inline void fsnotify_oldname_free(const unsigned char *old_name)
{
	kfree(old_name);
}

Contributors
Person Tokens Prop Commits CommitProp
robert love robert love 17 94.44% 1 50.00%
eric paris eric paris 1 5.56% 1 50.00%
Total 18 100.00% 2 100.00%

#else	/* CONFIG_FSNOTIFY */



static inline const char *fsnotify_oldname_init(const unsigned char *name)
{
	return NULL;
}

Contributors
Person Tokens Prop Commits CommitProp
robert love robert love 17 94.44% 1 50.00%
eric paris eric paris 1 5.56% 1 50.00%
Total 18 100.00% 2 100.00%



static inline void fsnotify_oldname_free(const unsigned char *old_name)
{
}

Contributors
Person Tokens Prop Commits CommitProp
robert love robert love 11 91.67% 1 50.00%
eric paris eric paris 1 8.33% 1 50.00%
Total 12 100.00% 2 100.00%

#endif	/*  CONFIG_FSNOTIFY */

#endif	/* _LINUX_FS_NOTIFY_H */
Overall Contributors
Person Tokens Prop Commits CommitProp
eric paris eric paris 627 46.27% 17 43.59%
robert love robert love 442 32.62% 1 2.56%
linus torvalds linus torvalds 64 4.72% 1 2.56%
john mccutchan john mccutchan 54 3.99% 3 7.69%
jan kara jan kara 43 3.17% 2 5.13%
andreas gruenbacher andreas gruenbacher 29 2.14% 2 5.13%
al viro al viro 26 1.92% 4 10.26%
amy griffis amy griffis 20 1.48% 2 5.13%
jeff layton jeff layton 16 1.18% 2 5.13%
david howells david howells 16 1.18% 1 2.56%
nick piggin nick piggin 12 0.89% 2 5.13%
paul gortmaker paul gortmaker 3 0.22% 1 2.56%
tejun heo tejun heo 3 0.22% 1 2.56%
Total 1355 100.00% 39 100.00%
  Directory: include/linux

Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.
	Person	Tokens	Prop	Commits	CommitProp
eric paris	eric paris	35	85.37%	3	60.00%
linus torvalds	linus torvalds	4	9.76%	1	20.00%
andreas gruenbacher	andreas gruenbacher	2	4.88%	1	20.00%
	Total	41	100.00%	5	100.00%
cregit-Linux how code gets into the kernel

Release 4.7 include/linux/fsnotify.h

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Overall Contributors
