summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorFrank Baker <fbaker@hdfgroup.org>2001-07-09 21:17:13 (GMT)
committerFrank Baker <fbaker@hdfgroup.org>2001-07-09 21:17:13 (GMT)
commitf4da6baf5dc8a0f029f004c2146ee293ae2ef079 (patch)
treefb6f13c9e2b049c71293629e034f9d8ef2d3d3df /doc
parent017b67a7421bbc58a4580d71e6c68f5b43b777e1 (diff)
downloadhdf5-f4da6baf5dc8a0f029f004c2146ee293ae2ef079.zip
hdf5-f4da6baf5dc8a0f029f004c2146ee293ae2ef079.tar.gz
hdf5-f4da6baf5dc8a0f029f004c2146ee293ae2ef079.tar.bz2
[svn-r4163] 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
Diffstat (limited to 'doc')
-rw-r--r--doc/html/RM_H5G.html31
1 files changed, 22 insertions, 9 deletions
diff --git a/doc/html/RM_H5G.html b/doc/html/RM_H5G.html
index d627aad..ce79af4 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>.