Commit 99b319d3 authored by Jonathan Corbet's avatar Jonathan Corbet
Browse files

docs: vfs: clean up after the iterate() removal 

Commit 3e327154 ("vfs: get rid of old '->iterate' directory operation")
removed the iterate() file_operations member, but neglected to clean up the
associated documentation.  Get rid of the leftovers.

Link: https://lore.kernel.org/r/874jl945bv.fsf@meer.lwn.net


Reviewed-by: default avatarChristian Brauner <brauner@kernel.org>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent ad93f083

Documentation/filesystems/locking.rst

+0 −1
Original line number Diff line number Diff line
@@ -509,7 +509,6 @@ prototypes:: 
	ssize_t (*read_iter) (struct kiocb *, struct iov_iter *);

	ssize_t (*write_iter) (struct kiocb *, struct iov_iter *);

	int (*iopoll) (struct kiocb *kiocb, bool spin);

	int (*iterate) (struct file *, struct dir_context *);

	int (*iterate_shared) (struct file *, struct dir_context *);

	__poll_t (*poll) (struct file *, struct poll_table_struct *);

	long (*unlocked_ioctl) (struct file *, unsigned int, unsigned long);

Documentation/filesystems/vfs.rst

+1 −6
Original line number Diff line number Diff line
@@ -1074,7 +1074,6 @@ This describes how the VFS can manipulate an open file. As of kernel 
		ssize_t (*read_iter) (struct kiocb *, struct iov_iter *);

		ssize_t (*write_iter) (struct kiocb *, struct iov_iter *);

		int (*iopoll)(struct kiocb *kiocb, bool spin);

		int (*iterate) (struct file *, struct dir_context *);

		int (*iterate_shared) (struct file *, struct dir_context *);

		__poll_t (*poll) (struct file *, struct poll_table_struct *);

		long (*unlocked_ioctl) (struct file *, unsigned int, unsigned long);
@@ -1126,12 +1125,8 @@ otherwise noted. 
``iopoll``

	called when aio wants to poll for completions on HIPRI iocbs



``iterate``

	called when the VFS needs to read the directory contents



``iterate_shared``

	called when the VFS needs to read the directory contents when

	filesystem supports concurrent dir iterators

	called when the VFS needs to read the directory contents



``poll``

	called by the VFS when a process wants to check if there is