data: Improved memory handling in data_copy().

[sysdb.git] / src / include / core / data.h

diff --git a/src/include/core/data.h b/src/include/core/data.h
index 879af9087db92d7346fee2109326df55eaf25dfc..d6bf3179eb39ddb4cb6d2c74b36bc4f718216cb0 100644 (file)
--- a/src/include/core/data.h
+++ b/src/include/core/data.h
@@ -81,7 +81,8 @@ typedef struct {
  * Copy the datum stored in 'src' to the memory location pointed to by 'dst'.
  * Any dynamic data (strings, binary data) is copied to newly allocated
  * memory. Use, for example, sdb_data_free_datum() to free any dynamic memory
- * stored in a datum.
+ * stored in a datum. On error, 'dst' is unchanged. Else, any dynamic memory
+ * in 'dst' will be freed.
  *
  * Returns:
  *  - 0 on success