]> git.apps.os.sepia.ceph.com Git - ceph-ci.git/commitdiff
doc/cephfs: edit troubleshooting.rst
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:49:02 +0000 (23:49 +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 c1aa34bddc794b24c615fdaef73ab3a7909cf6bc..2a2312911e4659936f5e2e240c6828ec05f87c47 100644 (file)
@@ -321,10 +321,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
 -------------