mirror of
https://github.com/HDFGroup/hdf5.git
synced 2025-01-12 15:04:59 +08:00
200 lines
3.7 KiB
HTML
200 lines
3.7 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<TITLE>H5Dget_offset Test Review</TITLE>
|
|
<META http-equiv="content-type" content="text/html; charset=ISO-8859-1">
|
|
<META name="author" content="Quincey Koziol">
|
|
</HEAD>
|
|
<body text="#000000" bgcolor="#FFFFFF">
|
|
<STYLE type="text/css">
|
|
OL.loweralpha { list-style-type: lower-alpha }
|
|
OL.upperroman { list-style-type: upper-roman }
|
|
</STYLE>
|
|
|
|
<CENTER><H1>H5Dget_offset Test Review</H1></CENTER>
|
|
|
|
<OL class="upperroman">
|
|
|
|
<LI><H3><U>Purpose:</U></H3>
|
|
<P>This document describes the API test review results for <a href="../../RM_H5D.html#Dataset-GetOffset">H5Dget_offset</a>().
|
|
</P>
|
|
|
|
<LI><H3><U>Serial Review:</U></H3>
|
|
<TABLE border="1">
|
|
<TR>
|
|
<TH>Test case
|
|
</TH>
|
|
|
|
<TH>Test source file
|
|
</TH>
|
|
|
|
<TH>Test method
|
|
</TH>
|
|
|
|
<TH>Expected test results
|
|
</TH>
|
|
|
|
<TH>Notes
|
|
</TH>
|
|
|
|
<TR>
|
|
<TD>Chunked dataset
|
|
</TD>
|
|
|
|
<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>
|
|
<TD>Compact dataset
|
|
</TD>
|
|
|
|
<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>
|
|
<TD>Contiguous dataset, [user block size] == 0, not external
|
|
</TD>
|
|
|
|
<TD>dsets.c
|
|
</TD>
|
|
|
|
<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 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
|
|
correct offset in the file.
|
|
</TD>
|
|
|
|
</TR>
|
|
|
|
<TR>
|
|
<TD>Contiguous dataset, [user block size] != 0, not external
|
|
</TD>
|
|
|
|
<TD>dsets.c
|
|
</TD>
|
|
|
|
<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 if performed before data is written to the dataset.
|
|
</P>
|
|
</TD>
|
|
|
|
<TD>Needs test for this case.
|
|
</TD>
|
|
|
|
</TR>
|
|
|
|
<TR>
|
|
<TD>Contiguous dataset, [user block size] == 0, external data storage
|
|
</TD>
|
|
|
|
<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
|
|
does not appear to be a need for this.
|
|
</P>
|
|
|
|
|
|
</OL>
|
|
|
|
</BODY>
|
|
</HTML>
|
|
|