From mboxrd@z Thu Jan 1 00:00:00 1970 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 37430233722 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-7acd9a03ba9so6741695b3a.1 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=GRLo1scfLHC8KNpaapJaOs8kQgbJMRKn+sbYrEXgZ1HSR8p/IUlKDaxftvKP7O48F5 N25n6wDF1adZ+7DHmhOC90ikdebJJDyjWuGK0stsm5yEx4LGgLkebqluQs08nAQFUHnv Xctj4A9HwkK9Z/is/4Bct0lw9vYtzcwCfDHq+FpQ5qdVAXNoTYTr5lHWyOM120dLolK5 A29h5Rws/RzkssqXbIHsDu04JCKAX2aApfwcQc3dzPwjbkvfE+FADPg7lr5zmJd/wpe2 9ujKp8Zh5guJqSN+pKvC541OZ6Y+mQYtk+RdZwK3mXj8gGTAHgOycInIBPZNI/BbDn5h Q30g== X-Forwarded-Encrypted: i=1; AJvYcCUr5FNYq4SxsizyQpq2VrvJxXAUZpC7RH6zq5bCQN5lLCL/cWdhm2OACOkic7bA7CPA/q1tw1CUaR0=@vger.kernel.org X-Gm-Message-State: AOJu0Yy8xqxgI/HVkBgTDBq/FlvJomSTkgUuT4tro4hBh+WV2bBLO3t4 9U6NqyROLdgJl2wLK4H7oaAuDQ0/oN64c5hbdbeCNLgUsLfUg8Ia/xxM X-Gm-Gg: ASbGnctn3yBjKsSwUKrdkRPEcvTwTyGUwVKglS4A8eNplY6BEoNO+CTaEMQKgtjj5RK ka5XNxOcVg6pkLYRBTzV6mkOKYMVhPKRgMqvsSM8ZyfmbzExSf8xp+/3GWTQ0Jvy5u3wiPksWLw FKpZPJXa7TNzOn4z57T1bPO4c7SfPfvJ+WQMIFuVWOfMQKz7agRnAkLaSmTe1LpP3/kGVJOvRoy dOupeqCX6QCSNrsZ9cvamWJOdRPTojxNOkcTadfpqqrgP4DRQfkQ99mP6m0f1cQ4irYss86wtDe ETcUvWffLqU1TSL+Zu9epEyBHLON9V+6CEKOyAYOxalZ+WBOH8Y17EfUbR4HaIfcHIot27HYcxO NTxxUz1fZ+v3pyXpCzjwh28NCfmeJop/KoMUVugr17kWH2ycJcr2sqZ0ceJTPH+PypY/4LDYVea tyGrcmh9FSKUw= 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-nfs@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: 8bit Sphinx reports htmldocs indentation warnings: Documentation/filesystems/nfs/nfsd-io-modes.rst:29: ERROR: Unexpected indentation. [docutils] Documentation/filesystems/nfs/nfsd-io-modes.rst:34: ERROR: Unexpected indentation. [docutils] Fix these by wrapping shell snippets in literal code blocks. Fixes: fa8d4e6784d1b6 ("NFSD: add Documentation/filesystems/nfs/nfsd-io-modes.rst") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/linux-next/20251202152506.7a2d2d41@canb.auug.org.au/ Signed-off-by: Bagas Sanjaya --- .../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/Documentation/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=NFS_UNSTABLE (NFSD_IO_DIRECT=2) 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 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 @@ -128,17 +130,19 @@ Tracing: misaligned READ to the next DIO-aligned block (on either end of the original READ, as needed). - 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 The nfsd_write_direct trace event shows how NFSD splits a given misaligned WRITE into a DIO-aligned middle segment. - 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 -- An old man doll... just what I always wanted! - Clara