From nobody Sun Feb 8 05:33:55 2026 Received: from mail-pl1-f182.google.com (mail-pl1-f182.google.com [209.85.214.182]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 24B0821FF30 for ; Wed, 3 Dec 2025 01:09:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.182 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764724171; cv=none; b=c/c7YDlkOZLPLOppmzQd5aRO1ZRWgBPJ6S3xNZxRN0JjJm4CCsrdk2YH6bf6/djx/tmL/L6IP2pwlXURNsScoGPt595P+fxZTApsK68ayly22ZCikq9k3xLGbWNn8fP+QOyBF6wjxDtBg7kMsThFn7ZsbkCiQHIIYCERfvO5K3I= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764724171; c=relaxed/simple; bh=Z0aBSNRh8FsZikWs+4hiqB4YrcaG4UI4KRU2o9/GRvY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=KewksMugdQVB0WIwf3eQ/GqpWf+Z7WwVSQTTykkDMWiX5GVI6/sprU2Yq8CBixA9QbBD8ntJK2fEmBcKrcpRVc0lxofPzL7dGtcqad1Z9Va4pOv0QLpcd6meFLeKfpbKduFohlEL1gXYYf6qpQ5LAcEl7BpTnuGhZvtqbZw8xOs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=egy5BGhR; arc=none smtp.client-ip=209.85.214.182 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="egy5BGhR" Received: by mail-pl1-f182.google.com with SMTP id d9443c01a7336-2955623e6faso68266015ad.1 for ; Tue, 02 Dec 2025 17:09:30 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1764724169; x=1765328969; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=LiYHA42xwedYipACSgzqjaQJIVD/rAg52mdw9jn4jBA=; b=egy5BGhRX9+P1weZgOTkBGIefvozlOVoH0qVBRbFX4KvcfLNqS4cD94yZ8jvj8FJgr KvPxO6ElS9w7FveUFrVzFb1707XG72BwB0xkCvhql9Y6zSh3Lh4tTndO8nTXEPrQ2JUk N5dMPRntqx31jDkwDqAsgPw8dpla/S7R8F7q+RJJUxgABVv9EemzAzRZry7vqs+PiDGt 2jieLX966SXcuk81zM6dwzXfpBz2LqH+FO0k+/rzCHlzyQeckmkARwhw/1xfDWyjmVEb qtT6/ZawFDLOfC0TKW4klS0DWMWNmGlCnzu/xzTmyqtNmGHktnksHevRZs7AUqWmXUr9 Fh/g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1764724169; x=1765328969; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=LiYHA42xwedYipACSgzqjaQJIVD/rAg52mdw9jn4jBA=; b=P97O/hUet+Ym0pAlIPuYkcMEYK4CMGDGejaGtgJ123O45ud5ztqGv0j8xc1eZFyR4d M2V6fdDCRTu6Az2Y0l7cI1MvJgmTWMTmAp0bzrMYkxM9nlQ0xEBOWtdJ9n2uoPDMc7P/ B/UkRcBqTYd/xu4bP6QW3mufMsyp7vtqMid8YFVDQ2E3dUg/S4im+uPty80a0hmGZr+H EL3Ha+a0KWaiW11QMYWWpryfcAdNLXTW+P1aWQUaDbow1vXi4Wqm2g+IGg0uIgnZjc66 9qU8B/IvFsSyTXMjGBJlXyfv4l3kNkDaxPB7Yl1Akph6KDPcft6l1LlxgRuLAC7onCtA Xf3w== X-Gm-Message-State: AOJu0Yyd+addqE8H3GERWf5DSbsmBTrra3d7Z36pQm2sVBRi/yaQOaaX 67gP5TagqjFDxHmrccpJqoOtDIATv3hTwisP0x1EsuDOMJv0h/hzCgak X-Gm-Gg: ASbGnctk6bi9CFXKvCb5YE5poY0/rHcuBxxBtenDqNRI564pii9XkEdVro2IUa8pQud /O6FDR8ngv34GTANIYHpPSBmkOGalOVGIWo0KgnU0hM9OvpMuZNgCdu21tDU6D1o5bl/dE9pQnM Tvvf/3MepclbW6BGM9MOZpPEZpEsEMIfDMaM4jgZA5USeBot3DBzc8MVjUWt1YQFu47I0aNxfRc CYzU3CfrbQrqvSXjX62SY6j8NpQoBWbyyUDaY2Ukcw4Xr5b+5K/ELWdCz7WyqizVbJO0rj4w7r9 rTgOa+1Phz8qOSc2cjFgLo8u7k6OVlH+I7Vuph3Y1hsk1gvSCwJrpRtD21gWJvnVa/RYy6eHRHG 8ds7I6CwWWIcxvjNpMbO9G63WBkHLyPUWEP7hX/6LAuC7SJwptvRz+tbqsbBDOdYmDk+mUs48RM ViQKBOQqZcXc4= X-Google-Smtp-Source: AGHT+IELg+xWGYFXtVQWxsJbv6FTQvo29AtJj2U/WL+8krJllbbwnZhNGVJMTTx+ZN0Ro/B0i5hSKw== X-Received: by 2002:a17:903:f8e:b0:295:7454:34fd with SMTP id d9443c01a7336-29d6841a76dmr6420915ad.39.1764724169469; Tue, 02 Dec 2025 17:09:29 -0800 (PST) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-29bce2e676esm164710355ad.0.2025.12.02.17.09.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 02 Dec 2025 17:09:26 -0800 (PST) Received: by archie.me (Postfix, from userid 1000) id 6A01A4353260; Wed, 03 Dec 2025 08:09:21 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux NFS Cc: Chuck Lever , Jeff Layton , NeilBrown , Olga Kornievskaia , Dai Ngo , Tom Talpey , Trond Myklebust , Anna Schumaker , Jonathan Corbet , Mike Snitzer , Bagas Sanjaya , Stephen Rothwell Subject: [PATCH 1/3] NFSD: Add toctree entry for NFSD IO modes docs Date: Wed, 3 Dec 2025 08:09:09 +0700 Message-ID: <20251203010911.14234-2-bagasdotme@gmail.com> X-Mailer: git-send-email 2.52.0 In-Reply-To: <20251203010911.14234-1-bagasdotme@gmail.com> References: <20251203010911.14234-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1120; i=bagasdotme@gmail.com; h=from:subject; bh=Z0aBSNRh8FsZikWs+4hiqB4YrcaG4UI4KRU2o9/GRvY=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJn6Pe9qLz0+XfRBXT3h6v6lLn/2H114vzvmeobwdIPvI mX7WS7O7ihlYRDjYpAVU2SZlMjXdHqXkciF9rWOMHNYmUCGMHBxCsBEjk5lZJjVyv1EIqNz9dsL 12dNE5IScX2rO/mTlNlfn4yLxxhfyfxj+J+q7N3K2biJRzI868ryTvXL4XMf5T8Vy3idm1l0W8K oiQ0A X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Commit fa8d4e6784d1b6 ("NFSD: add Documentation/filesystems/nfs/nfsd-io-modes.rst") adds documentation for NFSD I/O modes, but it forgets to add toctree entry for it. Hence, Sphinx reports: Documentation/filesystems/nfs/nfsd-io-modes.rst: WARNING: document isn't in= cluded in any toctree [toc.not_included] Add the entry. Fixes: fa8d4e6784d1b6 ("NFSD: add Documentation/filesystems/nfs/nfsd-io-mod= es.rst") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/linux-next/20251202152506.7a2d2d41@canb.auu= g.org.au/ Signed-off-by: Bagas Sanjaya Reviewed-by: Jeff Layton Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- Documentation/filesystems/nfs/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/filesystems/nfs/index.rst b/Documentation/filesy= stems/nfs/index.rst index 95c2c009874cef..a29a212b5b4df4 100644 --- a/Documentation/filesystems/nfs/index.rst +++ b/Documentation/filesystems/nfs/index.rst @@ -13,5 +13,6 @@ NFS rpc-cache rpc-server-gss nfs41-server + nfsd-io-modes knfsd-stats reexport --=20 An old man doll... just what I always wanted! - Clara From nobody Sun Feb 8 05:33:55 2026 Received: from mail-pf1-f172.google.com (mail-pf1-f172.google.com [209.85.210.172]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 3749C233723 for ; Wed, 3 Dec 2025 01:09:32 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764724173; cv=none; b=Vb4KgesdgAtUF+lv7Xr9rn//MKz7FJ05NDHujPBSH2rZ29AZwXt1ITq0UmGdx0ceeXQ6yh+llXJH22uK5nq5mAn82ilvC/xn7eTdl9i6FefiCkEbR6PlUq51Vv9ALhDjKOMBE+RvEvyhjw84Zc7rEArqSnPNqcrQmF8jpReKlpc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764724173; c=relaxed/simple; bh=OnkMzhtWftClORfQtq4pVFAPUxLwrZMkgpnvY4knDco=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=XNNcTDtwxAi3wm7QJgQvPIjR5QxSmxA+yFPxbXhZVYgRIZm4WgUOy58paC9yw5WEJ5UHs5zitWSEWcvmwMwgOtn7xL+KDVKTQGLCDkNfNKNL93GPvDNd3nlBXCUJwnNosbiPrh4l00mSb+V6hFQN3WXN1LwdvbbWuBrtc5Cog4c= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=M4GkNpkQ; arc=none smtp.client-ip=209.85.210.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="M4GkNpkQ" Received: by mail-pf1-f172.google.com with SMTP id d2e1a72fcca58-7b80fed1505so7162419b3a.3 for ; Tue, 02 Dec 2025 17:09:32 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1764724171; x=1765328971; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=pMQ8vHmUy2M1e+AWep/BaUFVNkwfbE6reMg+lneA/lE=; b=M4GkNpkQ8hyBzf2xcSmAz9Th6YPOVugxO9SOs69B0L7zOmHGsIIWcvZsPtTgfBj71/ DsHjVsAad1kzNtXha5C9W8TuSRllfZf8gSVYqKy0rl8lBEQdGKijaVOEVqDJtG1Qx7Sk YlMmMAHQ/D9aq3p0FIJjddz3Ucy4y885k3OulLwYjHaKaO6BwZwqr9rTbDiPPNUgRrCl ufWa03r5pAKnjks6gwJhnjLeHs5BzUA5TphR6/4HrYFiRaBxCBh6qBXmH5wpab2v5cdR JDpYA1tRBP/6WIrGk3OHXDvzF9wwwXT0Ydf3b7ZoOx0lX4njkqfjPe8G5ZBW5fvL5RBL sXAQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1764724171; x=1765328971; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=pMQ8vHmUy2M1e+AWep/BaUFVNkwfbE6reMg+lneA/lE=; b=VPSiwUbNIsT70RbziFGaYTIYvEhD4HzS+WQc6ksy0+Xfj0VofKPRWY79oqtI2FwHqI PfnFooFxqlJ/H425e8NJoRjMYn4BqnMrDuMqU9z5RrA7umRv8eifwGFQ4w7NbHZ9AG5b kAZzj2imezOae03tC638vfx9+Ee/FNDo3c4FRLnunsgFu0E37VKo0CebafX4ZVXNIYaV 6F3u1Og89fqPEfS4+mkHMQLZm4hTrAhLYsZZTQk24whzw17/+GO8c8LBrnuzZXRa4UW9 8khXW78AwTZSvcaMbBLo+XZmDMYUlys4sVqyU+hCmoxhgLFBXHQNnuLRmkoNUomD1pHE IYHg== X-Gm-Message-State: AOJu0YyHxJqHv//lOHjFFTuNqgoIbeZmBESHT/IBrkt4mZUC0jVXjnsF MQbBW6NhLaaVRlxFrHtpKLPWDZlI6XJ8UVvAQ2IPDwoBsJz72ju6D+uw X-Gm-Gg: ASbGncvaag6CKjDIlJvaotichP/ihr3JxH05x31rEOV4+rnz6rXs0AB74lxFtCYfzib dKyTnTT/RHXCB5skyOHxhqd3zSt5uwV+WK8A81Aa9zhSUf+CDagoUqLwG5I71LJg+r2kvoVaDMx L7wl3FxWI9/rgL4kKU7Oivt7oGc3iEfSLcEKDOvaqGPvRw7duKqzv7YjkAMBfASjxf6jW9XZUq7 HRcIFYxsMEE0f+a9got/nBtjgcx8YGCUURzMGz0GcgHKV/QkH3KDpTSUuS7RTAlbXorvnVQz0rn vvcIHnC8D1ZgVpigrx8W769HbLh/2oX7NXCeOC2ZDTXwrpRCX6foFrT4/j15eV8ktY3QEx89Gh0 T+RaTvFtLyl7QSznLOB0/P5hBlTJtHExvIrGLONfdGMGLe0GZQu9UUbLUD952lbPqnGkvhfb9LM YIGj6RkjGqVrk= X-Google-Smtp-Source: AGHT+IF5UeBvVePda2KFWkC3k94/grAajsZo74APZmau4X7uYv0fD/GG5eh2o/bcLlRLAJhvCuZwoQ== X-Received: by 2002:a05:6a20:431e:b0:361:4ca3:e17d with SMTP id adf61e73a8af0-363f5d61e52mr820140637.13.1764724171524; Tue, 02 Dec 2025 17:09:31 -0800 (PST) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-be5e7485b1esm15317306a12.20.2025.12.02.17.09.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 02 Dec 2025 17:09:26 -0800 (PST) Received: by archie.me (Postfix, from userid 1000) id 9A0B74353263; Wed, 03 Dec 2025 08:09:21 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux NFS Cc: Chuck Lever , Jeff Layton , NeilBrown , Olga Kornievskaia , Dai Ngo , Tom Talpey , Trond Myklebust , Anna Schumaker , Jonathan Corbet , Mike Snitzer , Bagas Sanjaya , Stephen Rothwell Subject: [PATCH 2/3] NFSD: nfsd-io-modes: Wrap shell snippets in literal code blocks Date: Wed, 3 Dec 2025 08:09:10 +0700 Message-ID: <20251203010911.14234-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.52.0 In-Reply-To: <20251203010911.14234-1-bagasdotme@gmail.com> References: <20251203010911.14234-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=3455; i=bagasdotme@gmail.com; h=from:subject; bh=OnkMzhtWftClORfQtq4pVFAPUxLwrZMkgpnvY4knDco=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJn6Pe+Trd/L7dn9ftEi90Mr7M9wBZaILSl4auJntCl3U dGj6JSEjlIWBjEuBlkxRZZJiXxNp3cZiVxoX+sIM4eVCWQIAxenAEykdiXD/+xvP9W2P7s9v++n ge85xzQPzq++x7//s/diFg9t+TLNJIHhnwYHs1Y780yu1SvLODRyn73q6Kr4cjmp5GTY95WNPwQ WcAAA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Sphinx reports htmldocs indentation warnings: Documentation/filesystems/nfs/nfsd-io-modes.rst:29: ERROR: Unexpected inden= tation. [docutils] Documentation/filesystems/nfs/nfsd-io-modes.rst:34: ERROR: Unexpected inden= tation. [docutils] Fix these by wrapping shell snippets in literal code blocks. Fixes: fa8d4e6784d1b6 ("NFSD: add Documentation/filesystems/nfs/nfsd-io-mod= es.rst") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/linux-next/20251202152506.7a2d2d41@canb.auu= g.org.au/ Signed-off-by: Bagas Sanjaya Reviewed-by: Jeff Layton Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- .../filesystems/nfs/nfsd-io-modes.rst | 28 +++++++++++-------- 1 file changed, 16 insertions(+), 12 deletions(-) diff --git a/Documentation/filesystems/nfs/nfsd-io-modes.rst b/Documentatio= n/filesystems/nfs/nfsd-io-modes.rst index e3a522d097666b..fa47c4d3dfb95d 100644 --- a/Documentation/filesystems/nfs/nfsd-io-modes.rst +++ b/Documentation/filesystems/nfs/nfsd-io-modes.rst @@ -25,12 +25,14 @@ Based on the configured settings, NFSD's IO will either= be: - not cached stable_how=3DNFS_UNSTABLE (NFSD_IO_DIRECT=3D2) =20 To set an NFSD IO mode, write a supported value (0 - 2) to the -corresponding IO operation's debugfs interface, e.g.: +corresponding IO operation's debugfs interface, e.g.:: + echo 2 > /sys/kernel/debug/nfsd/io_cache_read echo 2 > /sys/kernel/debug/nfsd/io_cache_write =20 To check which IO mode NFSD is using for READ or WRITE, simply read the -corresponding IO operation's debugfs interface, e.g.: +corresponding IO operation's debugfs interface, e.g.:: + cat /sys/kernel/debug/nfsd/io_cache_read cat /sys/kernel/debug/nfsd/io_cache_write =20 @@ -128,17 +130,19 @@ Tracing: misaligned READ to the next DIO-aligned block (on either end of the original READ, as needed). =20 - This combination of trace events is useful for READs: - echo 1 > /sys/kernel/tracing/events/nfsd/nfsd_read_vector/enable - echo 1 > /sys/kernel/tracing/events/nfsd/nfsd_read_direct/enable - echo 1 > /sys/kernel/tracing/events/nfsd/nfsd_read_io_done/enable - echo 1 > /sys/kernel/tracing/events/xfs/xfs_file_direct_read/enable + This combination of trace events is useful for READs:: + + echo 1 > /sys/kernel/tracing/events/nfsd/nfsd_read_vector/enable + echo 1 > /sys/kernel/tracing/events/nfsd/nfsd_read_direct/enable + echo 1 > /sys/kernel/tracing/events/nfsd/nfsd_read_io_done/enable + echo 1 > /sys/kernel/tracing/events/xfs/xfs_file_direct_read/enable =20 The nfsd_write_direct trace event shows how NFSD splits a given misaligned WRITE into a DIO-aligned middle segment. =20 - This combination of trace events is useful for WRITEs: - echo 1 > /sys/kernel/tracing/events/nfsd/nfsd_write_opened/enable - echo 1 > /sys/kernel/tracing/events/nfsd/nfsd_write_direct/enable - echo 1 > /sys/kernel/tracing/events/nfsd/nfsd_write_io_done/enable - echo 1 > /sys/kernel/tracing/events/xfs/xfs_file_direct_write/enable + This combination of trace events is useful for WRITEs:: + + echo 1 > /sys/kernel/tracing/events/nfsd/nfsd_write_opened/enable + echo 1 > /sys/kernel/tracing/events/nfsd/nfsd_write_direct/enable + echo 1 > /sys/kernel/tracing/events/nfsd/nfsd_write_io_done/enable + echo 1 > /sys/kernel/tracing/events/xfs/xfs_file_direct_write/enable --=20 An old man doll... just what I always wanted! - Clara From nobody Sun Feb 8 05:33:55 2026 Received: from mail-pl1-f181.google.com (mail-pl1-f181.google.com [209.85.214.181]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 36EE91DE3DC for ; Wed, 3 Dec 2025 01:09:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.181 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764724168; cv=none; b=rXW5SDhzu8qYN2Mpas2zcfveDjGZZUUf7P9Xx51L3zFOslx96GQRsp4/DlFadeRAuZwVpq438VhvRjRLTE9WhAD9OusaRyAQKlOF/087eG8+AAJ2C9umKBBUAAKLP42cCgu4rybQs3rV7Gl+Vr2dfBvD6AfNRA7hFvvrQWeo+jk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764724168; c=relaxed/simple; bh=6fHMLY9nzx/qk7eCUo5CKi2uxMKJlPKvhN3nUdBaoio=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=aOwJHnMgVkk2+nZF8fWOZIe7avlL96nxMAEMlPPbOw6fB3fWu6F28psKvv4IvtPDyRI+/60pyN7QOHtdTGH5y1ysMxmDHMdTuvw2Mm/ogpgwwC1IE17bwZDb+28paUqoyRT23EV7MFeE80aSi90xJP0s1Xt37W9N2Pj5VG1M0Hw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=EEBZSR3b; arc=none smtp.client-ip=209.85.214.181 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="EEBZSR3b" Received: by mail-pl1-f181.google.com with SMTP id d9443c01a7336-298287a26c3so72860785ad.0 for ; Tue, 02 Dec 2025 17:09:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1764724166; x=1765328966; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=em6jfQZn/yELHlaBR2HoIyDIAqcmTdw7KjJD9azyEhY=; b=EEBZSR3b0dBwfdzWUg6K++SqhDQbdTzr2bB2bxzJCk1mdF5tWGWoDX2+0JiuaE+Xp2 VR1d34XOgSJHjcMVaqINz4E4+Pd6fMh9OSyzGs8TQeM2DBLd54C1cgvyxexBXPO31ZG0 rgvXgH5qROAcfsy2JREK05bBH9I8RtgiEE0pDJMbAjXzl5CtkU8MGr5jNzeMnTrLA2Mb aRWn5FqWvCyJhvkz+SPTvofz0hwQsuA2rvFVMTSyBZQtM+13GEvIL8EXQxFnNEFjfkZY K0v88vgaJ4+6W9dtexY7UMiGEBaBl4kWafPJ0k6zJGjzcRErpZmk+yDPUaSxUTo/bYMV A4+w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1764724166; x=1765328966; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=em6jfQZn/yELHlaBR2HoIyDIAqcmTdw7KjJD9azyEhY=; b=D3Et5oSh2r0v2jBvjB63LB9SCeZDPIp1TuaEXwu/eqIsQATL9RCmpQgd3q2G6FKpLf MBN3ORw/XSwwSgPUDbAQAeSRF+zw2xbibO/wazA3zvnsWZfog+IqDxN5u0we3gaUPukO /NlQKfSFxqYprKr53DCliynAIxmlP8LNzGAlPIhtcY0roTdw0b1NpRQ+8TGERrQDVOMl lnWvPlA4sKd28kp8oZL8rV0BU84yV+DCqUiUD8y9EoFFPkGE/DdmGKm9dIXGouyGs+K7 HqI0zr8XLHFbSl+O8/QXrpoMBQy3MoVN0NZTeW+JCCN8zcQQd7tJfqU9nPJn0oYhj933 sv1g== X-Gm-Message-State: AOJu0YzwEQNLR1Ge/sFBfV3Mwi0codAi0YCJJsenjsbHTgcVz1d9K5L/ kDzkq8WBneryqKf5TDJ/UL8sUp1XpiietACnALN+KNpDrsbItQv6TNZI X-Gm-Gg: ASbGncvCwjIdJ0zrjFBRftkRCc3VCbPvtL5LzhDj7I3AcfcXcWkon3VD9xkbug9elUe PwOQ2n+XUSYXQXtmTgQXPuC/gOqRL+F46nnAzDYVzn2RtxIaiLxQsc5J+kQfT4O0FEWgCoJS4pN KevxwRYOGnUQUAxRfaVwEZ7hNDPQtNm+ugsIpqqZBwhAstlJW1yME4y+RjfYfJKa08esg48IL5q qiNFmfD5nqqhIoG1W8YNkmbOqe/v820gtP5MMfLpZkvEra7kCRBSC9S2kdYauNiyL6TqyIoV9n6 xAFa1Ub7D7ikzYBUBzx68rmiUeS/hSl1xnVfKulDq2vq6eMl1B3mbN6PzFy+O63h6IsVNsV6WRd xK8XDF2SU+hk4pDwJdAKu0xfdPC2STNRx+Iqrh7sQ0djQNtpgFgewrbfuE/aViL0F98YiKP7VNG NFC1c/Cy+9AdI= X-Google-Smtp-Source: AGHT+IG3vKLqQKpkwoikY08lxmkSKyzlesJHIK2dDXGy98QlzQH0KRi1t8Esy4WYV0xAJppLVDx0Xw== X-Received: by 2002:a17:903:2986:b0:298:485d:5576 with SMTP id d9443c01a7336-29d6833c7d1mr6204845ad.8.1764724166264; Tue, 02 Dec 2025 17:09:26 -0800 (PST) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-29bceb29fbbsm165394905ad.49.2025.12.02.17.09.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 02 Dec 2025 17:09:24 -0800 (PST) Received: by archie.me (Postfix, from userid 1000) id AA5904353266; Wed, 03 Dec 2025 08:09:21 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux NFS Cc: Chuck Lever , Jeff Layton , NeilBrown , Olga Kornievskaia , Dai Ngo , Tom Talpey , Trond Myklebust , Anna Schumaker , Jonathan Corbet , Mike Snitzer , Bagas Sanjaya , Stephen Rothwell Subject: [PATCH 3/3] NFSD: nfsd-io-modes: Separate lists Date: Wed, 3 Dec 2025 08:09:11 +0700 Message-ID: <20251203010911.14234-4-bagasdotme@gmail.com> X-Mailer: git-send-email 2.52.0 In-Reply-To: <20251203010911.14234-1-bagasdotme@gmail.com> References: <20251203010911.14234-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=2634; i=bagasdotme@gmail.com; h=from:subject; bh=6fHMLY9nzx/qk7eCUo5CKi2uxMKJlPKvhN3nUdBaoio=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJn6Pe9LBObG7S6WTlAV6pIViqhnP7u6IUT2uZK6m9q0D U6/18zpKGVhEONikBVTZJmUyNd0epeRyIX2tY4wc1iZQIYwcHEKwESKbzIydF8M8lP46FW5Y/nt mAS5riVrTIVe3AwWuSPBKWVeqbhhP8Mf7p13Prs9DTnxP0xRrljReOrTAO0FvZr+FkUfVE+pmJS wAQA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Sphinx reports htmldocs indentation warnings: Documentation/filesystems/nfs/nfsd-io-modes.rst:58: ERROR: Unexpected inden= tation. [docutils] Documentation/filesystems/nfs/nfsd-io-modes.rst:59: WARNING: Block quote en= ds without a blank line; unexpected unindent. [docutils] These caused the lists to be shown as long running paragraphs merged with their previous paragraphs. Fix these by separating the lists with a blank line. Fixes: fa8d4e6784d1b6 ("NFSD: add Documentation/filesystems/nfs/nfsd-io-mod= es.rst") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/linux-next/20251202152506.7a2d2d41@canb.auu= g.org.au/ Signed-off-by: Bagas Sanjaya Reviewed-by: Jeff Layton Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- Documentation/filesystems/nfs/nfsd-io-modes.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Documentation/filesystems/nfs/nfsd-io-modes.rst b/Documentatio= n/filesystems/nfs/nfsd-io-modes.rst index fa47c4d3dfb95d..0fd6e82478fe6e 100644 --- a/Documentation/filesystems/nfs/nfsd-io-modes.rst +++ b/Documentation/filesystems/nfs/nfsd-io-modes.rst @@ -13,6 +13,7 @@ to override that default to use either DONTCACHE or DIREC= T IO modes. =20 Experimental NFSD debugfs interfaces are available to allow the NFSD IO mode used for READ and WRITE to be configured independently. See both: + - /sys/kernel/debug/nfsd/io_cache_read - /sys/kernel/debug/nfsd/io_cache_write =20 @@ -20,6 +21,7 @@ The default value for both io_cache_read and io_cache_wri= te reflects NFSD's default IO mode (which is NFSD_IO_BUFFERED=3D0). =20 Based on the configured settings, NFSD's IO will either be: + - cached using page cache (NFSD_IO_BUFFERED=3D0) - cached but removed from page cache on completion (NFSD_IO_DONTCACHE=3D1) - not cached stable_how=3DNFS_UNSTABLE (NFSD_IO_DIRECT=3D2) @@ -56,6 +58,7 @@ because the page cache will eventually become a bottlenec= k to servicing new IO requests. =20 For more context on DONTCACHE, please see these Linux commit headers: + - Overview: 9ad6344568cc3 ("mm/filemap: change filemap_create_folio() to take a struct kiocb") - for READ: 8026e49bff9b1 ("mm/filemap: add read support for @@ -87,7 +90,9 @@ be made. The performance win associated with using NFSD DIRECT was previously discussed on linux-nfs, see: https://lore.kernel.org/linux-nfs/aEslwqa9iMeZjjlV@kernel.org/ + But in summary: + - NFSD DIRECT can significantly reduce memory requirements - NFSD DIRECT can reduce CPU load by avoiding costly page reclaim work - NFSD DIRECT can offer more deterministic IO performance --=20 An old man doll... just what I always wanted! - Clara