doc: add doxygen help for crush_get_bucket_item_weight

Signed-off-by: Loic Dachary <ldachary@redhat.com>

diff --git a/src/crush/crush.h b/src/crush/crush.h
index 234f81b6585289cd49a5c65f303a106274836bee..677ff565d148f30fafdbc534d16062c63a737340 100644 (file)
--- a/src/crush/crush.h
+++ b/src/crush/crush.h
@@ -376,6 +376,17 @@ struct crush_map {
 
 
 /* crush.c */
+/** @ingroup API
+ *
+ * Return the 16.16 fixed point weight of the item at __pos__ (zero
+ * based index) within the bucket __b__. If __pos__ is negative or
+ * greater or equal to the number of items in the bucket, return 0.
+ *
+ * @param b the bucket containing items
+ * @param pos the zero based index of the item
+ *
+ * @returns the 16.16 fixed point item weight
+ */
 extern int crush_get_bucket_item_weight(const struct crush_bucket *b, int pos);
 extern void crush_destroy_bucket_uniform(struct crush_bucket_uniform *b);
 extern void crush_destroy_bucket_list(struct crush_bucket_list *b);