diff options
author | Quincey Koziol <koziol@hdfgroup.org> | 2006-11-13 16:43:29 (GMT) |
---|---|---|
committer | Quincey Koziol <koziol@hdfgroup.org> | 2006-11-13 16:43:29 (GMT) |
commit | 174f0dab3fea49f4c99fedcf2c5b60902061648d (patch) | |
tree | bca9291cbcb8d28565c82423c345fb955da9c067 /src/H5Glink.c | |
parent | 3f25d6c6d1ae867a93ea904fe9bbf0f744ac052c (diff) | |
download | hdf5-174f0dab3fea49f4c99fedcf2c5b60902061648d.zip hdf5-174f0dab3fea49f4c99fedcf2c5b60902061648d.tar.gz hdf5-174f0dab3fea49f4c99fedcf2c5b60902061648d.tar.bz2 |
[svn-r12896] Description:
Move compact storage routines into separate file, to make room for internal
routines that operate on links within group operations.
Tested on:
Linux/32 2.6 (chicago)
Diffstat (limited to 'src/H5Glink.c')
-rw-r--r-- | src/H5Glink.c | 737 |
1 files changed, 155 insertions, 582 deletions
diff --git a/src/H5Glink.c b/src/H5Glink.c index 17b8f0a..0600e97 100644 --- a/src/H5Glink.c +++ b/src/H5Glink.c @@ -15,90 +15,77 @@ /*------------------------------------------------------------------------- * * Created: H5Glink.c - * Sep 5 2005 - * Quincey Koziol <koziol@ncsa.uiuc.edu> + * Nov 13 2006 + * Quincey Koziol <koziol@hdfgroup.org> * - * Purpose: Functions for handling link messages. + * Purpose: Functions for handling links in groups. * *------------------------------------------------------------------------- */ + +/****************/ +/* Module Setup */ +/****************/ + #define H5G_PACKAGE /*suppress error about including H5Gpkg */ -/* Packages needed by this file... */ +/***********/ +/* Headers */ +/***********/ #include "H5private.h" /* Generic Functions */ #include "H5Eprivate.h" /* Error handling */ #include "H5Gpkg.h" /* Groups */ #include "H5HLprivate.h" /* Local Heaps */ -#include "H5Iprivate.h" /* IDs */ -#include "H5MMprivate.h" /* Memory management */ - -/* Private typedefs */ - -/* User data for link message iteration when building link table */ -typedef struct { - H5G_link_table_t *ltable; /* Pointer to link table to build */ - size_t curr_lnk; /* Current link to operate on */ -} H5G_link_ud1_t; - -/* User data for deleting a link in the link messages */ -typedef struct { - /* downward */ - const char *name; /* Name to search for */ - H5F_t *file; /* File that object header is located within */ - hid_t dxpl_id; /* DXPL during insertion */ - - /* upward */ - H5G_obj_t *obj_type; /* Type of object deleted */ -} H5G_link_ud2_t; - -/* User data for link message iteration when querying object info */ -typedef struct { - /* downward */ - const char *name; /* Name to search for */ - H5F_t *file; /* File that object header is located within */ - hid_t dxpl_id; /* DXPL during insertion */ - - /* upward */ - H5G_stat_t *statbuf; /* Stat buffer for info */ -} H5G_link_ud3_t; - -/* User data for link message iteration when querying object location */ -typedef struct { - /* downward */ - const char *name; /* Name to search for */ - - /* upward */ - H5O_link_t *lnk; /* Link struct to fill in */ - hbool_t found; /* Flag to indicate that the object was found */ -} H5G_link_ud4_t; - -/* User data for link message iteration when querying soft link value */ -typedef struct { - /* downward */ - const char *name; /* Name to search for */ - size_t size; /* Buffer size for link value */ - - /* upward */ - char *buf; /* Buffer to fill with link value */ -} H5G_link_ud5_t; - -/* Private macros */ - -/* PRIVATE PROTOTYPES */ -static herr_t H5G_link_build_table_cb(const void *_mesg, unsigned idx, void *_udata); -static herr_t H5G_link_build_table(H5O_loc_t *oloc, hid_t dxpl_id, - const H5O_linfo_t *linfo, H5L_index_t idx_type, H5_iter_order_t order, - H5G_link_table_t *ltable); + + +/****************/ +/* Local Macros */ +/****************/ + + +/******************/ +/* Local Typedefs */ +/******************/ + + +/********************/ +/* Package Typedefs */ +/********************/ + + +/********************/ +/* Local Prototypes */ +/********************/ + + +/*********************/ +/* Package Variables */ +/*********************/ + + +/*****************************/ +/* Library Private Variables */ +/*****************************/ + + +/*******************/ +/* Local Variables */ +/*******************/ + /*------------------------------------------------------------------------- - * Function: H5G_link_build_table_cb + * Function: H5G_link_cmp_name_inc * - * Purpose: Callback routine for searching 'link' messages for a particular - * name. + * Purpose: Callback routine for comparing two link names, in + * increasing alphabetic order * - * Return: Non-negative on success/Negative on failure + * Return: An integer less than, equal to, or greater than zero if the + * first argument is considered to be respectively less than, + * equal to, or greater than the second. If two members compare + * as equal, their order in the sorted array is undefined. + * (i.e. same as strcmp()) * * Programmer: Quincey Koziol * koziol@ncsa.uiuc.edu @@ -106,103 +93,110 @@ static herr_t H5G_link_build_table(H5O_loc_t *oloc, hid_t dxpl_id, * *------------------------------------------------------------------------- */ -static herr_t -H5G_link_build_table_cb(const void *_mesg, unsigned UNUSED idx, void *_udata) +int +H5G_link_cmp_name_inc(const void *lnk1, const void *lnk2) { - const H5O_link_t *lnk = (const H5O_link_t *)_mesg; /* Pointer to link */ - H5G_link_ud1_t *udata = (H5G_link_ud1_t *)_udata; /* 'User data' passed in */ - herr_t ret_value=H5O_ITER_CONT; /* Return value */ + FUNC_ENTER_NOAPI_NOINIT_NOFUNC(H5G_link_cmp_name_inc) - FUNC_ENTER_NOAPI_NOINIT(H5G_link_build_table_cb) + FUNC_LEAVE_NOAPI(HDstrcmp(((const H5O_link_t *)lnk1)->name, ((const H5O_link_t *)lnk2)->name)) +} /* end H5G_link_cmp_name_inc() */ - /* check arguments */ - HDassert(lnk); - HDassert(udata); - HDassert(udata->curr_lnk < udata->ltable->nlinks); + +/*------------------------------------------------------------------------- + * Function: H5G_link_cmp_name_dec + * + * Purpose: Callback routine for comparing two link names, in + * decreasing alphabetic order + * + * Return: An integer less than, equal to, or greater than zero if the + * second argument is considered to be respectively less than, + * equal to, or greater than the first. If two members compare + * as equal, their order in the sorted array is undefined. + * (i.e. opposite strcmp()) + * + * Programmer: Quincey Koziol + * koziol@ncsa.uiuc.edu + * Sep 25 2006 + * + *------------------------------------------------------------------------- + */ +int +H5G_link_cmp_name_dec(const void *lnk1, const void *lnk2) +{ + FUNC_ENTER_NOAPI_NOINIT_NOFUNC(H5G_link_cmp_name_dec) + + FUNC_LEAVE_NOAPI(HDstrcmp(((const H5O_link_t *)lnk2)->name, ((const H5O_link_t *)lnk1)->name)) +} /* end H5G_link_cmp_name_dec() */ - /* Copy link message into table */ - if(NULL == H5O_copy(H5O_LINK_ID, lnk, &(udata->ltable->lnks[udata->curr_lnk]))) - HGOTO_ERROR(H5E_SYM, H5E_CANTCOPY, H5O_ITER_ERROR, "can't copy link message") + +/*------------------------------------------------------------------------- + * Function: H5G_link_cmp_corder_inc + * + * Purpose: Callback routine for comparing two link creation orders, in + * increasing order + * + * Return: An integer less than, equal to, or greater than zero if the + * first argument is considered to be respectively less than, + * equal to, or greater than the second. If two members compare + * as equal, their order in the sorted array is undefined. + * + * Programmer: Quincey Koziol + * koziol@hdfgroup.org + * Nov 6 2006 + * + *------------------------------------------------------------------------- + */ +int +H5G_link_cmp_corder_inc(const void *lnk1, const void *lnk2) +{ + int ret_value; /* Return value */ - /* Increment current link entry to operate on */ - udata->curr_lnk++; + FUNC_ENTER_NOAPI_NOINIT_NOFUNC(H5G_link_cmp_corder_inc) + + if(((const H5O_link_t *)lnk1)->corder < ((const H5O_link_t *)lnk2)->corder) + ret_value = -1; + else if(((const H5O_link_t *)lnk1)->corder > ((const H5O_link_t *)lnk2)->corder) + ret_value = 1; + else + ret_value = 0; -done: FUNC_LEAVE_NOAPI(ret_value) -} /* end H5G_link_build_table_cb() */ +} /* end H5G_link_cmp_corder_inc() */ /*------------------------------------------------------------------------- - * Function: H5G_link_build_table + * Function: H5G_link_cmp_corder_dec * - * Purpose: Builds a table containing a sorted (alphabetically) list of - * links for a group + * Purpose: Callback routine for comparing two link creation orders, in + * decreasing order * - * Return: Success: Non-negative - * Failure: Negative + * Return: An integer less than, equal to, or greater than zero if the + * second argument is considered to be respectively less than, + * equal to, or greater than the first. If two members compare + * as equal, their order in the sorted array is undefined. * * Programmer: Quincey Koziol - * Sep 6, 2005 + * koziol@hdfgroup.org + * Nov 6 2006 * *------------------------------------------------------------------------- */ -static herr_t -H5G_link_build_table(H5O_loc_t *oloc, hid_t dxpl_id, const H5O_linfo_t *linfo, - H5L_index_t idx_type, H5_iter_order_t order, H5G_link_table_t *ltable) +int +H5G_link_cmp_corder_dec(const void *lnk1, const void *lnk2) { - herr_t ret_value = SUCCEED; /* Return value */ - - FUNC_ENTER_NOAPI_NOINIT(H5G_link_build_table) - - /* Sanity check */ - HDassert(oloc); - HDassert(linfo); - HDassert(ltable); + int ret_value; /* Return value */ - /* Set size of table */ - H5_CHECK_OVERFLOW(linfo->nlinks, hsize_t, size_t); - ltable->nlinks = (size_t)linfo->nlinks; + FUNC_ENTER_NOAPI_NOINIT_NOFUNC(H5G_link_cmp_corder_dec) - /* Allocate space for the table entries */ - if(ltable->nlinks > 0) { - H5G_link_ud1_t udata; /* User data for iteration callback */ - - if((ltable->lnks = H5MM_malloc(sizeof(H5O_link_t) * ltable->nlinks)) == NULL) - HGOTO_ERROR(H5E_RESOURCE, H5E_NOSPACE, FAIL, "memory allocation failed") - - /* Set up user data for iteration */ - udata.ltable = ltable; - udata.curr_lnk = 0; - - /* Iterate through the link messages, adding them to the table */ - if(H5O_iterate(oloc, H5O_LINK_ID, H5G_link_build_table_cb, &udata, dxpl_id) < 0) - HGOTO_ERROR(H5E_SYM, H5E_NOTFOUND, FAIL, "error iterating over link messages") - - /* Sort link table in correct iteration order */ - if(idx_type == H5L_INDEX_NAME) { - if(order == H5_ITER_INC) - HDqsort(ltable->lnks, ltable->nlinks, sizeof(H5O_link_t), H5G_obj_cmp_name_inc); - else if(order == H5_ITER_DEC) - HDqsort(ltable->lnks, ltable->nlinks, sizeof(H5O_link_t), H5G_obj_cmp_name_dec); - else - HDassert(order == H5_ITER_NATIVE); - } /* end if */ - else { - HDassert(idx_type == H5L_INDEX_CRT_ORDER); - if(order == H5_ITER_INC) - HDqsort(ltable->lnks, ltable->nlinks, sizeof(H5O_link_t), H5G_obj_cmp_corder_inc); - else if(order == H5_ITER_DEC) - HDqsort(ltable->lnks, ltable->nlinks, sizeof(H5O_link_t), H5G_obj_cmp_corder_dec); - else - HDassert(order == H5_ITER_NATIVE); - } /* end else */ - } /* end if */ + if(((const H5O_link_t *)lnk1)->corder < ((const H5O_link_t *)lnk2)->corder) + ret_value = 1; + else if(((const H5O_link_t *)lnk1)->corder > ((const H5O_link_t *)lnk2)->corder) + ret_value = -1; else - ltable->lnks = NULL; + ret_value = 0; -done: FUNC_LEAVE_NOAPI(ret_value) -} /* end H5G_link_build_table() */ +} /* end H5G_link_cmp_corder_dec() */ /*------------------------------------------------------------------------- @@ -384,464 +378,43 @@ done: /*------------------------------------------------------------------------- - * Function: H5G_link_insert + * Function: H5G_link_release_table * - * Purpose: Insert a new symbol into the table described by GRP_ENT in - * file F. The name of the new symbol is NAME and its symbol - * table entry is OBJ_ENT. - * - * Return: Non-negative on success/Negative on failure - * - * Programmer: Quincey Koziol - * koziol@ncsa.uiuc.edu - * Sep 6 2005 - * - *------------------------------------------------------------------------- - */ -herr_t -H5G_link_insert(H5O_loc_t *grp_oloc, H5O_link_t *obj_lnk, - hid_t dxpl_id) -{ - herr_t ret_value = SUCCEED; /* Return value */ - - FUNC_ENTER_NOAPI(H5G_link_insert, FAIL) - - /* check arguments */ - HDassert(grp_oloc && grp_oloc->file); - HDassert(obj_lnk); - - /* Insert link message into group */ - if(H5O_modify(grp_oloc, H5O_LINK_ID, H5O_NEW_MESG, 0, H5O_UPDATE_TIME, obj_lnk, dxpl_id) < 0) - HGOTO_ERROR(H5E_SYM, H5E_CANTINIT, FAIL, "can't create message") - -done: - FUNC_LEAVE_NOAPI(ret_value) -} /* end H5G_link_insert() */ - - -/*------------------------------------------------------------------------- - * Function: H5G_link_get_name_by_idx - * - * Purpose: Returns the name of objects in the group by giving index. - * - * Return: Success: Non-negative, length of name - * Failure: Negative - * - * Programmer: Quincey Koziol - * Sep 6, 2005 - * - *------------------------------------------------------------------------- - */ -ssize_t -H5G_link_get_name_by_idx(H5O_loc_t *oloc, hid_t dxpl_id, - const H5O_linfo_t *linfo, H5L_index_t idx_type, H5_iter_order_t order, - hsize_t idx, char* name, size_t size) -{ - H5G_link_table_t ltable = {0, NULL}; /* Link table */ - ssize_t ret_value; /* Return value */ - - FUNC_ENTER_NOAPI(H5G_link_get_name_by_idx, FAIL) - - /* Sanity check */ - HDassert(oloc); - - /* Build table of all link messages */ - if(H5G_link_build_table(oloc, dxpl_id, linfo, idx_type, order, <able) < 0) - HGOTO_ERROR(H5E_SYM, H5E_CANTINIT, FAIL, "can't create link message table") - - /* Check for going out of bounds */ - if(idx >= ltable.nlinks) - HGOTO_ERROR(H5E_ARGS, H5E_BADVALUE, FAIL, "index out of bound") - - /* Get the length of the name */ - ret_value = (ssize_t)HDstrlen(ltable.lnks[idx].name); - - /* Copy the name into the user's buffer, if given */ - if(name) { - HDstrncpy(name, ltable.lnks[idx].name, MIN((size_t)(ret_value + 1), size)); - if((size_t)ret_value >= size) - name[size - 1]='\0'; - } /* end if */ - -done: - /* Release link table */ - if(ltable.lnks) - /* Free link table information */ - if(H5G_obj_release_table(<able) < 0) - HDONE_ERROR(H5E_SYM, H5E_CANTFREE, FAIL, "unable to release link table") - - FUNC_LEAVE_NOAPI(ret_value) -} /* end H5G_link_get_name_by_idx() */ - - -/*------------------------------------------------------------------------- - * Function: H5G_link_get_type_by_idx - * - * Purpose: Returns the type of objects in the group by giving index. + * Purpose: Release table containing a list of links for a group * * Return: Success: Non-negative * Failure: Negative * * Programmer: Quincey Koziol - * Sep 12, 2005 - * - *------------------------------------------------------------------------- - */ -H5G_obj_t -H5G_link_get_type_by_idx(H5O_loc_t *oloc, hid_t dxpl_id, const H5O_linfo_t *linfo, - hsize_t idx) -{ - H5G_link_table_t ltable = {0, NULL}; /* Link table */ - H5G_obj_t ret_value; /* Return value */ - - FUNC_ENTER_NOAPI(H5G_link_get_type_by_idx, H5G_UNKNOWN) - - /* Sanity check */ - HDassert(oloc); - - /* Build table of all link messages */ - if(H5G_link_build_table(oloc, dxpl_id, linfo, H5L_INDEX_NAME, H5_ITER_INC, <able) < 0) - HGOTO_ERROR(H5E_SYM, H5E_CANTINIT, H5G_UNKNOWN, "can't create link message table") - - /* Check for going out of bounds */ - if(idx >= ltable.nlinks) - HGOTO_ERROR(H5E_ARGS, H5E_BADRANGE, H5G_UNKNOWN, "index out of bound") - - /* Determine type of object */ - if(ltable.lnks[idx].type == H5L_TYPE_SOFT) - ret_value = H5G_LINK; - else if(ltable.lnks[idx].type >= H5L_TYPE_UD_MIN) - ret_value = H5G_UDLINK; - else if(ltable.lnks[idx].type == H5L_TYPE_HARD){ - H5O_loc_t tmp_oloc; /* Temporary object location */ - - /* Build temporary object location */ - tmp_oloc.file = oloc->file; - tmp_oloc.addr = ltable.lnks[idx].u.hard.addr; - - /* Get the type of the object */ - if((ret_value = H5O_obj_type(&tmp_oloc, dxpl_id)) == H5G_UNKNOWN) - HGOTO_ERROR(H5E_SYM, H5E_BADTYPE, H5G_UNKNOWN, "can't determine object type") - } else { - HGOTO_ERROR(H5E_SYM, H5E_BADTYPE, H5G_UNKNOWN, "unknown link type") - } /* end else */ - -done: - /* Release link table */ - if(ltable.lnks) - /* Free link table information */ - if(H5G_obj_release_table(<able) < 0) - HDONE_ERROR(H5E_SYM, H5E_CANTFREE, H5G_UNKNOWN, "unable to release link table") - - FUNC_LEAVE_NOAPI(ret_value) -} /* end H5G_link_get_type_by_idx() */ - - -/*------------------------------------------------------------------------- - * Function: H5G_link_remove_cb - * - * Purpose: Callback routine for deleting 'link' message for a particular - * name. - * - * Return: Non-negative on success/Negative on failure - * - * Programmer: Quincey Koziol - * koziol@ncsa.uiuc.edu - * Sep 5 2005 - * - *------------------------------------------------------------------------- - */ -static herr_t -H5G_link_remove_cb(const void *_mesg, unsigned UNUSED idx, void *_udata) -{ - const H5O_link_t *lnk = (const H5O_link_t *)_mesg; /* Pointer to link */ - H5G_link_ud2_t *udata = (H5G_link_ud2_t *)_udata; /* 'User data' passed in */ - herr_t ret_value = H5O_ITER_CONT; /* Return value */ - - FUNC_ENTER_NOAPI_NOINIT(H5G_link_remove_cb) - - /* check arguments */ - HDassert(lnk); - HDassert(udata); - - /* If we've found the right link, get the object type */ - if(HDstrcmp(lnk->name, udata->name) == 0) { - switch(lnk->type) - { - case H5L_TYPE_HARD: - { - H5O_loc_t tmp_oloc; /* Temporary object location */ - - /* Build temporary object location */ - tmp_oloc.file = udata->file; - tmp_oloc.addr = lnk->u.hard.addr; - - /* Get the type of the object */ - /* Note: no way to check for error :-( */ - *(udata->obj_type) = H5O_obj_type(&tmp_oloc, udata->dxpl_id); - } - break; - - case H5L_TYPE_SOFT: - *(udata->obj_type) = H5G_LINK; - break; - - default: /* User-defined link */ - if(lnk->type < H5L_TYPE_UD_MIN) - HGOTO_ERROR(H5E_SYM, H5E_BADVALUE, FAIL, "unknown link type") - - *(udata->obj_type) = H5G_UDLINK; - } - /* Stop the iteration, we found the correct link */ - HGOTO_DONE(H5O_ITER_STOP) - } /* end if */ - -done: - FUNC_LEAVE_NOAPI(ret_value) -} /* end H5G_link_remove_cb() */ - - -/*------------------------------------------------------------------------- - * Function: H5G_link_remove - * - * Purpose: Remove NAME from links. - * - * Return: Non-negative on success/Negative on failure - * - * Programmer: Quincey Koziol - * Monday, September 19, 2005 - * - *------------------------------------------------------------------------- - */ -herr_t -H5G_link_remove(const H5O_loc_t *oloc, const char *name, H5G_obj_t *obj_type, - hid_t dxpl_id) -{ - H5G_link_ud2_t udata; /* Data to pass through OH iteration */ - herr_t ret_value = SUCCEED; /* Return value */ - - FUNC_ENTER_NOAPI(H5G_link_remove, FAIL) - - HDassert(oloc && oloc->file); - HDassert(name && *name); - - /* Initialize data to pass through object header iteration */ - udata.name = name; - udata.file = oloc->file; - udata.dxpl_id = dxpl_id; - udata.obj_type = obj_type; - - /* Iterate over the link messages to delete the right one */ - if(H5O_remove_op(oloc, H5O_LINK_ID, H5O_FIRST, H5G_link_remove_cb, &udata, TRUE, dxpl_id) < 0) - HGOTO_ERROR(H5E_SYM, H5E_CANTDELETE, FAIL, "unable to delete link message") - -done: - FUNC_LEAVE_NOAPI(ret_value) -} /* end H5G_link_remove() */ - - -/*------------------------------------------------------------------------- - * Function: H5G_link_iterate - * - * Purpose: Iterate over the links in a group - * - * Return: Non-negative on success/Negative on failure - * - * Programmer: Quincey Koziol - * Monday, October 3, 2005 + * Sep 6, 2005 * *------------------------------------------------------------------------- */ herr_t -H5G_link_iterate(H5O_loc_t *oloc, hid_t dxpl_id, const H5O_linfo_t *linfo, - H5_iter_order_t order, hid_t gid, hbool_t lib_internal, int skip, - int *last_obj, H5G_link_iterate_t op, void *op_data) +H5G_link_release_table(H5G_link_table_t *ltable) { - H5G_link_table_t ltable = {0, NULL}; /* Link table */ - size_t u; /* Local index variable */ - herr_t ret_value; + size_t u; /* Local index variable */ + herr_t ret_value = SUCCEED; /* Return value */ - FUNC_ENTER_NOAPI(H5G_link_iterate, FAIL) + FUNC_ENTER_NOAPI_NOINIT(H5G_link_release_table) /* Sanity check */ - HDassert(oloc); - HDassert(lib_internal || H5I_GROUP == H5I_get_type(gid)); - HDassert(op.lib_op); - - /* Build table of all link messages */ - if(H5G_link_build_table(oloc, dxpl_id, linfo, H5L_INDEX_NAME, order, <able) < 0) - HGOTO_ERROR(H5E_SYM, H5E_CANTINIT, FAIL, "can't create link message table") - - /* Iterate over link messages */ - for(u = 0, ret_value = H5B_ITER_CONT; u < ltable.nlinks && !ret_value; u++) { - if(skip > 0) - --skip; - else { - /* Check for internal callback with link info */ - if(lib_internal) - ret_value = (op.lib_op)(&(ltable.lnks[u]), op_data); - else - ret_value = (op.app_op)(gid, ltable.lnks[u].name, op_data); - } /* end else */ - - /* Increment the number of entries passed through */ - /* (whether we skipped them or not) */ - (*last_obj)++; - } /* end for */ - - /* Check for callback failure and pass along return value */ - if(ret_value < 0) - HERROR(H5E_SYM, H5E_CANTNEXT, "iteration operator failed"); - -done: - /* Release link table */ - if(ltable.lnks) - /* Free link table information */ - if(H5G_obj_release_table(<able) < 0) - HDONE_ERROR(H5E_SYM, H5E_CANTFREE, FAIL, "unable to release link table") - - FUNC_LEAVE_NOAPI(ret_value) -} /* end H5G_link_iterate() */ - - -/*------------------------------------------------------------------------- - * Function: H5G_link_lookup_cb - * - * Purpose: Callback routine for searching 'link' messages for a particular - * name & gettting object location for it - * - * Return: Non-negative on success/Negative on failure - * - * Programmer: Quincey Koziol - * koziol@ncsa.uiuc.edu - * Sep 20 2005 - * - *------------------------------------------------------------------------- - */ -static herr_t -H5G_link_lookup_cb(const void *_mesg, unsigned UNUSED idx, void *_udata) -{ - const H5O_link_t *lnk = (const H5O_link_t *)_mesg; /* Pointer to link */ - H5G_link_ud4_t *udata = (H5G_link_ud4_t *)_udata; /* 'User data' passed in */ - herr_t ret_value = H5O_ITER_CONT; /* Return value */ - - FUNC_ENTER_NOAPI_NOINIT(H5G_link_lookup_cb) - - /* check arguments */ - HDassert(lnk); - HDassert(udata); - - /* Check for name to get information */ - if(HDstrcmp(lnk->name, udata->name) == 0) { - if(udata->lnk) { - /* Copy link information */ - if(NULL == H5O_copy(H5O_LINK_ID, lnk, udata->lnk)) - HGOTO_ERROR(H5E_SYM, H5E_CANTCOPY, H5O_ITER_ERROR, "can't copy link message") - } /* end if */ + HDassert(ltable); - /* Indicate that the correct link was found */ - udata->found = TRUE; + /* Release link info, if any */ + if(ltable->nlinks > 0) { + /* Free link message information */ + for(u = 0; u < ltable->nlinks; u++) + if(H5O_reset(H5O_LINK_ID, &(ltable->lnks[u])) < 0) + HGOTO_ERROR(H5E_SYM, H5E_CANTFREE, FAIL, "unable to release link message") - /* Stop iteration now */ - HGOTO_DONE(H5O_ITER_STOP) + /* Free table of links */ + H5MM_xfree(ltable->lnks); } /* end if */ + else + HDassert(ltable->lnks == NULL); done: FUNC_LEAVE_NOAPI(ret_value) -} /* end H5G_link_lookup_cb() */ - - -/*------------------------------------------------------------------------- - * Function: H5G_link_lookup - * - * Purpose: Look up an object relative to a group, using link messages. - * - * Return: Non-negative on success/Negative on failure - * - * Programmer: Quincey Koziol - * koziol@ncsa.uiuc.edu - * Sep 20 2005 - * - *------------------------------------------------------------------------- - */ -herr_t -H5G_link_lookup(H5O_loc_t *oloc, const char *name, H5O_link_t *lnk, - hid_t dxpl_id) -{ - H5G_link_ud4_t udata; /* User data for iteration callback */ - herr_t ret_value = SUCCEED; /* Return value */ - - FUNC_ENTER_NOAPI(H5G_link_lookup, FAIL) - - /* check arguments */ - HDassert(lnk && oloc->file); - HDassert(name && *name); - - /* Set up user data for iteration */ - udata.name = name; - udata.lnk = lnk; - udata.found = FALSE; - - /* Iterate through the link messages, adding them to the table */ - if(H5O_iterate(oloc, H5O_LINK_ID, H5G_link_lookup_cb, &udata, dxpl_id) < 0) - HGOTO_ERROR(H5E_SYM, H5E_NOTFOUND, FAIL, "error iterating over link messages") - - /* Check if we found the link we were looking for */ - if(!udata.found) - HGOTO_ERROR(H5E_SYM, H5E_NOTFOUND, FAIL, "object not found") - -done: - FUNC_LEAVE_NOAPI(ret_value) -} /* end H5G_link_lookup() */ - - -/*------------------------------------------------------------------------- - * Function: H5G_link_lookup_by_idx - * - * Purpose: Look up an object in a group using link messages, - * according to the order of an index - * - * Return: Non-negative on success/Negative on failure - * - * Programmer: Quincey Koziol - * koziol@hdfgroup.org - * Nov 6 2006 - * - *------------------------------------------------------------------------- - */ -herr_t -H5G_link_lookup_by_idx(H5O_loc_t *oloc, hid_t dxpl_id, const H5O_linfo_t *linfo, - H5L_index_t idx_type, H5_iter_order_t order, hsize_t n, H5O_link_t *lnk) -{ - H5G_link_table_t ltable = {0, NULL}; /* Link table */ - herr_t ret_value = SUCCEED; /* Return value */ - - FUNC_ENTER_NOAPI(H5G_link_lookup_by_idx, FAIL) - - /* check arguments */ - HDassert(oloc && oloc->file); - HDassert(linfo); - HDassert(lnk); - - /* Build table of all link messages, sorted according to desired order */ - if(H5G_link_build_table(oloc, dxpl_id, linfo, idx_type, order, <able) < 0) - HGOTO_ERROR(H5E_SYM, H5E_CANTINIT, FAIL, "can't create link message table") - - /* Check for going out of bounds */ - if(n >= ltable.nlinks) - HGOTO_ERROR(H5E_ARGS, H5E_BADRANGE, FAIL, "index out of bound") - - /* Copy link information */ - if(NULL == H5O_copy(H5O_LINK_ID, <able.lnks[n], lnk)) - HGOTO_ERROR(H5E_SYM, H5E_CANTCOPY, H5O_ITER_ERROR, "can't copy link message") - -done: - /* Release link table */ - if(ltable.lnks) - /* Free link table information */ - if(H5G_obj_release_table(<able) < 0) - HDONE_ERROR(H5E_SYM, H5E_CANTFREE, FAIL, "unable to release link table") - - FUNC_LEAVE_NOAPI(ret_value) -} /* end H5G_link_lookup_by_idx() */ +} /* end H5G_link_release_table() */ |