summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorQuincey Koziol <koziol@hdfgroup.org>2002-11-20 14:49:11 (GMT)
committerQuincey Koziol <koziol@hdfgroup.org>2002-11-20 14:49:11 (GMT)
commit67f72c42771afcbe72950b8abe6090ddc65591fd (patch)
tree2fa0d99874e284de2f868ae23221995ed6a4a998 /doc
parentb47a688089e00f1f6a931b5f7ae61a14222d7f53 (diff)
downloadhdf5-67f72c42771afcbe72950b8abe6090ddc65591fd.zip
hdf5-67f72c42771afcbe72950b8abe6090ddc65591fd.tar.gz
hdf5-67f72c42771afcbe72950b8abe6090ddc65591fd.tar.bz2
[svn-r6120] Purpose:
Update information Description: Add more information about tests performed and why they succeed/fail.
Diffstat (limited to 'doc')
-rw-r--r--doc/html/TechNotes/TestReview/H5Dget_offset.html85
1 files changed, 80 insertions, 5 deletions
diff --git a/doc/html/TechNotes/TestReview/H5Dget_offset.html b/doc/html/TechNotes/TestReview/H5Dget_offset.html
index 6c53a3d..afc445a 100644
--- a/doc/html/TechNotes/TestReview/H5Dget_offset.html
+++ b/doc/html/TechNotes/TestReview/H5Dget_offset.html
@@ -25,7 +25,10 @@ OL.upperroman { list-style-type: upper-roman }
<TH>Test case
</TH>
-<TH>Test file
+<TH>Test source file
+</TH>
+
+<TH>Test method
</TH>
<TH>Expected test results
@@ -41,9 +44,27 @@ OL.upperroman { list-style-type: upper-roman }
<TD>dsets.c
</TD>
+<TD>
+<OL>
+<LI>Create chunked dataset
+<LI>Query dataset offset
+</OL>
+</TD>
+
<TD>FAIL
</TD>
+<TD>
+<P>Because dataset is stored in chunks that are indexed by a B-tree, there is
+no single piece of data to query the offset of.
+</P>
+<P>It may be possible in the future to
+enhance this function by querying the offset of a particular chunk (or chunks),
+but that has limited use because chunks could be compressed, etc. with an I/O
+filter.
+</P>
+</TD>
+
</TR>
<TR>
@@ -53,9 +74,28 @@ OL.upperroman { list-style-type: upper-roman }
<TD>dsets.c
</TD>
+<TD>
+<OL>
+<LI>Create chunked dataset
+<LI>Query dataset offset
+</OL>
+</TD>
+
<TD>FAIL
</TD>
+<TD>
+<P>Because dataset is stored in the object header of the dataset, there is
+no separate piece of data to query the offset of.
+</P>
+<P>It may be possible in the future to get the offset of the data in the object
+header, but this is problematic due to the fact that the messages in the object
+header can get relocated in the file when changes (like adding attributes, etc.)
+are made to the dataset, invalidating the address given to the user.
+filter.
+</P>
+</TD>
+
</TR>
<TR>
@@ -65,11 +105,21 @@ OL.upperroman { list-style-type: upper-roman }
<TD>dsets.c
</TD>
-<TD><P>Succeed in getting the proper address and be able to verify
+<TD>
+<OL>
+<LI>Create file with 0 sized user-block (the default)
+<LI>Create contigous dataset
+<LI>Query dataset offset
+</OL>
+</TD>
+
+<TD>
+<P>Succeed in getting the proper address and be able to verify
that the data at that address in the file is what was written out.
</P>
<P>When data storage allocation is "late" (the default), querying the offset
-should fail.</P>
+should fail if performed before data is written to the dataset.
+</P>
</TD>
<TD>Needs additional test to verify that the data written out is located at the
@@ -85,11 +135,21 @@ correct offset in the file.
<TD>dsets.c
</TD>
-<TD><P>Succeed in getting the proper address and be able to verify
+<TD>
+<OL>
+<LI>Create file with non-0 sized user-block
+<LI>Create contigous dataset
+<LI>Query dataset offset
+</OL>
+</TD>
+
+<TD>
+<P>Succeed in getting the proper address and be able to verify
that the data at that address in the file is what was written out.
</P>
<P>When data storage allocation is "late" (the default), querying the offset
-should fail.</P>
+should fail if performed before data is written to the dataset.
+</P>
</TD>
<TD>Needs test for this case.
@@ -104,12 +164,27 @@ should fail.</P>
<TD>external.c
</TD>
+<TD>
+<OL>
+<LI>Create contigous dataset with external storage
+<LI>Query dataset offset
+</OL>
+</TD>
+
<TD>FAIL
</TD>
+<TD>
+<P>In theory, it's easy to return the offset of the data in the external file,
+but this wasn't done because it would be too easy for users to assume that the
+offset returned was in the HDF5 file instead of the external file.
+</P>
+</TD>
+
</TR>
</TABLE>
+<BR>
<LI><H3><U>Parallel Review:</U></H3>
<P>The H5Dget_offset() function is not tested in parallel. Currently, there