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(mnt: 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(obj: conn->obj, obj_type: 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(connp: &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(connp: &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(connp: fsnotify_sb_marks(sb));
96}
97
98static inline void fsnotify_clear_marks_by_mntns(struct mnt_namespace *mntns)
99{
100 fsnotify_destroy_marks(connp: &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_ */
112