diff options
author | Quincey Koziol <koziol@hdfgroup.org> | 2003-10-07 15:27:19 (GMT) |
---|---|---|
committer | Quincey Koziol <koziol@hdfgroup.org> | 2003-10-07 15:27:19 (GMT) |
commit | 134a692a8365ab5f196155298b6b601889c80a32 (patch) | |
tree | 391fd26160e9bc5064a889261005822e1083978a /doc/html/RM_H5G.html | |
parent | a5d1c5c576a7a26ef78dfb4715c2b1f2cbcced3a (diff) | |
download | hdf5-134a692a8365ab5f196155298b6b601889c80a32.zip hdf5-134a692a8365ab5f196155298b6b601889c80a32.tar.gz hdf5-134a692a8365ab5f196155298b6b601889c80a32.tar.bz2 |
[svn-r7561] Purpose:
Feature add
Description:
Add a few new fields to the H5G_stat_t structure, to allow more information
about the object header to be retrieved.
Platforms tested:
FreeBSD 4.9 (sleipnir)
h5committest
Diffstat (limited to 'doc/html/RM_H5G.html')
-rw-r--r-- | doc/html/RM_H5G.html | 34 |
1 files changed, 33 insertions, 1 deletions
diff --git a/doc/html/RM_H5G.html b/doc/html/RM_H5G.html index 88fa534..4ec64bf 100644 --- a/doc/html/RM_H5G.html +++ b/doc/html/RM_H5G.html @@ -468,7 +468,8 @@ create or access function. The existence of an object can be tested by calling this function with a null <code>statbuf</code>. <p> - <code>H5Gget_objinfo</code> fills in the following data structure: + <code>H5Gget_objinfo</code> fills in the following data structure + (defined in H5Gpublic.h): <pre> typedef struct H5G_stat_t { unsigned long fileno[2]; @@ -477,8 +478,20 @@ create or access function. int type; time_t mtime; size_t linklen; + H5O_stat_t ohdr; } H5G_stat_t </pre> + + where H5O_stat_t (defined in H5Opublic.h) is: + + <pre> + typedef struct H5O_stat_t { + hsize_t size; + hsize_t free; + unsigned nmesgs; + unsigned nchunks; + } H5O_stat_t + </pre> The <code>fileno</code> and <code>objno</code> fields contain four values which uniquely itentify an object among those HDF5 files which are open: if all four values are the same @@ -497,17 +510,36 @@ create or access function. the object or zero when information is being returned about a symbolic link (symbolic links do not have hard links but all other objects always have at least one). + <p> The <code>type</code> field contains the type of the object, one of <code>H5G_GROUP</code>, <code>H5G_DATASET</code>, <code>H5G_LINK</code>, or <code>H5G_TYPE</code>. + <p> The <code>mtime</code> field contains the modification time. + <p> If information is being returned about a symbolic link then <code>linklen</code> will be the length of the link value (the name of the pointed-to object with the null terminator); otherwise <code>linklen</code> will be zero. + <p> + The fields in the <code>H5O_stat_t</code> struct contain information + about the object header for the object queried: + <ul><dl> + <dt><code>size</code> + <dd>The total size of all the object header information in + the file (for all chunks). + <dt><code>free</code> + <dd>The size of unused space in the object header. + <dt><code>nmesgs</code> + <dd>The number of object header messages. + <dt><code>nchunks</code> + <dd>The number of chunks the object header is broken up into. + </dl> </ul> + + <p> Other fields may be added to this structure in the future. <dt><strong>Note:</strong> <dd>Some systems will be able to record the time accurately but |