documentation: add the mark_unfound_lost delete option

Signed-off-by: Loic Dachary <loic-201408@dachary.org>

diff --git a/doc/rados/operations/control.rst b/doc/rados/operations/control.rst
index 7f651aff740f1cc69b185e5e09c2c561004e967c..f3d7b7c886c883a78d4fc5dfbf4f2bff060adbda 100644 (file)
--- a/doc/rados/operations/control.rst
+++ b/doc/rados/operations/control.rst
@@ -82,10 +82,10 @@ of times. They should be recovering.
 reported to the monitor cluster in a while (configured by
 ``mon_osd_report_timeout``).
 
-Revert "lost" objects to their prior state, either a previous version
+Delete "lost" objects or revert them to their prior state, either a previous version
 or delete them if they were just created. ::
 
-       ceph pg {pgid} mark_unfound_lost revert
+       ceph pg {pgid} mark_unfound_lost revert|delete
 
 
 OSD Subsystem

diff --git a/doc/rados/operations/placement-groups.rst b/doc/rados/operations/placement-groups.rst
index 0fa0f1212cc60b650fa26c2f4b5a864609ee1f6e..64e1548dbba7feb13d1b7f4cbb8bcd120b793c2a 100644 (file)
--- a/doc/rados/operations/placement-groups.rst
+++ b/doc/rados/operations/placement-groups.rst
@@ -186,7 +186,7 @@ Currently the only supported option is "revert", which will either roll back to
 a previous version of the object or (if it was a new object) forget about it
 entirely. To mark the "unfound" objects as "lost", execute the following::
 
-       ceph pg {pg-id} mark_unfound_lost revert
+       ceph pg {pg-id} mark_unfound_lost revert|delete
        
 .. important:: Use this feature with caution, because it may confuse 
    applications that expect the object(s) to exist.

diff --git a/doc/rados/troubleshooting/troubleshooting-pg.rst b/doc/rados/troubleshooting/troubleshooting-pg.rst
index 10f2d2d992035205ed09382c063746621245a665..3c4b4224061f4574d0e8a9220393dcc6ec4e964c 100644 (file)
--- a/doc/rados/troubleshooting/troubleshooting-pg.rst
+++ b/doc/rados/troubleshooting/troubleshooting-pg.rst
@@ -277,13 +277,17 @@ possible given unusual combinations of failures that allow the cluster
 to learn about writes that were performed before the writes themselves
 are recovered.  To mark the "unfound" objects as "lost"::
 
-       ceph pg 2.5 mark_unfound_lost revert
+       ceph pg 2.5 mark_unfound_lost revert|delete
 
 This the final argument specifies how the cluster should deal with
-lost objects.  Currently the only supported option is "revert", which
-will either roll back to a previous version of the object or (if it
-was a new object) forget about it entirely.  Use this with caution, as
-it may confuse applications that expected the object to exist.
+lost objects.  
+
+The "delete" option will forget about them entirely.
+
+The "revert" option (not available for erasure coded pools) will
+either roll back to a previous version of the object or (if it was a
+new object) forget about it entirely.  Use this with caution, as it
+may confuse applications that expected the object to exist.
 
 
 Homeless Placement Groups