]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/cephfs: edit troubleshooting.rst 65092/head
authorZac Dover <zac.dover@proton.me>
Sun, 10 Aug 2025 11:04:44 +0000 (21:04 +1000)
committerZac Dover <zac.dover@proton.me>
Mon, 18 Aug 2025 13:48:58 +0000 (23:48 +1000)
Edit the section "Kernel Mount Debugging" in the file
doc/cephfs/troubleshooting.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 012d38c89583667679d434d6ee2cf2d205ea4501)

doc/cephfs/troubleshooting.rst

index 79e6682d1abed232b1169f21b7cace71bc9e910d..4960bb4ac08fb63855ead0520e0d18ea8209566d 100644 (file)
@@ -311,10 +311,17 @@ If you suspect a potential monitor issue, enable monitor debugging as well
 Kernel mount debugging
 ======================
 
-If there is an issue with the kernel client, the most important thing is
-figuring out whether the problem is with the kernel client or the MDS. Generally,
-this is easy to work out. If the kernel client broke directly, there will be
-output in ``dmesg``. Collect it and any inappropriate kernel state.
+The first step in diagnosing and repairing an issue with the kernel client is
+determining whether the problem is in the kernel client or in the MDS. If the
+kernel client itself is broken, evidence of its breakage will be in the kernel
+ring buffer, which can be examined by running the following command:
+
+.. prompt:: bash #
+
+   dmesg
+
+Find the relevant kernel state.
+
 
 Slow requests
 -------------