mirror/hdf5
2
0
Fork 0
mirror of https://github.com/HDFGroup/hdf5.git synced 2025-03-31 17:10:47 +08:00
Code Issues Packages Projects Releases Wiki Activity

[svn-r2789] Purpose:

Browse Source 
To warn users that RM_H5G.html and Groups.html can render groups and
    datasets inaccessible in a file.
Solution:
    Modified RM_H5G.html and Groups.html as follows:
      -- Added warning (new section) to Groups.html that H5Gunlink and
         H5Gmove can result in inaccessible groups and datasets.
      -- Added links to that new section from H5Gunlink and H5Gmove
         in RM_H5G.html.
Platforms tested:
    IE5
This commit is contained in:
Frank Baker 2000-11-01 14:01:55 -05:00
parent 6d04c130ad
commit 180a47a037
2 changed files with 39 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
doc/html/Groups.html
View File

@ -307,6 +307,33 @@
string is returned.
</dl>
<a name="H5GUnlinkToCorrupt">
<h2>6. Unlinking Datasets with H5Gmove and H5Gunlink</h2>
</a>
<p>Exercise caution in the use of <code>H5Gmove</code> and
<code>H5Gunlink</code>.
<p>Note that <code>H5Gmove</code> and <code>H5Gunlink</code>
each include a step that unlinks pointers to a set or group.
If the link that is removed is on the only path leading
to a dataset or group, that dataset or group will become
inaccessible in the file.
<p>Consider the following example. Assume that the group
<code>group2</code> can only be accessed via the following path,
where <code>top_group</code> is a member of the file's root group:
<pre>
<code>/top_group/group1/group2/</code> </pre>
Using <code>H5Gmove</code>, <code>top_group</code> is renamed
to be a member of <code>group2</code>. At this point, since
<code>top_group</code> was the only route from the root group
to <code>group1</code>, there is no longer a path by which
one can access <code>group1</code>, <code>group2</code>, or
any member datasets.
<code>top_group</code> and any member datasets have also
become inaccessible.
<hr>
<center>
@ -359,7 +386,7 @@
<!-- Created: Tue Jan 27 09:11:27 EST 1998 -->
<!-- hhmts start -->
Last modified: 14 October 1999
Last modified: 1 November 2000
<!-- hhmts end -->
</body>

12
doc/html/RM_H5G.html
View File

@ -360,6 +360,11 @@ create or access function.
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.
<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>.
See <a href="Groups.html#H5GUnlinkToCorrupt">The Group Interface</a>
in the <cite>HDF5 User's Guide</cite>.
<dt><strong>Parameters:</strong>
<dl>
<dt><em>hid_t</em> <code>loc_id</code>
@ -502,6 +507,11 @@ create or access function.
as an atomic operation. Both names are interpreted relative
to <code>loc_id</code>, which is either a file or a group
identifier.
<dt><strong>Warning:</strong>
<dd>Exercise care in moving groups as it is possible to render data in
a file inaccessible with <code>H5Gmove</code>.
See <a href="Groups.html#H5GUnlinkToCorrupt">The Group Interface</a>
in the <cite>HDF5 User's Guide</cite>.
<dt><strong>Parameters:</strong>
<dl>
<dt><em>hid_t</em> <code>loc_id</code>
@ -805,7 +815,7 @@ H5G&nbsp;&nbsp;
<a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a>
<br>
Last modified: 7 March 2000
Last modified: 1 November 2000
<br>
Describes HDF5 Version 1.3 (Unrelased development version. Dynamic.)