From mboxrd@z Thu Jan 1 00:00:00 1970 From: Pekka J Enberg Subject: [RFC/PATCH 5/5] revoke: add documentation Date: Wed, 11 Jul 2007 12:01:53 +0300 (EEST) Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit To: linux-fsdevel@vger.kernel.org Return-path: Received: from courier.cs.helsinki.fi ([128.214.9.1]:41859 "EHLO mail.cs.helsinki.fi" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1757209AbXGKJBy (ORCPT ); Wed, 11 Jul 2007 05:01:54 -0400 Received: from localhost (localhost [127.0.0.1]) by sbz-30.cs.helsinki.fi (Postfix) with ESMTP id 5731B801E for ; Wed, 11 Jul 2007 12:01:53 +0300 (EEST) Sender: linux-fsdevel-owner@vger.kernel.org List-Id: linux-fsdevel.vger.kernel.org From: Pekka Enberg This documents revoke file operation in Documentation/filesystems/vfs.txt. 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-05-21 15:37:59.000000000 +0300 +++ 2.6/Documentation/filesystems/vfs.txt 2007-07-11 11:48:46.000000000 +0300 @@ -732,6 +732,7 @@ struct file_operations { 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 @@ -805,6 +806,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