[svn-r9727] Purpose:

Bug Fix/Code Cleanup/Doc Cleanup/Optimization/Branch Sync :-)

Description:
    Generally speaking, this is the "signed->unsigned" change to selections.
However, in the process of merging code back, things got stickier and stickier
until I ended up doing a big "sync the two branches up" operation.  So... I
brought back all the "infrastructure" fixes from the development branch to the
release branch (which I think were actually making some improvement in
performance) as well as fixed several bugs which had been fixed in one branch,
but not the other.

    I've also tagged the repository before making this checkin with the label
"before_signed_unsigned_changes".

Platforms tested:
    FreeBSD 4.10 (sleipnir) w/parallel & fphdf5
    FreeBSD 4.10 (sleipnir) w/threadsafe
    FreeBSD 4.10 (sleipnir) w/backward compatibility
    Solaris 2.7 (arabica) w/"purify options"
    Solaris 2.8 (sol) w/FORTRAN & C++
    AIX 5.x (copper) w/parallel & FORTRAN
    IRIX64 6.5 (modi4) w/FORTRAN
    Linux 2.4 (heping) w/FORTRAN & C++


Misc. update:
This commit is contained in:
Quincey Koziol
2004-12-29 09:26:20 -05:00
parent 9b96fd2003
commit 427ff7da28
297 changed files with 7280 additions and 7045 deletions

View File

@@ -204,6 +204,7 @@ create or access function.
<p>
<!-- NEW PAGE -->
<!-- HEADER RIGHT " " -->
<!-- NEW PAGE -->
<!-- HEADER RIGHT "H5Gclose" -->
<hr>
@@ -550,7 +551,8 @@ SUBROUTINE
The existence of an object can be tested by calling this function
with a null <code>statbuf</code>.
<p>
<code>H5Gget_objinfo</code> fills in the following data structure:
<code>H5Gget_objinfo</code> fills in the following data structure
(defined in H5Gpublic.h):
<pre>
typedef struct H5G_stat_t {
unsigned long fileno;
@@ -562,9 +564,20 @@ SUBROUTINE
H5O_stat_t ohdr;
} H5G_stat_t
</pre>
where H5O_stat_t (defined in H5Opublic.h) is:
<pre>
typedef struct H5O_stat_t {
hsize_t size;
hsize_t free;
unsigned nmesgs;
unsigned nchunks;
} H5O_stat_t
</pre>
The <code>fileno</code> and <code>objno</code> fields contain
values which uniquely identify an object among those
HDF5 files which are open: if both values are the same
four values which uniquely identify an object among those
HDF5 files which are open: if all four values are the same
between two objects, then the two objects are the same
(provided both files are still open).
<ul>
@@ -580,26 +593,41 @@ SUBROUTINE
the object or zero when information is being returned about a
symbolic link (symbolic links do not have hard links but
all other objects always have at least one).
<p>
The <code>type</code> field contains the type of the object,
one of
<code>H5G_GROUP</code>,
<code>H5G_DATASET</code>,
<code>H5G_LINK</code>, or
<code>H5G_TYPE</code>.
<p>
The <code>mtime</code> field contains the modification time.
<p>
If information is being returned about a symbolic link then
<code>linklen</code> will be the length of the link value
(the name of the pointed-to object with the null terminator);
otherwise <code>linklen</code> will be zero.
<p>
The fields in the <code>H5O_stat_t</code> struct contain information
about the object header for the object queried:
<ul><dl>
<dt><code>size</code>
<dd>The total size of all the object header information in
the file (for all chunks).
<dt><code>free</code>
<dd>The size of unused space in the object header.
<dt><code>nmesgs</code>
<dd>The number of object header messages.
<dt><code>nchunks</code>
<dd>The number of chunks the object header is broken up into.
</dl> </ul>
<!-- INSERT H50_stat_t DESCRIPTION AS IN 1.6 -->
<p>
Other fields may be added to this structure in the future.
<dt><strong>Note:</strong>
<dd>Some systems will be able to record the time accurately but
unable to retrieve the correct time; such systems (e.g., Irix64)
will report an <code>mtime</code> value of 0 (zero).
<!-- NEW PAGE -->
<dt><strong>Parameters:</strong>
<ul><table>
<tr>