From 252952ff339bd928cc4e5ed34958d2845365b397 Mon Sep 17 00:00:00 2001
From: "Bryn M. Reeves" <bmr@redhat.com>
Date: Mon, 18 Jul 2016 18:20:01 +0100
Subject: [PATCH] libdm: document use of dm_free() with histogram bounds

---
 libdm/libdevmapper.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/libdm/libdevmapper.h b/libdm/libdevmapper.h
index 0f61f9c83..22700160a 100644
--- a/libdm/libdevmapper.h
+++ b/libdm/libdevmapper.h
@@ -805,6 +805,10 @@ int dm_stats_get_region_nr_histogram_bins(const struct dm_stats *dms,
  * magnitude is one milisecond: attempting to use a histogram with a
  * boundary less than one milisecond when creating a region will cause
  * the region to be created with the precise_timestamps feature enabled.
+ *
+ * On sucess a pointer to the struct dm_histogram representing the
+ * bounds values is returned, or NULL in the case of error. The returned
+ * pointer should be freed using dm_free() when no longer required.
  */
 struct dm_histogram *dm_histogram_bounds_from_string(const char *bounds_str);