cregit-Linux how code gets into the kernel

Release 4.15 include/linux/fsnotify.h

Directory: include/linux
/* SPDX-License-Identifier: GPL-2.0 */
#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(const struct path *path, struct dentry *dentry, __u32 mask) { if (!dentry) dentry = path->dentry; return __fsnotify_parent(path, dentry, mask); }

Contributors

PersonTokensPropCommitsCommitProp
Eric Paris3583.33%350.00%
Linus Torvalds49.52%116.67%
Andreas Gruenbacher24.76%116.67%
Al Viro12.38%116.67%
Total42100.00%6100.00%

/* simple call site for access decisions */
static inline int fsnotify_perm(struct file *file, int mask) { const struct path *path = &file->f_path; /* * Do not use file_inode() here or anywhere in this file to get the * inode. That would break *notity on overlayfs. */ struct inode *inode = path->dentry->d_inode; __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

PersonTokensPropCommitsCommitProp
Eric Paris11486.36%457.14%
Linus Torvalds118.33%114.29%
Aihua Zhang64.55%114.29%
Al Viro10.76%114.29%
Total132100.00%7100.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

PersonTokensPropCommitsCommitProp
Eric Paris27100.00%3100.00%
Total27100.00%3100.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

PersonTokensPropCommitsCommitProp
Eric Paris8951.15%640.00%
Robert Love3620.69%16.67%
Al Viro2212.64%213.33%
John McCutchan169.20%213.33%
Amy Griffis52.87%16.67%
Jeff Layton42.30%213.33%
Jan Kara21.15%16.67%
Total174100.00%15100.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

PersonTokensPropCommitsCommitProp
Eric Paris17100.00%1100.00%
Total17100.00%1100.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

PersonTokensPropCommitsCommitProp
Andreas Gruenbacher17100.00%1100.00%
Total17100.00%1100.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

PersonTokensPropCommitsCommitProp
John McCutchan2567.57%120.00%
Eric Paris1232.43%480.00%
Total37100.00%5100.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

PersonTokensPropCommitsCommitProp
Eric Paris1340.62%466.67%
John McCutchan1134.38%116.67%
Jan Kara825.00%116.67%
Total32100.00%6100.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

PersonTokensPropCommitsCommitProp
Eric Paris2144.68%337.50%
Robert Love1429.79%112.50%
Amy Griffis817.02%225.00%
Jeff Layton48.51%225.00%
Total47100.00%8100.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

PersonTokensPropCommitsCommitProp
Jan Kara3258.18%116.67%
Eric Paris1934.55%350.00%
Jeff Layton47.27%233.33%
Total55100.00%6100.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

PersonTokensPropCommitsCommitProp
Eric Paris3758.73%444.44%
Robert Love1422.22%111.11%
Amy Griffis812.70%222.22%
Jeff Layton46.35%222.22%
Total63100.00%9100.00%

/* * fsnotify_access - file was read */
static inline void fsnotify_access(struct file *file) { const struct path *path = &file->f_path; struct inode *inode = path->dentry->d_inode; __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

PersonTokensPropCommitsCommitProp
Eric Paris4146.07%964.29%
Robert Love2730.34%17.14%
Linus Torvalds1213.48%17.14%
Aihua Zhang55.62%17.14%
Andreas Gruenbacher33.37%17.14%
Al Viro11.12%17.14%
Total89100.00%14100.00%

/* * fsnotify_modify - file was modified */
static inline void fsnotify_modify(struct file *file) { const struct path *path = &file->f_path; struct inode *inode = path->dentry->d_inode; __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

PersonTokensPropCommitsCommitProp
Eric Paris4146.07%964.29%
Robert Love2730.34%17.14%
Linus Torvalds1213.48%17.14%
Aihua Zhang55.62%17.14%
Andreas Gruenbacher33.37%17.14%
Al Viro11.12%17.14%
Total89100.00%14100.00%

/* * fsnotify_open - file was opened */
static inline void fsnotify_open(struct file *file) { const struct path *path = &file->f_path; struct inode *inode = path->dentry->d_inode; __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

PersonTokensPropCommitsCommitProp
Eric Paris2836.84%861.54%
Robert Love2735.53%17.69%
Linus Torvalds1215.79%17.69%
Aihua Zhang56.58%17.69%
Andreas Gruenbacher33.95%17.69%
Al Viro11.32%17.69%
Total76100.00%13100.00%

/* * fsnotify_close - file was closed */
static inline void fsnotify_close(struct file *file) { const struct path *path = &file->f_path; struct inode *inode = path->dentry->d_inode; 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

PersonTokensPropCommitsCommitProp
Robert Love4442.31%18.33%
Eric Paris4038.46%758.33%
Linus Torvalds1312.50%18.33%
Aihua Zhang54.81%18.33%
Al Viro21.92%216.67%
Total104100.00%12100.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

PersonTokensPropCommitsCommitProp
Robert Love3657.14%114.29%
Eric Paris2742.86%685.71%
Total63100.00%7100.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

PersonTokensPropCommitsCommitProp
Robert Love12075.95%112.50%
Eric Paris3824.05%787.50%
Total158100.00%8100.00%

#endif /* _LINUX_FS_NOTIFY_H */

Overall Contributors

PersonTokensPropCommitsCommitProp
Eric Paris60648.02%1642.11%
Robert Love36629.00%12.63%
Linus Torvalds645.07%12.63%
John McCutchan544.28%37.89%
Jan Kara433.41%25.26%
Andreas Gruenbacher292.30%25.26%
Al Viro292.30%513.16%
Aihua Zhang262.06%12.63%
Amy Griffis221.74%25.26%
Jeff Layton161.27%25.26%
Tejun Heo30.24%12.63%
Paul Gortmaker30.24%12.63%
Greg Kroah-Hartman10.08%12.63%
Total1262100.00%38100.00%
Directory: include/linux
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.
Created with cregit.