mirror of
https://github.com/HDFGroup/hdf5.git
synced 2024-12-09 07:32:32 +08:00
2f36ea99d4
Add H5Lvisit_by_name() API routine to library.
Eliminated all (five!) other group traversal routines and changed them
all to use the new API routine.
Cleaned up output of h5ls & h5stat:
- Issue error when requesting recursive traversal of a file
with the "group info" flag, but no group given
- Print info about root group in all(?) appropriate situations
- Don't print "verbose" information about root group until the
root group is in the list of objects to display
(mostly because h5ls & h5stat had a different twist on traversing the
groups in a file that the other utilities)
Tested on:
FreeBSD/32 6.2 (duty) in debug mode
FreeBSD/64 6.2 (liberty) w/C++ & FORTRAN, in debug mode
Linux/32 2.6 (kagiso) w/PGI compilers, w/C++ & FORTRAN, w/threadsafe,
in debug mode
Linux/64-amd64 2.6 (smirom) w/default API=1.6.x, w/C++ & FORTRAN,
in production mode
Linux/64-ia64 2.6 (cobalt) w/Intel compilers, w/C++ & FORTRAN,
in production mode
Solaris/32 2.10 (linew) w/deprecated symbols disabled, w/C++ & FORTRAN,
w/szip filter, in production mode
Mac OS X/32 10.4.10 (amazon) in debug mode
Linux/64-ia64 2.4 (tg-login3) w/parallel, w/FORTRAN, in production mode
167 lines
6.1 KiB
C
167 lines
6.1 KiB
C
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* Copyright by The HDF Group. *
|
|
* Copyright by the Board of Trustees of the University of Illinois. *
|
|
* All rights reserved. *
|
|
* *
|
|
* This file is part of HDF5. The full HDF5 copyright notice, including *
|
|
* terms governing use, modification, and redistribution, is contained in *
|
|
* the files COPYING and Copyright.html. COPYING can be found at the root *
|
|
* of the source code distribution tree; Copyright.html can be found at the *
|
|
* root level of an installed copy of the electronic HDF5 document set and *
|
|
* is linked from the top-level documents page. It can also be found at *
|
|
* http://hdfgroup.org/HDF5/doc/Copyright.html. If you do not have *
|
|
* access to either file, you may request a copy from help@hdfgroup.org. *
|
|
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
|
|
|
|
#ifndef H5TRAV_H__
|
|
#define H5TRAV_H__
|
|
|
|
#include "hdf5.h"
|
|
|
|
/* Typedefs for visiting objects */
|
|
typedef herr_t (*h5trav_obj_func_t)(const char *path_name, const H5O_info_t *oinfo,
|
|
const char *first_seen, void *udata);
|
|
typedef herr_t (*h5trav_lnk_func_t)(const char *path_name, const H5L_info_t *linfo,
|
|
void *udata);
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* public enum to specify type of an object
|
|
* the TYPE can be:
|
|
* H5TRAV_TYPE_UNKNOWN = -1,
|
|
* H5TRAV_TYPE_GROUP, Object is a group
|
|
* H5TRAV_TYPE_DATASET, Object is a dataset
|
|
* H5TRAV_TYPE_TYPE, Object is a named datatype
|
|
* H5TRAV_TYPE_LINK, Object is a symbolic link
|
|
* H5TRAV_TYPE_UDLINK, Object is a user-defined link
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
typedef enum {
|
|
H5TRAV_TYPE_UNKNOWN = -1, /* Unknown object type */
|
|
H5TRAV_TYPE_GROUP, /* Object is a group */
|
|
H5TRAV_TYPE_DATASET, /* Object is a dataset */
|
|
H5TRAV_TYPE_NAMED_DATATYPE, /* Object is a named datatype */
|
|
H5TRAV_TYPE_LINK, /* Object is a symbolic link */
|
|
H5TRAV_TYPE_UDLINK /* Object is a user-defined link */
|
|
} h5trav_type_t;
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* public struct to store name and type of an object
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
typedef struct trav_path_t {
|
|
char *path;
|
|
h5trav_type_t type;
|
|
} trav_path_t;
|
|
|
|
typedef struct trav_info_t {
|
|
size_t nalloc;
|
|
size_t nused;
|
|
trav_path_t *paths;
|
|
} trav_info_t;
|
|
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* keep record of hard link information
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
typedef struct trav_link_t {
|
|
char *new_name;
|
|
} trav_link_t;
|
|
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* struct to store basic info needed for the h5trav table traversal algorythm
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
|
|
typedef struct trav_obj_t {
|
|
haddr_t objno; /* object address */
|
|
unsigned flags[2]; /* h5diff.object is present or not in both files*/
|
|
char *name; /* name */
|
|
h5trav_type_t type; /* type of object */
|
|
trav_link_t *links; /* array of possible link names */
|
|
size_t sizelinks; /* size of links array */
|
|
size_t nlinks; /* number of links */
|
|
} trav_obj_t;
|
|
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* private struct that stores all objects
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
|
|
typedef struct trav_table_t {
|
|
size_t size;
|
|
size_t nobjs;
|
|
trav_obj_t *objs;
|
|
} trav_table_t;
|
|
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* public functions
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* "h5trav general" public functions
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
int h5trav_visit(hid_t file_id, const char *grp_name, hbool_t visit_start,
|
|
hbool_t recurse, h5trav_obj_func_t visit_obj, h5trav_lnk_func_t visit_lnk,
|
|
void *udata);
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* "h5trav info" public functions
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
int h5trav_getinfo(hid_t file_id, trav_info_t *info);
|
|
ssize_t h5trav_getindex(const trav_info_t *info, const char *obj);
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* "h5trav table" public functions
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
|
|
int h5trav_gettable(hid_t fid, trav_table_t *travt);
|
|
int h5trav_getindext(const char *obj, const trav_table_t *travt);
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* "h5trav print" public functions
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
int h5trav_print(hid_t fid);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* info private functions
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
|
|
void trav_info_init(trav_info_t **info);
|
|
|
|
void trav_info_free(trav_info_t *info);
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* table private functions
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
|
|
void trav_table_init(trav_table_t **table);
|
|
|
|
void trav_table_free(trav_table_t *table);
|
|
|
|
void trav_table_addflags(unsigned *flags,
|
|
char *objname,
|
|
h5trav_type_t type,
|
|
trav_table_t *table);
|
|
|
|
#endif /* H5TRAV_H__ */
|
|
|