]> git-server-git.apps.pok.os.sepia.ceph.com Git - ceph-ci.git/commitdiff
doc/ceph.rst: scrub-related 'tell pgid' commands wip-rf-66515-tentacle
authorRonen Friedman <rfriedma@redhat.com>
Sun, 14 Dec 2025 14:39:39 +0000 (08:39 -0600)
committerRonen Friedman <rfriedma@redhat.com>
Wed, 21 Jan 2026 16:42:31 +0000 (16:42 +0000)
Documenting the recently added 'ceph tell <pgid> scrub-abort'
command.

As this is the first command using the 'tell <pgid>' syntax
that is documented, also adding the two other scrub-related ``tell``
commands.

Note that the 'tell <pgid> scrub-abort' is the only available
format of this specific command. The other two commands
also support the 'tell pg <cmd> <pgid>' format.

Signed-off-by: Ronen Friedman <rfriedma@redhat.com>
(cherry picked from commit 8efed0df0c70fb512dda911c862fd7e7b850e766)

doc/man/8/ceph.rst

index 44f5a923e962674fad1893e020412d64f23b9564..2e057603cd2b2d14839504d6d55c2d89a756e847 100644 (file)
@@ -59,6 +59,8 @@ Synopsis
 
 | **ceph** **tell** *<name (type.id)> <command> [options...]*
 
+| **ceph** **tell** *<pgid> <command> [options...]*
+
 | **ceph** **version**
 
 Description
@@ -1563,6 +1565,32 @@ Usage::
 
        ceph pg stat
 
+A second format for PG-directed commands is the following:
+
+Using the ``tell`` command with a PG identifier. This sends a command to the OSD
+that is currently acting as the primary for the specified PG.
+
+Subcommand ``scrub`` starts a scrub of <pgid>, similar
+to ``ceph pg scrub <pgid>``.
+
+Usage::
+
+       ceph tell <pgid> scrub
+
+Subcommand ``deep-scrub`` starts a deep-scrub of <pgid>, similar
+to ``ceph pg deep-scrub <pgid>``.
+
+Usage::
+
+       ceph tell <pgid> deep-scrub
+
+Subcommand ``scrub-abort`` aborts any ongoing scrub of <pgid>, and removes
+any previous scrub or deep scrub operator request for the PG.
+
+Usage::
+
+       ceph tell <pgid> scrub-abort
+
 
 quorum
 ------