Received: by 2002:a05:6a10:8c0a:0:0:0:0 with SMTP id go10csp454721pxb; Wed, 27 Jan 2021 11:51:27 -0800 (PST) X-Google-Smtp-Source: ABdhPJyVLKbN1CbxIIEJ9W9q5VxbJF9oQYsz+898PU2RbL6s5AVX0uj+rrBI9P9kJh/8+LtfFvig X-Received: by 2002:aa7:c94c:: with SMTP id h12mr10784648edt.40.1611777086902; Wed, 27 Jan 2021 11:51:26 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1611777086; cv=none; d=google.com; s=arc-20160816; b=dA1115icDmGbnrITFXhZ7tgZMV/TNBODPgSGzFEIqT9b9x90J6TgqvXoGJLq85CYUZ ljM4nNYgBX6O1poM+7+/tyetdXZcOfuTiQGH9JR9jVvzzJNGC/1mXwgp2u2meE3HJxMy D+DHM6H5s5iRdUGExfYul7pRewbn7XxcMv2iKQCgU2INUlmwCpaF+BvBZygLrA5vN4gZ ELxv87VoIuFO8PzimCQerpB++qsnetB8rmAfB1FklCgCZkVNw5EVBdPE0RLy0BN2p1Vm E18IYuCVhZbgm7Xejk+LJqMoIZVkNKEXbdNezchi9IPeEJmLbJrhIPi4lIcl4cTIkj43 ZCGA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :organization:references:in-reply-to:message-id:subject:cc:to:from :date:dkim-signature:dkim-filter; bh=QNbhJWfpGylw9eOPfWr/bvmPVRtZhMmsoAiYwr5ysZ4=; b=OI70heqcGuMFCadUZdJUVurkPNMeIji9dEgK8VeZqajtdTAQ1kKDVtAZX/IA8JqCMT K5TKRA5w78dY9oaJCoOTPzOuQCQ69EnZQdEjEUAry8DI2iSubmeKxwqK2x2xdPRXu8VH xIv6VXpjkBU9f5p5z0nPTL3MF9PyawktmszQkhldky//Rl2Kna9GbMBRG5gHbu1hI6gL /tF2KjUSMGrQ6OUsh5Hain3mjJhDu0ZRXxnGJOuF50Q4ciPTN9aTgZciXZAviY57j4ju LG2TxYIrbML3w+z1xtE/WeMsrgKMYLvbeh/E3awuVSEYOypaFMeMC18OsaTjLDu5Ddop Lg8A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b=fqgUKFSp; 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 Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id a7si1502150edr.457.2021.01.27.11.51.01; Wed, 27 Jan 2021 11:51:26 -0800 (PST) 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=@lwn.net header.s=20201203 header.b=fqgUKFSp; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235398AbhA0DQu (ORCPT + 99 others); Tue, 26 Jan 2021 22:16:50 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39240 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728441AbhAZUcZ (ORCPT ); Tue, 26 Jan 2021 15:32:25 -0500 Received: from ms.lwn.net (ms.lwn.net [IPv6:2600:3c01:e000:3a1::42]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 316B0C06174A; Tue, 26 Jan 2021 12:31:44 -0800 (PST) Received: from lwn.net (unknown [IPv6:2601:281:8300:104d::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 2005F5F5A; Tue, 26 Jan 2021 20:31:43 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 2005F5F5A DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1611693103; bh=QNbhJWfpGylw9eOPfWr/bvmPVRtZhMmsoAiYwr5ysZ4=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=fqgUKFSp0x9hxp+G5VfsABfssNrnF0CSZDquKRdQ2WoE6RzFeg8oBgiAA1N7lNoBI jsS2IXaXGrlaMKPUL5xdFeAjBLOjpJUdw5nL0gOB0xx+sA4RRhmxJ3lqOkntWiytvK DmOUj43EnvSuO0GL4DjcPeLEXFhQ8svL7BlQ7sOeN/y2eDki7WS5WoU+hFloS9kiyV j8ty3zSKlu27eXxh2mhGCY0zwZWZVLKU+gZR5M9g/NebJYg9XdvluN+1hz3rU4gmGi yRQA85mnUobCGKdDqRkvPaYw6hvSjnONjp7zmMgs+cNPd0W/45ylmmUFE/iqnT58i0 vUZo3nYmY0SxA== Date: Tue, 26 Jan 2021 13:31:41 -0700 From: Jonathan Corbet To: Fox Chen Cc: vegard.nossum@oracle.com, viro@zeniv.linux.org.uk, rdunlap@infradead.org, grandmaster@al2klimov.de, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Neil Brown Subject: Re: [PATCH 00/12] docs: path-lookup: Update pathlookup docs Message-ID: <20210126133141.27eb1c9d@lwn.net> In-Reply-To: <20210126072443.33066-1-foxhlchen@gmail.com> References: <20210126072443.33066-1-foxhlchen@gmail.com> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, 26 Jan 2021 15:24:31 +0800 Fox Chen wrote: > The Path lookup is a very complex subject in VFS. The path-lookup > document provides a very detailed guidance to help people understand > how path lookup works in the kernel.This document was originally > written based on three lwn articles five years ago. As times goes by, > some of the content was outdated. This patchset is intended to update > the document to make it more relevant to current codebase. > > > Fox Chen (12): > docs: path-lookup: update follow_managed() part > docs: path-lookup: update path_to_nameidata() parth > docs: path-lookup: update path_mountpoint() part > docs: path-lookup: update do_last() part > docs: path-lookup: remove filename_mountpoint > docs: path-lookup: Add macro name to symlink limit description > docs: path-lookup: i_op->follow_link replaced with i_op->get_link > docs: path-lookup: update i_op->put_link and cookie description > docs: path-lookup: no get_link() > docs: path-lookup: update WALK_GET, WALK_PUT desc > docs: path-lookup: update get_link() ->follow_link description > docs: path-lookup: update symlink description > > Documentation/filesystems/path-lookup.rst | 146 ++++++++++------------ > 1 file changed, 63 insertions(+), 83 deletions(-) Neil Brown (copied) is the original author of this document; I'd really like his feedback on these changes. Neil, the full set is at: https://lore.kernel.org/lkml/20210126072443.33066-1-foxhlchen@gmail.com/ Thanks, jon