fsnotify.h

  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef __FS_NOTIFY_FSNOTIFY_H_
  3#define __FS_NOTIFY_FSNOTIFY_H_
  4
  5#include <linux/list.h>
  6#include <linux/fsnotify.h>
  7#include <linux/srcu.h>
  8#include <linux/types.h>
  9
 10#include "../mount.h"
 11
 12/*
 13 * fsnotify_connp_t is what we embed in objects which connector can be attached
 14 * to.
 15 */
 16typedef struct fsnotify_mark_connector __rcu *fsnotify_connp_t;
 17
 18static inline struct inode *fsnotify_conn_inode(
 19				struct fsnotify_mark_connector *conn)
 20{
 21	return conn->obj;
 22}
 23
 24static inline struct mount *fsnotify_conn_mount(
 25				struct fsnotify_mark_connector *conn)
 26{
 27	return real_mount(conn->obj);
 28}
 29
 30static inline struct super_block *fsnotify_conn_sb(
 31				struct fsnotify_mark_connector *conn)
 32{
 33	return conn->obj;
 34}
 35
 36static inline struct mnt_namespace *fsnotify_conn_mntns(
 37				struct fsnotify_mark_connector *conn)
 38{
 39	return conn->obj;
 40}
 41
 42static inline struct super_block *fsnotify_object_sb(void *obj,
 43			enum fsnotify_obj_type obj_type)
 44{
 45	switch (obj_type) {
 46	case FSNOTIFY_OBJ_TYPE_INODE:
 47		return ((struct inode *)obj)->i_sb;
 48	case FSNOTIFY_OBJ_TYPE_VFSMOUNT:
 49		return ((struct vfsmount *)obj)->mnt_sb;
 50	case FSNOTIFY_OBJ_TYPE_SB:
 51		return (struct super_block *)obj;
 52	default:
 53		return NULL;
 54	}
 55}
 56
 57static inline struct super_block *fsnotify_connector_sb(
 58				struct fsnotify_mark_connector *conn)
 59{
 60	return fsnotify_object_sb(conn->obj, conn->type);
 61}
 62
 63static inline fsnotify_connp_t *fsnotify_sb_marks(struct super_block *sb)
 64{
 65	struct fsnotify_sb_info *sbinfo = fsnotify_sb_info(sb);
 66
 67	return sbinfo ? &sbinfo->sb_marks : NULL;
 68}
 69
 70/* destroy all events sitting in this groups notification queue */
 71extern void fsnotify_flush_notify(struct fsnotify_group *group);
 72
 73/* protects reads of inode and vfsmount marks list */
 74extern struct srcu_struct fsnotify_mark_srcu;
 75
 76/* compare two groups for sorting of marks lists */
 77extern int fsnotify_compare_groups(struct fsnotify_group *a,
 78				   struct fsnotify_group *b);
 79
 80/* Destroy all marks attached to an object via connector */
 81extern void fsnotify_destroy_marks(fsnotify_connp_t *connp);
 82/* run the list of all marks associated with inode and destroy them */
 83static inline void fsnotify_clear_marks_by_inode(struct inode *inode)
 84{
 85	fsnotify_destroy_marks(&inode->i_fsnotify_marks);
 86}
 87/* run the list of all marks associated with vfsmount and destroy them */
 88static inline void fsnotify_clear_marks_by_mount(struct vfsmount *mnt)
 89{
 90	fsnotify_destroy_marks(&real_mount(mnt)->mnt_fsnotify_marks);
 91}
 92/* run the list of all marks associated with sb and destroy them */
 93static inline void fsnotify_clear_marks_by_sb(struct super_block *sb)
 94{
 95	fsnotify_destroy_marks(fsnotify_sb_marks(sb));
 96}
 97
 98static inline void fsnotify_clear_marks_by_mntns(struct mnt_namespace *mntns)
 99{
100	fsnotify_destroy_marks(&mntns->n_fsnotify_marks);
101}
102
103/*
104 * update the dentry->d_flags of all of inode's children to indicate if inode cares
105 * about events that happen to its children.
106 */
107extern void fsnotify_set_children_dentry_flags(struct inode *inode);
108
109extern struct kmem_cache *fsnotify_mark_connector_cachep;
110
111#endif	/* __FS_NOTIFY_FSNOTIFY_H_ */