doc/ceph.rst: scrub-related 'tell pgid' commands

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>

diff --git a/doc/man/8/ceph.rst b/doc/man/8/ceph.rst
index 39830401f3acdf2e407b5af077aae9754ac7a200..0afc3cbbe266c8ae453a477161639c1778bb40c5 100644 (file)
--- a/doc/man/8/ceph.rst
+++ b/doc/man/8/ceph.rst
@@ -59,6 +59,8 @@ Synopsis
 
 | **ceph** **tell** *<name (type.id)> <command> [options...]*
 
+| **ceph** **tell** *<pgid> <command> [options...]*
+
 | **ceph** **version**
 
 Description
@@ -1564,6 +1566,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
 ------