From patchwork Wed Feb 25 23:41:22 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: =?utf-8?q?Andreas_Gr=C3=BCnbacher?= X-Patchwork-Id: 5885891 Return-Path: X-Original-To: patchwork-linux-fsdevel@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork2.web.kernel.org (Postfix) with ESMTP id 06CDCBF440 for ; Wed, 25 Feb 2015 23:48:54 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 2D4A120382 for ; Wed, 25 Feb 2015 23:48:53 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 1C56820381 for ; Wed, 25 Feb 2015 23:48:52 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753501AbbBYXmF (ORCPT ); Wed, 25 Feb 2015 18:42:05 -0500 Received: from mail-we0-f175.google.com ([74.125.82.175]:40077 "EHLO mail-we0-f175.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753041AbbBYXmD (ORCPT ); Wed, 25 Feb 2015 18:42:03 -0500 Received: by wesx3 with SMTP id x3so6769824wes.7; Wed, 25 Feb 2015 15:42:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:subject:date:message-id:in-reply-to:references:in-reply-to :references; bh=4LYXfljpX//Fj9AVdGzK4SHWqj8yChjMUKNkd+AiFdo=; b=izDvmtEg7o1m/C1HQNKpAI/mS1lhkKYkWr26cuDhkrwfa5OGv4IBpnbZGFZDmZEjPf TL5V/2tpNv0tgC72YO2QnyXVJOOw92u70s5SL4/dF2xG5WggJiGQWGMyOFFrZFk3JrEw es65cBa7PgJ/ZNdsrLyQhUt68sfAOpOduM2BFnwRxl9PqSpkwbrivp0acwPSWGKi6DKb WtDXvGIqm+pDwQlPIJJMuwVCW4HK+yeGS9saWW3mUJ6EmSr19p0RpxznsDCc2opkObOg eskB2G5nlNMBp7wa44LU1eJPuXffR8LtfRdrJ81oyGXPsK7iLnf/NrM4oavKdXsteSZn 1QMA== X-Received: by 10.180.36.212 with SMTP id s20mr11094231wij.58.1424907722300; Wed, 25 Feb 2015 15:42:02 -0800 (PST) Received: from nuc.home.com (80-110-112-196.cgn.dynamic.surfer.at. [80.110.112.196]) by mx.google.com with ESMTPSA id vh8sm66946337wjc.12.2015.02.25.15.42.00 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 25 Feb 2015 15:42:01 -0800 (PST) From: Andreas Gruenbacher X-Google-Original-From: Andreas Gruenbacher To: linux-kernel@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-nfs@vger.kernel.org Subject: [RFC 01/21] vfs: Minor documentation fix Date: Thu, 26 Feb 2015 00:41:22 +0100 Message-Id: X-Mailer: git-send-email 2.1.0 In-Reply-To: References: In-Reply-To: References: Sender: linux-fsdevel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-fsdevel@vger.kernel.org X-Spam-Status: No, score=-6.8 required=5.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED, FREEMAIL_FROM, RCVD_IN_DNSWL_HI, T_DKIM_INVALID, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP The check_acl inode operation and the IPERM_FLAG_RCU are long gone. Document what get_acl does instead. Signed-off-by: Andreas Gruenbacher --- Documentation/filesystems/porting | 8 ++++---- Documentation/filesystems/vfs.txt | 3 +++ 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/Documentation/filesystems/porting b/Documentation/filesystems/porting index fa2db08..d6f9ab4 100644 --- a/Documentation/filesystems/porting +++ b/Documentation/filesystems/porting @@ -379,10 +379,10 @@ may now be called in rcu-walk mode (nd->flags & LOOKUP_RCU). -ECHILD should be returned if the filesystem cannot handle rcu-walk. See Documentation/filesystems/vfs.txt for more details. - permission and check_acl are inode permission checks that are called -on many or all directory inodes on the way down a path walk (to check for -exec permission). These must now be rcu-walk aware (flags & IPERM_FLAG_RCU). -See Documentation/filesystems/vfs.txt for more details. + permission is an inode permission check that is called on many or all +directory inodes on the way down a path walk (to check for exec permission). It +must now be rcu-walk aware (mask & MAY_NOT_BLOCK). See +Documentation/filesystems/vfs.txt for more details. -- [mandatory] diff --git a/Documentation/filesystems/vfs.txt b/Documentation/filesystems/vfs.txt index 966b228..700cdf6 100644 --- a/Documentation/filesystems/vfs.txt +++ b/Documentation/filesystems/vfs.txt @@ -457,6 +457,9 @@ otherwise noted. If a situation is encountered that rcu-walk cannot handle, return -ECHILD and it will be called again in ref-walk mode. + get_acl: called by the VFS to get the posix acl of an inode. Called during + permission checks. The returned acl is cached in the inode. + setattr: called by the VFS to set attributes for a file. This method is called by chmod(2) and related system calls.