Received: by 2002:a05:6a10:8c0a:0:0:0:0 with SMTP id go10csp4388146pxb; Tue, 26 Jan 2021 21:58:03 -0800 (PST) X-Google-Smtp-Source: ABdhPJxB7bghhUZ+ArnAFUsIMN6NM3N9W4F9W+PvbUDL93f7QnNm3SGE/Bn/OjMf8phOhefrLKUv X-Received: by 2002:a17:906:2e9a:: with SMTP id o26mr5608758eji.77.1611727083032; Tue, 26 Jan 2021 21:58:03 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1611727083; cv=none; d=google.com; s=arc-20160816; b=cL1+UuFnjBp76qj9IoGTI4TwggViECEpIkAvuVtD7mzNmsjf21jXS8iH7b5kSEdAoE 3XQx7FNvLLKiD392IzedwsGfBWYzE72fBDQ+pf0ajRsFDUeDQFZs4pmGHiS3cYftNJ1M LJ0Pmnvi9vDG2F1IXXCP2cJlXY1apK1QA9tldjXT2UTCbxd04qR80OIhY1VE6K8Y/Ves wHTyk9hLO99sKNkmQBi7j8BQJj+WHPYbEAvbsShyQtwaCKajF8a+RPo4nAk97FcaIrQY ZG6LYwP3+7zbiUDiBT8x91KN4EWs+vdA1nvqc4h3TH49xJOZTsgPxXW59mBkQfipSTGL pdYQ== 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 :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=773+RXZkteimM+S1ETqgBQNdS5zGsgoZEJtrpOYRkE4=; b=y7RJdgKdhAtME8Ctj0dtpYRIdU2534Md1eA6NfdjRvQ7vUyCBKKSPYQlE324i8he+U xoqTduYepH8gA0prJ4sxca7OERAY+Ky2UTD+26Wa5PMTsfZHstoSnz9+HZbZi6w1LBfN HTLGE2UHqXF03EqEIS9om6xJrMdussKHpdRJt8pWeHCG9de94TqHSIAlZEyGF4G819E8 7zU/NruSWIjN/+8IA2a6Dwu4rrJMz/aI03aqNPeEFvILdcHsAmI15Y9/tK8W1S0XBKP8 JkvRNmaTPKYPoaydGE/8vAa00k2m4MzHlzWTXXaZI1l3ygc2+3mDUABzhhpU8Axnrvqr LyjQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b="kyAJly/9"; 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=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id y12si445663edv.604.2021.01.26.21.57.39; Tue, 26 Jan 2021 21:58:03 -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=@gmail.com header.s=20161025 header.b="kyAJly/9"; 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=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2391206AbhAZRhG (ORCPT + 99 others); Tue, 26 Jan 2021 12:37:06 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:41636 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2389580AbhAZHlf (ORCPT ); Tue, 26 Jan 2021 02:41:35 -0500 Received: from mail-pg1-x52c.google.com (mail-pg1-x52c.google.com [IPv6:2607:f8b0:4864:20::52c]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BBDE4C061793; Mon, 25 Jan 2021 23:25:38 -0800 (PST) Received: by mail-pg1-x52c.google.com with SMTP id o7so925333pgl.1; Mon, 25 Jan 2021 23:25:38 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=773+RXZkteimM+S1ETqgBQNdS5zGsgoZEJtrpOYRkE4=; b=kyAJly/9CBI1UylWR4mgCXsFSiP+kmjhAGF8l/n5Nevk6mv0qeblpxVuyJeszm6Z1d a8OtUUqtKJCq53P9TyCXzcw0t0RNAc4X6XGAr+JN7fT3ED4d7VPmHsRM1z4+AKsrmTNJ Hc4nFsHJAXewgucu0G36aKgUw3x7x8YOddTQ7VCCiBiPiRCGoXSEu9Nn6ofhchWe4UjT 0w3TM/gd1gwam9Fnv4kyhwx7oHIR5/K7MBPLgIsW8tVyh40hSsbI1DKaAJHTQtRSRCB9 n6rYgRh35GneZnrjsct0p3VFwZsPHoCDm+58A7XPIH9UaCrKQIOFF7kbyL2K1zDPNnZB jWYg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=773+RXZkteimM+S1ETqgBQNdS5zGsgoZEJtrpOYRkE4=; b=DiLfm9wjy5YLxxoTtVFOXBuME+DdDefFKJd8Cu+Oss/2aI2TC0yX6SVU9TzxY0Px7R xkIaaCLc5pgydqerPHxYplSzzoFxDPL2DSBC2SwVCxfSZeEgHXdwAFiVUs6AhwfhNEN9 BDLvrZLnsL/QKSWvOBxo+xF/WZ4gBjoCA/FM9bzEHegVm8VLCaG9YP6d5KKwl/JWPpYz SJJTQ2/TgYA4WV5TcZ1ozpu/G/FRt7xlALu2qTI7Pb3usD6ZO0a5QCZUnJUDz86sUQKV O9+Kjg+UXyKMAZaS8AeFjIElJ73P7+hBrEspAZAPNIjPpwJTVyLpUrbJTk1p2+I7ZQTg gPWQ== X-Gm-Message-State: AOAM530YfiPGjNOyMAoAsTedQJRPk7ZPo7BEuGvH9RfXOtqG0OoSO56U PsqPXhM2ctzJhKArrA8HFJ4= X-Received: by 2002:a62:1741:0:b029:1be:3fb:447 with SMTP id 62-20020a6217410000b02901be03fb0447mr3961453pfx.50.1611645938304; Mon, 25 Jan 2021 23:25:38 -0800 (PST) Received: from cl-arch-kdev.. (cl-arch-kdev.xen.prgmr.com. [2605:2700:0:2:a800:ff:fed6:fc0d]) by smtp.gmail.com with ESMTPSA id l12sm1320256pjg.54.2021.01.25.23.25.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 25 Jan 2021 23:25:37 -0800 (PST) From: Fox Chen To: corbet@lwn.net, vegard.nossum@oracle.com, viro@zeniv.linux.org.uk, rdunlap@infradead.org, grandmaster@al2klimov.de Cc: Fox Chen , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 10/12] docs: path-lookup: update WALK_GET, WALK_PUT desc Date: Tue, 26 Jan 2021 15:24:41 +0800 Message-Id: <20210126072443.33066-11-foxhlchen@gmail.com> X-Mailer: git-send-email 2.30.0 In-Reply-To: <20210126072443.33066-1-foxhlchen@gmail.com> References: <20210126072443.33066-1-foxhlchen@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org WALK_GET is changed to WALK_TRAILING with a different meaning. Here it should be WALK_NOFOLLOW. WALK_PUT dosn't exist, we have WALK_MORE. WALK_PUT == !WALK_MORE And there is not should_follow_link(). related commits: 8c4efe22e7c4de1d44f624120a979e31e3a584b8 1c4ff1a87e46a06fc00a83da2fbbc3ac0298f221 Signed-off-by: Fox Chen --- Documentation/filesystems/path-lookup.rst | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/Documentation/filesystems/path-lookup.rst b/Documentation/filesystems/path-lookup.rst index 915c9ffe22c1..921779a4636f 100644 --- a/Documentation/filesystems/path-lookup.rst +++ b/Documentation/filesystems/path-lookup.rst @@ -1126,13 +1126,11 @@ stack in ``walk_component()`` immediately when the symlink is found; old symlink as it walks that last component. So it is quite convenient for ``walk_component()`` to release the old symlink and pop the references just before pushing the reference information for the -new symlink. It is guided in this by two flags; ``WALK_GET``, which -gives it permission to follow a symlink if it finds one, and -``WALK_PUT``, which tells it to release the current symlink after it has been -followed. ``WALK_PUT`` is tested first, leading to a call to -``put_link()``. ``WALK_GET`` is tested subsequently (by -``should_follow_link()``) leading to a call to ``pick_link()`` which sets -up the stack frame. +new symlink. It is guided in this by two flags; ``WALK_NOFOLLOW``, which +suggests whether to follow a symlink if it finds one, and +``WALK_MORE``, which tells whether to release the current symlink after it has +been followed. ``WALK_MORE`` is tested first, leading to a call to +``put_link()``. Symlinks with no final component ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- 2.30.0