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 super_block *fsnotify_object_sb(void *obj,
37			enum fsnotify_obj_type obj_type)
38{
39	switch (obj_type) {
40	case FSNOTIFY_OBJ_TYPE_INODE:
41		return ((struct inode *)obj)->i_sb;
42	case FSNOTIFY_OBJ_TYPE_VFSMOUNT:
43		return ((struct vfsmount *)obj)->mnt_sb;
44	case FSNOTIFY_OBJ_TYPE_SB:
45		return (struct super_block *)obj;
46	default:
47		return NULL;
48	}
49}
50
51static inline struct super_block *fsnotify_connector_sb(
52				struct fsnotify_mark_connector *conn)
53{
54	return fsnotify_object_sb(conn->obj, conn->type);
55}
56
57static inline fsnotify_connp_t *fsnotify_sb_marks(struct super_block *sb)
58{
59	struct fsnotify_sb_info *sbinfo = fsnotify_sb_info(sb);
60
61	return sbinfo ? &sbinfo->sb_marks : NULL;
62}
63
64/* destroy all events sitting in this groups notification queue */
65extern void fsnotify_flush_notify(struct fsnotify_group *group);
66
67/* protects reads of inode and vfsmount marks list */
68extern struct srcu_struct fsnotify_mark_srcu;
69
70/* compare two groups for sorting of marks lists */
71extern int fsnotify_compare_groups(struct fsnotify_group *a,
72				   struct fsnotify_group *b);
73
74/* Destroy all marks attached to an object via connector */
75extern void fsnotify_destroy_marks(fsnotify_connp_t *connp);
76/* run the list of all marks associated with inode and destroy them */
77static inline void fsnotify_clear_marks_by_inode(struct inode *inode)
78{
79	fsnotify_destroy_marks(&inode->i_fsnotify_marks);
80}
81/* run the list of all marks associated with vfsmount and destroy them */
82static inline void fsnotify_clear_marks_by_mount(struct vfsmount *mnt)
83{
84	fsnotify_destroy_marks(&real_mount(mnt)->mnt_fsnotify_marks);
85}
86/* run the list of all marks associated with sb and destroy them */
87static inline void fsnotify_clear_marks_by_sb(struct super_block *sb)
88{
89	fsnotify_destroy_marks(fsnotify_sb_marks(sb));
90}
91
92/*
93 * update the dentry->d_flags of all of inode's children to indicate if inode cares
94 * about events that happen to its children.
95 */
96extern void __fsnotify_update_child_dentry_flags(struct inode *inode);
97
98extern struct kmem_cache *fsnotify_mark_connector_cachep;
99
100#endif	/* __FS_NOTIFY_FSNOTIFY_H_ */
101