]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
osd/PeeringState: document prepare_stats_for_publish()
authorKefu Chai <kchai@redhat.com>
Thu, 28 Jan 2021 05:08:51 +0000 (13:08 +0800)
committerKefu Chai <kchai@redhat.com>
Thu, 28 Jan 2021 12:57:23 +0000 (20:57 +0800)
document its parameters

Signed-off-by: Kefu Chai <kchai@redhat.com>
src/osd/PeeringState.h

index a74b65eafa6ac54a391cd890038657de14417ca9..2cae797d62d10f4434fd456583dce4b750089d03 100644 (file)
@@ -1825,6 +1825,12 @@ public:
    *
    * Returns updated pg_stat_t if stats have changed since
    * pg_stats_publish adding in unstable_stats.
+   *
+   * @param pg_stats_publish the latest pg_stat possessed by caller
+   * @param unstable_stats additional stats which should be included in the
+   *        returned stats
+   * @return the up to date stats if it is different from the specfied
+   *         @c pg_stats_publish
    */
   std::optional<pg_stat_t> prepare_stats_for_publish(
     const std::optional<pg_stat_t> &pg_stats_publish,