From: Sage Weil <sage@redhat.com>
Date: Tue, 12 Dec 2017 22:22:16 +0000 (-0600)
Subject: osd: document split tracking structures a bit
X-Git-Tag: v13.0.2~510^2~14
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=d44dcf4e004c680182821dec45faa7d6f70e4591;p=ceph.git

osd: document split tracking structures a bit

Signed-off-by: Sage Weil <sage@redhat.com>
---

diff --git a/src/osd/OSD.h b/src/osd/OSD.h
index 2d10d6f3b032..e4517873e89b 100644
--- a/src/osd/OSD.h
+++ b/src/osd/OSD.h
@@ -913,8 +913,13 @@ public:
 private:
   // split
   Mutex in_progress_split_lock;
+  // splits are "pending" after OSD has consumed the map indicating the PG should
+  // split but the PG has not yet processed the map.
   map<spg_t, spg_t> pending_splits; // child -> parent
   map<spg_t, set<spg_t> > rev_pending_splits; // parent -> [children]
+
+  // splits are "in progress" after the PG has gotten the map, and we hold the
+  // parent lock, but the children have not yet been created.
   set<spg_t> in_progress_splits;       // child
 
 public: