Received: by 2002:a25:1985:0:0:0:0:0 with SMTP id 127csp707146ybz; Wed, 15 Apr 2020 17:10:04 -0700 (PDT) X-Google-Smtp-Source: APiQypJ4Zaz84T5VloclFybqNNiO3P9B61ONjlO0ntLyFgJCnXiVl75xdQJHxWbueB7tttnOZnBr X-Received: by 2002:a05:6402:1713:: with SMTP id y19mr11354573edu.40.1586995803960; Wed, 15 Apr 2020 17:10:03 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1586995803; cv=none; d=google.com; s=arc-20160816; b=o+7HYPXDGr52xcmDMF7pgXwJHfwLehMvRmnt8mrT4aBtciUgF8wg7jSOy7x9F3JCrC QcH+wCHjZUQGLdRUxDEWkwxU2u4HSPv5gxlwEb9pvx9Vsnl/n6zVS3zwuNsYc+iNtR19 DCChjt+QeRn2Y60lvHvu13ulTxTt/ox8nmPLxegGFEh+o0aavxI+ijhsPqeYg/qQ41pw QUZErPPEfTsCVflQkIgZdSjN8dJOWSQEEkolU+MeXFh0iXPsvchVqm0Zy2L84F+w16He 6XggNkk2IrWA2w0Qe+az11o+qEpTIrbdfL6Fx8KXUjNj3knR5qR5r7Foviqzd8TjO2NR bf/A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=C7Z6fdA/96NFS3R7ZoK++jrhuNPZPO4h+GGYNasIbco=; b=DgB9OjsvMZCagNDQxFCPS/aUCK5w8xkuWcVrpmowDLlmM/J7JEyEVYp636wDAUgVav ls28ZfD4+/7S2LHQwgV8a8mMrzo5uVROECVaNQctf7DeHVcL9j9CGeafOmHrWIqBLyU0 5Hsw3JFC/6vRPJHlPWUM9FBH14U7pg4QDNxxIl0jBRluo4tjuv2S/1nqYf/w7D8ZTQ+m 8g/qKgBVQlZ0WAyrkEt2YhQbtWfCQyI8NcQjPisywEy2CtHx+RWcFBptrYhWIOXnxG66 AwfBK8i0ijbML+55NvVygAU7MlrL4WX3+p6xSofu1Pv3FTY6yuaHY9LVd2965ZKGxRsn REWg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b="d/6Ky7ul"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id r11si11638557ejb.49.2020.04.15.17.09.40; Wed, 15 Apr 2020 17:10:03 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b="d/6Ky7ul"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2636710AbgDOOjp (ORCPT + 99 others); Wed, 15 Apr 2020 10:39:45 -0400 Received: from mail.kernel.org ([198.145.29.99]:45448 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2394081AbgDOOdD (ORCPT ); Wed, 15 Apr 2020 10:33:03 -0400 Received: from mail.kernel.org (ip5f5ad4d8.dynamic.kabel-deutschland.de [95.90.212.216]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 989B821D7F; Wed, 15 Apr 2020 14:32:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1586961171; bh=23W1yG2qd23ktTEijZVV4o1Pn9RiSi+sd+ontuQcaUo=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=d/6Ky7ulpaMQzAvg6L1uWqpqwxH1ebX+25NRicM8wfSkZivdFaRd3rqI4zkp7pxtN eUUGumB8pAiNPQoY9tOGNR+gaL41mvffwk3TH4RiGaRce/zuapmqpGag+vQmmAcG/Z dONKFtid4G8rVbhAe5CGmG6IBZsqeVlNjttMakXc= Received: from mchehab by mail.kernel.org with local (Exim 4.92.3) (envelope-from ) id 1jOj5t-006kPR-QP; Wed, 15 Apr 2020 16:32:49 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , Alexander Viro , linux-fsdevel@vger.kernel.org Subject: [PATCH 22/34] docs: filesystems: rename path-lookup.txt file Date: Wed, 15 Apr 2020 16:32:35 +0200 Message-Id: X-Mailer: git-send-email 2.25.2 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org There are two files called "patch-lookup", with different contents: one is a ReST file, the other one is the text. As we'll be finishing the conversion of filesystem documents, let's fist rename the text one, in order to avoid messing with the existing ReST file. Signed-off-by: Mauro Carvalho Chehab --- .../filesystems/{path-lookup.txt => path-walking.txt} | 0 Documentation/filesystems/porting.rst | 2 +- fs/dcache.c | 6 +++--- fs/namei.c | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) rename Documentation/filesystems/{path-lookup.txt => path-walking.txt} (100%) diff --git a/Documentation/filesystems/path-lookup.txt b/Documentation/filesystems/path-walking.txt similarity index 100% rename from Documentation/filesystems/path-lookup.txt rename to Documentation/filesystems/path-walking.txt diff --git a/Documentation/filesystems/porting.rst b/Documentation/filesystems/porting.rst index 26c093969573..8f7d25acf326 100644 --- a/Documentation/filesystems/porting.rst +++ b/Documentation/filesystems/porting.rst @@ -404,7 +404,7 @@ the callback. It used to be necessary to clean it there, but not anymore vfs now tries to do path walking in "rcu-walk mode", which avoids atomic operations and scalability hazards on dentries and inodes (see -Documentation/filesystems/path-lookup.txt). d_hash and d_compare changes +Documentation/filesystems/path-walking.txt). d_hash and d_compare changes (above) are examples of the changes required to support this. For more complex filesystem callbacks, the vfs drops out of rcu-walk mode before the fs call, so no changes are required to the filesystem. However, this is costly and loses diff --git a/fs/dcache.c b/fs/dcache.c index b280e07e162b..cf8d5893bd0e 100644 --- a/fs/dcache.c +++ b/fs/dcache.c @@ -2191,7 +2191,7 @@ static inline bool d_same_name(const struct dentry *dentry, * * __d_lookup_rcu is the dcache lookup function for rcu-walk name * resolution (store-free path walking) design described in - * Documentation/filesystems/path-lookup.txt. + * Documentation/filesystems/path-walking.txt. * * This is not to be used outside core vfs. * @@ -2239,7 +2239,7 @@ struct dentry *__d_lookup_rcu(const struct dentry *parent, * false-negative result. d_lookup() protects against concurrent * renames using rename_lock seqlock. * - * See Documentation/filesystems/path-lookup.txt for more details. + * See Documentation/filesystems/path-walking.txt for more details. */ hlist_bl_for_each_entry_rcu(dentry, node, b, d_hash) { unsigned seq; @@ -2362,7 +2362,7 @@ struct dentry *__d_lookup(const struct dentry *parent, const struct qstr *name) * false-negative result. d_lookup() protects against concurrent * renames using rename_lock seqlock. * - * See Documentation/filesystems/path-lookup.txt for more details. + * See Documentation/filesystems/path-walking.txt for more details. */ rcu_read_lock(); diff --git a/fs/namei.c b/fs/namei.c index a320371899cf..d1b53fea83d8 100644 --- a/fs/namei.c +++ b/fs/namei.c @@ -645,7 +645,7 @@ static bool legitimize_root(struct nameidata *nd) /* * Path walking has 2 modes, rcu-walk and ref-walk (see - * Documentation/filesystems/path-lookup.txt). In situations when we can't + * Documentation/filesystems/path-walking.txt). In situations when we can't * continue in RCU mode, we attempt to drop out of rcu-walk mode and grab * normal reference counts on dentries and vfsmounts to transition to ref-walk * mode. Refcounts are grabbed at the last known good point before rcu-walk -- 2.25.2