[mirror_ubuntu-focal-kernel.git] / fs / notify / fsnotify.h

/* SPDX-License-Identifier: GPL-2.0 */
#ifndef __FS_NOTIFY_FSNOTIFY_H_
#define __FS_NOTIFY_FSNOTIFY_H_

#include <linux/list.h>
#include <linux/fsnotify.h>
#include <linux/srcu.h>
#include <linux/types.h>

#include "../mount.h"

static inline struct inode *fsnotify_conn_inode(
				struct fsnotify_mark_connector *conn)
{
	return container_of(conn->obj, struct inode, i_fsnotify_marks);
}

static inline struct mount *fsnotify_conn_mount(
				struct fsnotify_mark_connector *conn)
{
	return container_of(conn->obj, struct mount, mnt_fsnotify_marks);
}

static inline struct super_block *fsnotify_conn_sb(
				struct fsnotify_mark_connector *conn)
{
	return container_of(conn->obj, struct super_block, s_fsnotify_marks);
}

/* destroy all events sitting in this groups notification queue */
extern void fsnotify_flush_notify(struct fsnotify_group *group);

/* protects reads of inode and vfsmount marks list */
extern struct srcu_struct fsnotify_mark_srcu;

/* compare two groups for sorting of marks lists */
extern int fsnotify_compare_groups(struct fsnotify_group *a,
				   struct fsnotify_group *b);

/* Destroy all marks attached to an object via connector */
extern void fsnotify_destroy_marks(fsnotify_connp_t *connp);
/* run the list of all marks associated with inode and destroy them */
static inline void fsnotify_clear_marks_by_inode(struct inode *inode)
{
	fsnotify_destroy_marks(&inode->i_fsnotify_marks);
}
/* run the list of all marks associated with vfsmount and destroy them */
static inline void fsnotify_clear_marks_by_mount(struct vfsmount *mnt)
{
	fsnotify_destroy_marks(&real_mount(mnt)->mnt_fsnotify_marks);
}
/* run the list of all marks associated with sb and destroy them */
static inline void fsnotify_clear_marks_by_sb(struct super_block *sb)
{
	fsnotify_destroy_marks(&sb->s_fsnotify_marks);
}
/* Wait until all marks queued for destruction are destroyed */
extern void fsnotify_wait_marks_destroyed(void);

/*
 * update the dentry->d_flags of all of inode's children to indicate if inode cares
 * about events that happen to its children.
 */
extern void __fsnotify_update_child_dentry_flags(struct inode *inode);

/* allocate and destroy and event holder to attach events to notification/access queues */
extern struct fsnotify_event_holder *fsnotify_alloc_event_holder(void);
extern void fsnotify_destroy_event_holder(struct fsnotify_event_holder *holder);

#endif	/* __FS_NOTIFY_FSNOTIFY_H_ */
Commit	Line	Data
b2441318	1	/* SPDX-License-Identifier: GPL-2.0 */
90586523 EP	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
925d1132 JK	10	#include "../mount.h"
925d1132 JK	11
36f10f55 AG	12	static inline struct inode *fsnotify_conn_inode(
36f10f55 AG	13	struct fsnotify_mark_connector *conn)
b812a9f5	14	{
36f10f55	15	return container_of(conn->obj, struct inode, i_fsnotify_marks);
b812a9f5 AG	16	}
b812a9f5 AG	17
36f10f55 AG	18	static inline struct mount *fsnotify_conn_mount(
36f10f55 AG	19	struct fsnotify_mark_connector *conn)
b812a9f5	20	{
36f10f55	21	return container_of(conn->obj, struct mount, mnt_fsnotify_marks);
b812a9f5 AG	22	}
b812a9f5 AG	23
1e6cb723 AG	24	static inline struct super_block *fsnotify_conn_sb(
	25	struct fsnotify_mark_connector *conn)
	26	{
	27	return container_of(conn->obj, struct super_block, s_fsnotify_marks);
	28	}
	29
a2d8bc6c EP	30	/* destroy all events sitting in this groups notification queue */
	31	extern void fsnotify_flush_notify(struct fsnotify_group *group);
	32
75c1be48 EP	33	/* protects reads of inode and vfsmount marks list */
	34	extern struct srcu_struct fsnotify_mark_srcu;
	35
8edc6e16 JK	36	/* compare two groups for sorting of marks lists */
	37	extern int fsnotify_compare_groups(struct fsnotify_group *a,
	38	struct fsnotify_group *b);
	39
9b6e5434 AG	40	/* Destroy all marks attached to an object via connector */
9b6e5434 AG	41	extern void fsnotify_destroy_marks(fsnotify_connp_t *connp);
925d1132 JK	42	/* run the list of all marks associated with inode and destroy them */
	43	static inline void fsnotify_clear_marks_by_inode(struct inode *inode)
	44	{
08991e83	45	fsnotify_destroy_marks(&inode->i_fsnotify_marks);
925d1132 JK	46	}
	47	/* run the list of all marks associated with vfsmount and destroy them */
	48	static inline void fsnotify_clear_marks_by_mount(struct vfsmount *mnt)
	49	{
08991e83	50	fsnotify_destroy_marks(&real_mount(mnt)->mnt_fsnotify_marks);
925d1132	51	}
1e6cb723 AG	52	/* run the list of all marks associated with sb and destroy them */
	53	static inline void fsnotify_clear_marks_by_sb(struct super_block *sb)
	54	{
	55	fsnotify_destroy_marks(&sb->s_fsnotify_marks);
	56	}
f09b04a0 JK	57	/* Wait until all marks queued for destruction are destroyed */
f09b04a0 JK	58	extern void fsnotify_wait_marks_destroyed(void);
35e48176	59
c28f7e56 EP	60	/*
	61	* update the dentry->d_flags of all of inode's children to indicate if inode cares
	62	* about events that happen to its children.
	63	*/
	64	extern void __fsnotify_update_child_dentry_flags(struct inode *inode);
a2d8bc6c EP	65
	66	/* allocate and destroy and event holder to attach events to notification/access queues */
	67	extern struct fsnotify_event_holder *fsnotify_alloc_event_holder(void);
	68	extern void fsnotify_destroy_event_holder(struct fsnotify_event_holder *holder);
	69
90586523	70	#endif /* __FS_NOTIFY_FSNOTIFY_H_ */