Enhance API tracing (#120)

Enhance API tracing to handle more types, and to put tracing info in a string, allowing it to be used when reporting errors.  Also refactor ref-counted strings (H5RS) module to add capabilities needed for the tracing.  Refactored H5Gname.c routines to use new H5RS routines also.  Added /*out*/ tags to API routines that are returning information to the application.  Updated H5TRACE macros from running updated trace script over library code.  Added tests for new H5RS routines.

1 files changed, 6 insertions, 6 deletions

diff --git a/src/H5G.c b/src/H5G.c
index 935e372..7d8ed39 100644
--- a/src/H5G.c
+++ b/src/H5G.c
@@ -384,7 +384,7 @@ done:
  *-------------------------------------------------------------------------
  */
 herr_t
-H5Gget_info(hid_t loc_id, H5G_info_t *group_info)
+H5Gget_info(hid_t loc_id, H5G_info_t *group_info /*out*/)
 {
     H5VL_object_t *   vol_obj;
     H5I_type_t        id_type; /* Type of ID */
@@ -392,7 +392,7 @@ H5Gget_info(hid_t loc_id, H5G_info_t *group_info)
     herr_t            ret_value = SUCCEED; /* Return value */
 
     FUNC_ENTER_API(FAIL)
-    H5TRACE2("e", "i*x", loc_id, group_info);
+    H5TRACE2("e", "ix", loc_id, group_info);
 
     /* Check args */
     id_type = H5I_get_type(loc_id);
@@ -427,14 +427,14 @@ done:
  *-------------------------------------------------------------------------
  */
 herr_t
-H5Gget_info_by_name(hid_t loc_id, const char *name, H5G_info_t *group_info, hid_t lapl_id)
+H5Gget_info_by_name(hid_t loc_id, const char *name, H5G_info_t *group_info /*out*/, hid_t lapl_id)
 {
     H5VL_object_t *   vol_obj;
     H5VL_loc_params_t loc_params;
     herr_t            ret_value = SUCCEED; /* Return value */
 
     FUNC_ENTER_API(FAIL)
-    H5TRACE4("e", "i*s*xi", loc_id, name, group_info, lapl_id);
+    H5TRACE4("e", "i*sxi", loc_id, name, group_info, lapl_id);
 
     /* Check args */
     if (!name)
@@ -479,14 +479,14 @@ done:
  */
 herr_t
 H5Gget_info_by_idx(hid_t loc_id, const char *group_name, H5_index_t idx_type, H5_iter_order_t order,
-                   hsize_t n, H5G_info_t *group_info, hid_t lapl_id)
+                   hsize_t n, H5G_info_t *group_info /*out*/, hid_t lapl_id)
 {
     H5VL_object_t *   vol_obj;
     H5VL_loc_params_t loc_params;
     herr_t            ret_value = SUCCEED; /* Return value */
 
     FUNC_ENTER_API(FAIL)
-    H5TRACE7("e", "i*sIiIoh*xi", loc_id, group_name, idx_type, order, n, group_info, lapl_id);
+    H5TRACE7("e", "i*sIiIohxi", loc_id, group_name, idx_type, order, n, group_info, lapl_id);
 
     /* Check args */
     if (!group_name)