[PATCH] revoke: add to documentation From: Pekka Enberg Add the ->revoke() file operation to VFS documentation. Cc: Alan Cox Cc: Al Viro Cc: Christoph Hellwig Cc: Michael Kerrisk Signed-off-by: Pekka Enberg --- Documentation/filesystems/vfs.txt | 5 +++++ 1 file changed, 5 insertions(+) Index: 2.6/Documentation/filesystems/vfs.txt =================================================================== --- 2.6.orig/Documentation/filesystems/vfs.txt 2007-10-26 15:24:28.000000000 +0300 +++ 2.6/Documentation/filesystems/vfs.txt 2007-10-26 15:24:41.000000000 +0300 @@ -780,6 +780,7 @@ struct file_operations { int (*flock) (struct file *, int, struct file_lock *); ssize_t (*splice_write)(struct pipe_inode_info *, struct file *, size_t, unsigned int); ssize_t (*splice_read)(struct file *, struct pipe_inode_info *, size_t, unsigned int); + int (*revoke)(struct file *); }; Again, all methods are called without any locks being held, unless @@ -853,6 +854,10 @@ otherwise noted. splice_read: called by the VFS to splice data from file to a pipe. This method is used by the splice(2) system call + revoke: called by revokeat(2) and frevoke(2) system calls to revoke access + to an open file. This method must ensure that all currently blocked + writes are flushed and reads will fail. + Note that the file operations are implemented by the specific filesystem in which the inode resides. When opening a device node (character or block special) most filesystems will call special