diff options
author | Frank Baker <fbaker@hdfgroup.org> | 2001-07-09 21:18:11 (GMT) |
---|---|---|
committer | Frank Baker <fbaker@hdfgroup.org> | 2001-07-09 21:18:11 (GMT) |
commit | fc13ddb7b3ec6c968f8319897b93f4b3a7818383 (patch) | |
tree | bbe1a1191b0f595ee0ba2a1a3814cd921681c3ee | |
parent | 4e7ea723531d12d029c342e44942d1893c129170 (diff) | |
download | hdf5-fc13ddb7b3ec6c968f8319897b93f4b3a7818383.zip hdf5-fc13ddb7b3ec6c968f8319897b93f4b3a7818383.tar.gz hdf5-fc13ddb7b3ec6c968f8319897b93f4b3a7818383.tar.bz2 |
[svn-r4164] Purpose:
Fixes bug #503
Description:
H5Gunlink -- Changed "file space is reclaimed" ot "released".
Added note re: freespace and packing.
Heavy edit of Purpose and Description.
Platforms tested:
IE 5
-rw-r--r-- | doc/html/RM_H5G.html | 31 |
1 files changed, 22 insertions, 9 deletions
diff --git a/doc/html/RM_H5G.html b/doc/html/RM_H5G.html index 9eec6d3..02bf6ef 100644 --- a/doc/html/RM_H5G.html +++ b/doc/html/RM_H5G.html @@ -347,19 +347,32 @@ create or access function. <em>const char *</em><code>name</code> ) <dt><strong>Purpose:</strong> - <dd>Removes the specified <code>name</code> from the group graph and - decrements the link count for the object to which <code>name</code> points + <dd>Removes the link to an object from a group. <dt><strong>Description:</strong> - <dd><code>H5Gunlink</code> removes an association between a name and an object. - Object headers keep track of how many hard links refer to the object; - when the hard link count reaches zero, the object can be removed + <dd><code>H5Gunlink</code> removes the object specified by + <code>name</code> from the group graph and decrements the + link count for the object to which <code>name</code> points. + This action eliminates any association between <code>name</code> + and the object to which <code>name</code> pointed. + <p> + Object headers keep track of how many hard links refer to an object; + when the link count reaches zero, the object can be removed from the file. Objects which are open are not removed until all identifiers to the object are closed. <p> - If the link count reaches zero, all file-space associated with - the object will be reclaimed. If the object is open, the - reclamation of the file space is delayed until all handles to the - object are closed. + If the link count reaches zero, all file space associated with + the object will be released, i.e., identified in memory as freespace. + If the any object identifier is open for the object, the space + will not be released until after the object identifier is closed. + <p> + <!-- editingcomment: freespace and file packing --> + Note that space identified as freespace is available for re-use + only as long as the file remains open; once a file has been + closed, the HDF5 library loses track of freespace. + Identifying freespace does not imply that the file + will be packed or that, if the file is closed and later reopened, + that the space will be available for re-use. + Such functionality has not yet been implemented in the HDF5 library. <dt><strong>Warning:</strong> <dd>Exercise care in unlinking groups as it is possible to render data in a file inaccessible with <code>H5Gunlink</code>. |