crimson/osd: document OperationThrottler's behavior towards op's blocker list.

Signed-off-by: Radosław Zarzyński <rzarzyns@redhat.com>

diff --git a/src/crimson/osd/osd_operation.h b/src/crimson/osd/osd_operation.h
index d883af55b8f470b5af82814e55b5061421064634..1eee01554b29ef6134c5f12814fad0622ee69159 100644 (file)
--- a/src/crimson/osd/osd_operation.h
+++ b/src/crimson/osd/osd_operation.h
@@ -183,6 +183,10 @@ class OperationThrottler : public BlockerT<OperationThrottler>,
     F &&f) {
     if (!max_in_progress) return f();
     auto fut = acquire_throttle(params);
+    // At any given moment a particular op can  be blocked by a given
+    // OperationThrottler instance no more than once. This means the
+    // same throtter won't be on the op's blockers list more than one
+    // time.
     return op->with_blocking_future(std::move(fut))
       .then(std::forward<F>(f))
       .then([this](auto x) {