From: Sage Weil <sage@inktank.com>
Date: Thu, 28 Mar 2013 23:01:55 +0000 (-0700)
Subject: librados: document list_snaps
X-Git-Tag: v0.62~118^2~27
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=10dc0ad09fe6441e21c491ea83572c59042d503c;p=ceph.git

librados: document list_snaps

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

diff --git a/src/include/rados/librados.hpp b/src/include/rados/librados.hpp
index f77cc48a7ece..2bb50f110fcb 100644
--- a/src/include/rados/librados.hpp
+++ b/src/include/rados/librados.hpp
@@ -328,6 +328,21 @@ namespace librados
      * @param prval [out] place error code in prval upon completion
      */
     void list_watchers(std::list<obj_watch_t> *out_watchers, int *prval);
+
+    /**
+     * list snapshot clones associated with a logical object
+     *
+     * This will include a record for each version of the object,
+     * include the "HEAD" (which will have a cloneid of
+     * librados::clone_info_t::HEAD).  Each clone includes a vector
+     * of snap ids for which it is defined to exist.
+     *
+     * NOTE: this operation must be submitted from an IoCtx with a
+     * read snapid of CEPH_SNAPDIR for reliable results.
+     *
+     * @param out_snaps [out] pointer to resulting snap_set_t
+     * @param prval [out] place error code in prval upon completion
+     */
     void list_snaps(snap_set_t *out_snaps, int *prval);
 
   };