summaryrefslogtreecommitdiffstats
path: root/doc/html/ADGuide/HISTORY.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/html/ADGuide/HISTORY.txt')
-rw-r--r--doc/html/ADGuide/HISTORY.txt2268
1 files changed, 2232 insertions, 36 deletions
diff --git a/doc/html/ADGuide/HISTORY.txt b/doc/html/ADGuide/HISTORY.txt
index 79f5065..b6f2585 100644
--- a/doc/html/ADGuide/HISTORY.txt
+++ b/doc/html/ADGuide/HISTORY.txt
@@ -1,48 +1,2237 @@
HDF5 HISTORY
============
+This file contains history of the HDF5 libraries releases
CONTENTS
-I. Release Information for hdf5-1.2.2
-II. Release Information for hdf5-1.2.1
-III. Release Information for hdf5-1.2.0
- A. Platforms Supported
- B. Known Problems
- C. Changes Since Version 1.0.1
- 1. Documentation
- 2. Configuration
- 3. Debugging
- 4. Datatypes
- 5. Dataspaces
- 6. Persistent Pointers
- 7. Parallel Support
- 8. New API Functions
- a. Property List Interface
- b. Dataset Interface
- c. Dataspace Interface
- d. Datatype Interface
- e. Identifier Interface
- f. Reference Interface
- g. Ragged Arrays
- 9. Tools
-
-IV. Changes from Release 1.0.0 to Release 1.0.1
-V. Changes from the Beta 1.0.0 Release to Release 1.0.0
-VI. Changes from the Second Alpha 1.0.0 Release to the Beta 1.0.0 Release
-VII. Changes from the First Alpha 1.0.0 Release to the
- Second Alpha 1.0.0 Release
+
+13. Release Information for hdf5-1.4.5
+12. Release Information for hdf5-1.4.4
+11. Release Information for hdf5-1.4.3
+10. Release Information for hdf5-1.4.2
+9. Release Information for hdf5-1.4.1
+8. Release Information for hdf5-1.4.0
+7. Release Information for hdf5-1.2.2
+6. Release Information for hdf5-1.2.1
+5. Release Information for hdf5-1.2.0
+4. Changes from Release 1.0.0 to Release 1.0.1
+3. Changes from the Beta 1.0.0 Release to Release 1.0.0
+2. Changes from the Second Alpha 1.0.0 Release to the Beta 1.0.0 Release
+1. Changes from the First Alpha 1.0.0 Release to the
+ Second Alpha 1.0.0 Release
[Search on the string '%%%%' for per-release section breaks.]
-----------------------------------------------------------------------
+%%%%1.4.5%%%% Release Information for hdf5-1.4.5 (02/February/03)
+13. Release information for HDF5 version 1.4.5
+==============================================================================
-%%%%1.2.2%%%% Release Information for hdf5-1.2.2 (6/23/00)
-I. Release Information for hdf5-1.2.2
+INTRODUCTION
+
+This document describes the differences between HDF5-1.4.4 and
+HDF5-1.4.5, and contains information on the platforms tested and
+known problems in HDF5-1.4.5. For additional information check the
+HISTORY.txt file in the HDF5 source.
+
+The HDF5 documentation can be found on the NCSA ftp server
+(ftp.ncsa.uiuc.edu) in the directory:
+
+ /HDF/HDF5/docs/
+
+For more information, see the HDF5 home page at:
+
+ http://hdf.ncsa.uiuc.edu/HDF5/
+
+If you have any questions or comments, please send them to:
+
+ hdfhelp@ncsa.uiuc.edu
+
+
+CONTENTS
+
+- New Features
+- Bug Fixes since HDF5-1.4.4
+- Performance Improvements
+- Documentation
+- Platforms Tested
+- Supported Configuration Features
+- Known Problems
+
+
+New Features
+============
+ o Configuration
+ ================
+ * Added "unofficial support" for building with a C++ compiler (or at least
+ not failing badly when building with a C++ compiler). QAK - 2003/01/09
+ * Added "unofficial support" for AIX 64bits. See INSTALL for configure
+ details. AKC - 2002/08/29
+ * Added "--with-dmalloc" flag, to easily enable support for the 'dmalloc'
+ debugging malloc implementation. QAK - 2002/07/15
+
+ o Library
+ =========
+ o General
+ ---------
+ * Allow scalar dataspaces to be used for parallel I/O. QAK - 2002/11/05
+ * Added environment variable "HDF5_DISABLE_VERSION_CHECK", which disables
+ the version checking between the header files and the library linked
+ into an application if set to '1'. This should be used with caution,
+ mis-matched headers and library binaries can cause _serious_ problems.
+ QAK - 2002/10/15
+ * Partially fixed space allocation inefficiencies in the file by
+ improving our algorithms for re-using freed space. QAK - 2002/08/27
+ * API tracing has been improved. Nested API calls don't screw up the
+ output format; function call and return event times can be logged;
+ total time spent in each function can be logged. The following
+ HDF5_DEBUG environment variable words affect tracing:
+ trace -- turn on/off basic tracing
+ ttimes -- turn on tracing and report event times and
+ time spent in each API function.
+ ttop -- turn on tracing but display only top-level
+ API calls.
+
+ o APIs
+ ------
+ * Several missing fortran APIs have been added to the library:
+
+ h5get_libversion_f h5tget_member_index_f h5dget_storage_size_f
+ h5check_version_f h5tvlen_create_f h5dvlen_get_max_len_f
+ h5garbage_collect_f h5dwrite_vl_f
+ h5dont_atexit_f h5dread_vl_f
+
+ Functions h5dvlen_get_max_len_f, h5dwrite_vl_f, and h5dread_vl_f support
+ VL Length C APIs functionality for integer, real and string datatypes.
+ See HDF5 Reference Manual and HDF5 FORTRAN90 User's Notes for more
+ information and for the functions description.
+
+ o Parallel library
+ ==================
+ * The MPI-posix virtual file driver makes gpfs_fcntl() hints to tell
+ the underlying GPFS file system to avoid prefetching byte range
+ tokens if USE_GPFS_HINTS is defined when this file is compiled.
+ This temporary solution is intended to be removed once the HDF5
+ API supports the necessary functionality that makes it possible
+ for this sort of thing do be done at a higher software layer.
+ RPM - 2002/12/03
+ * Added MPI-posix VFL driver. This VFL driver uses MPI functions to
+ coordinate actions, but performs I/O directly with POSIX sec(2)
+ (i.e. open/close/read/write/etc.) calls. This driver should _NOT_
+ be used to access files that are not on a parallel filesystem.
+ The following API functions were added:
+ herr_t H5Pset_fapl_mpiposix(hid_t fapl_id, MPI_Comm comm);
+ herr_t H5Pget_fapl_mpiposix(hid_t fapl_id, MPI_Comm *comm/*out*/);
+ QAK - 2002/07/15
+
+
+
+ o Support for new platforms and languages
+ =========================================
+ * C++ API now works on the Origin2000 (IRIX6.5.14.) BMR - 2002/11/14
+
+
+ o Misc.
+ =========================================
+ HDF5 1.4.5 works with Portland Group Compilers (pgcc, pgf90 and pgCC
+ version 4.0-2) on Linux 2.4
+
+
+Bug Fixes since HDF5-1.4.4 Release
+==================================
+ * H5Fopen without the H5F_ACC_CREAT flag should not succeed in creating
+ a new file with the 'core' VFL driver. QAK - 2003/01/24
+ * Corrected metadata caching bug in parallel I/O which could cause hangs
+ when chunked datasets were accessed with independent transfer mode.
+ QAK - 2003/01/23
+ * Allow opening objects with unknown object header messages.
+ QAK - 2003/01/21
+ * Added improved error assertion for nil VL strings. It return error
+ stack instead of a simple assertion. SLU - 2002/12/16
+ * Fixed h5dump bug(cannot dump data and datatype) for VL string.
+ SLU - 2002/11/18
+ * Fixed error condition where "none" selections were not being handled
+ correctly in serial & parallel. QAK - 2002/10/29
+ * Fixed problem where optimized hyperslab routines were incorrectly
+ invoked for parallel I/O operations in collective mode. QAK - 2002/07/22
+ * Fixed metadata corruption problem which could occur when many objects
+ are created in a file during parallel I/O. QAK - 2002/07/19
+ * Fixed minor problem with configuration when users specified /usr/include
+ and /usr/lib for the --with-* options that some compilers can't
+ handle. BW - 2003/01/23
+
+
+
+Documentation
+=============
+ New PDF files are not available for this release.
+
+
+Platforms Tested
+================
+
+ AIX 5.1 (32 and 64-bit) C for AIX Compiler, Version 6
+ xlf 8.1.0.2
+ poe 3.2.0.11
+ Cray T3E sn6606 2.0.6.08 Cray Standard C Version 6.6.0.1.3
+ Cray Fortran Version 3.6.0.0.12
+ Cray SV1 10.0.1. 0 Cray Standard C Version 6.6.0.1.3
+ Cray Fortran Version 3.6.0.0.12
+ Cray T90IEEE 10.0.1.01u Cray Standard C Version 6.4.0.2.3
+ Cray Fortran Version 3.4.0.3
+ FreeBSD 4.7 gcc 2.95.4
+ g++ 2.95.5
+ HP-UX B.11.00 HP C HP92453-01 A.11.01.20
+ HP F90 v2.4
+ IRIX 6.5 MIPSpro cc 7.30
+ IRIX64 6.5 (64 & n32) MIPSpro cc 7.3.1.3m
+ F90 MIPSpro 7.3.1.3m (64 only)
+ Linux 2.4.18 gcc 3.2.1
+ g++ 3.2.1
+ Intel(R) C++ Version 6.0
+ Intel(R) Fortran Compiler Version 6.0
+ PGI compilers (pgcc, pgf90, pgCC) version 4.0-2
+ pgf90 3.2-4
+ OSF1 V5.1 Compaq C V6.4-014
+ Compaq Fortran X5.4A-1684
+ gcc version 3.0 for C++
+ SunOS 5.7 WorkShop Compilers 5.0 98/12/15 C 5.0
+ (Solaris 2.7) WorkShop Compilers 5.0 98/12/15 C++ 5.0
+ WorkShop Compilers 5.0 98/10/25
+ FORTRAN 90 2.0 Patch 107356-04
+ SunOS 5.8/32 Sun WorkShop 6 update 1 C 5.2 2000/09/11
+ (Solaris 2.8) Sun WorkShop 6 update 1 Fortran 95 6.1
+ Patch 109503-07 2001/08/11
+ Sun WorkShop 6 update 1 C++ 5.2 Patch
+ 109508-04 2001/07/11
+ SunOS 5.8/64 Sun WorkShop 6 update 1 C 5.2 2000/09/11
+ (Solaris 2.8) Sun WorkShop 6 update 1 Fortran 95 6.1
+ Patch 109503-07 2001/08/11
+ Sun WorkShop 6 update 1 C++ 5.2 Patch
+ 109508-04 2001/07/11
+ TFLOPS r1.0.4 v4.3.3 i386 pgcc Rel 3.1-4i with mpich-1.2.4 with
+ local modifications
+ IA-32 Linux 2.4.9 gcc 2.96
+ Intel(R) C++ Version 7.0
+ Intel(R) Fortran Compiler Version 7.0
+
+ IA-64 Linux 2.4.16 ia64 gcc version 2.96 20000731
+ Intel(R) C++ Version 7.0
+ Intel(R) Fortran Compiler Version 7.0
+ Windows 2000 (NT5.0) MSVC++ 6.0
+ DEC Visual Fortran 6.0
+ Windows XP .NET
+ Windows NT4.0 Code Warrior 6.0
+ MAC OS X Darwin 6.2
+ gcc and g++ Apple Computer, Inc. GCC
+ version 1161, based on gcc version 3.1
+
+
+
+Supported Configuration Features Summary
+========================================
+
+ In the tables below
+ y = tested and supported
+ n = not supported or not tested in this release
+ x = not working in this release
+ dna = does not apply
+ ( ) = footnote appears below second table
+
+
+ Platform C C F90 F90 C++ Shared zlib
+ parallel parallel libraries (5)
+ Solaris2.6 y n y n y y y
+ Solaris2.7 64-bit y y (1) y y (1) y y y
+ Solaris2.7 32-bit y y (1) y y (1) y y y
+ Solaris2.8 64-bit y n y y (1) y y y
+ Solaris2.8 32-bit y n y y (1) y y y
+ IRIX6.5 y y (1) n n n y y
+ IRIX64_6.5 64-bit y y (2) y y y y y
+ IRIX64_6.5 32-bit y y (2) n n n y y
+ HPUX11.00 y y (1) y n n y y
+ OSF1 v5.1 y n y n y y y
+ T3E (6) y n y n n n y
+ SV1 y n y n n n y
+ T90 IEEE y n y n n n y
+ TFLOPS n y (1) n n n n y
+ AIX-5.1 32-bit y y y y y n y
+ AIX-5.1 64-bit y y y y y n y
+ WinXP (7) y n n n y y y
+ WinNT/2000 y n y n y y y
+ WinNT CW y n n n n n y
+ Mac OS X 10.2 y n n n y y y
+ FreeBSD y y (1) n n y y y
+ Linux 2.2 y y (1) y y (1) y y y
+ Linux 2.4 gcc (3) y y (1) y n y y y
+ Linux 2.4 Intel (3) y n y n n n y
+ Linux 2.4 PGI (3) y n y n y n y
+ Linux 2.4 IA32 y n y n n n y
+ Linux 2.4 IA64 y n y n n n y
+
+
+ Platform static- Thread- SRB GASS STREAM-
+ exec safe VFD
+ Solaris2.6 x y n n y
+ Solaris2.7 64-bit x y n n y
+ Solaris2.7 32-bit x y n n y
+ Solaris2.8 64-bit x n n n y
+ Solaris2.8 32-bit x y n n y
+ IRIX6.5 x n n n y
+ IRIX64_6.5 64-bit x y n y y
+ IRIX64_6.5 32-bit x y n y y
+ HPUX11.00 x n n n y
+ OSF1 v5.1 y n n n y
+ T3E (6) y n n n y
+ SV1 y n n n y
+ T90 IEEE y n n n y
+ TFLOPS y n n n n
+ AIX-5.1 32-bit y n n n y
+ AIX-5.1 64-bit y n n n y
+ WinXP (7) dna n n n n
+ WinNT/2000 dna n n n n
+ WinNT CW dna n n n n
+ Mac OS X 10.2 y n n n y
+ FreeBSD y y n n y
+ Linux 2.2 y y n n y
+ Linux 2.4 gcc (3) y y n n y
+ Linux 2.4 Intel (3) y n n n y
+ Linux 2.4 PGI (3) y n n n y
+ Linux 2.4 IA32 y n n n y
+ Linux 2.4 IA64 y n n n y
+
+ Notes: (1) Using mpich 1.2.4.
+ (2) Using mpt and mpich 1.2.4.
+ (3) Linux 2.4 with GNU, Intel, and PGI compilers.
+ (4) No HDF4-related tools.
+ (5) Shared libraries are provided only for the C library,
+ except on Windows where they are provided for all languages.
+ (6) Debug mode only.
+ (7) Binaries only; source code for this platform is not being
+ released at this time.
+
+
+Known Problems
+==============
+
+ * On Linux 2.4 IA64, Fortran test fails for h5dwrite_vl_f
+ for integer and real base datatypes.
+
+ * When fortran library is built with Intel compilers, compilation
+ for fflush1.f90, fflush2.f90 and fortanlib_test.f90 will fail
+ complaining about EXEC function. Comment the call to EXEC subroutine
+ in each program, or get a patch for the HDF5 Fortran source code.
+
+ * Fortran external dataset test fails on Linux 2.4 with pgf90 compiler.
+
+ * On Windows, h5dump may abort printing if a VL string is longer than 4096
+ bytes due to a compiler problem. It'll be fixed in v1.6 release.
+
+ * Datasets or attributes which have a variable-length string datatype are
+ not printing correctly with h5dump and h5ls.
+
+ * When a dataset with the variable-length datatype is overwritten,
+ the library can develop memory leaks that cause the file to become
+ unnecessarily large. This is planned to be fixed in the next release.
+
+ * On the SV1, the h5ls test fails due to a difference between the
+ SV1 printf precision and the printf precision on other platforms.
+
+ * The h5dump tests may fail to match the expected output on some
+ platforms (e.g. SP2 parallel, Windows) where the error messages
+ directed to "stderr" do not appear in the "right order" with output
+ from stdout. This is not an error.
+
+ * The --enable-static-exec configure flag fails to compile for HP-UX
+ 11.00 platforms.
+
+ * The executables are always dynamic on IRIX64 6.5(64 and n32) and
+ IRIX 6.5 even if they are configured with --enable-static-exec.
+
+ * IRIX 6.5 fails to compile if configured with --enable-static-exec.
+
+ * The executables are always dynamic on Solaris 2.7 ans 2.8(64 and n32)
+ even if they are configured with --enable-static-exec.
+
+ * The HDF5_MPI_OPT_TYPES optimization code in the parallel HDF5 will cause
+ a hang in some cases when chunked storage is used. This is now set to
+ be off by default. One may turn it on by setting the environment
+ variable HDF5_MPI_OPT_TYPES to a non-zero value such as 1.
+
+ * On OSF1 v5.1 and IA32 h5dumpgentst program that generates test files
+ for h5dump, gives segmentation fault.
+
+ * On Windows platforms, C and Fortran tests fail with the debug DLL version
+ of the Library if built from all_withf90.zip file.
+
+ * On Cray T3E (sn6606 2.0.6.08 unicosmk CRAY T3E) with Cray Standard C Version 6.6.0.1.3
+ compiler optimization causes errors in many HDF5 Library tests. Use -g -h zero flags
+ to build HDF5 Library.
+
+ * On Cray SV1 10.0.1. 0 datatype convertion test fails. Please check HDF FTP site
+ if patch is available. We will try to provide one in the nearest future.
+
+ * For configuration, building and testing with Intel and PGI compilers see
+ corresponding section in INSTALL file.
+
+
+%%%%1.4.4%%%% Release Information for hdf5-1.4.4 (02/July/02)
+
+12. Release information for HDF5 version 1.4.4
+==============================================================================
INTRODUCTION
+This document describes the differences between HDF5-1.4.3 and
+HDF5-1.4.4, and contains information on the platforms tested and
+known problems in HDF5-1.4.4. For more details check the HISTORY.txt
+file in the HDF5 source.
+
+The HDF5 documentation can be found on the NCSA ftp server
+(ftp.ncsa.uiuc.edu) in the directory:
+
+ /HDF/HDF5/docs/
+
+For more information, see the HDF5 home page at:
+
+ http://hdf.ncsa.uiuc.edu/HDF5/
+
+If you have any questions or comments, please send them to:
+
+ hdfhelp@ncsa.uiuc.edu
+
+
+CONTENTS
+
+- New Features
+- Bug Fixes since HDF5-1.4.3
+- Performance Improvements
+- Documentation
+- Platforms Tested
+- Supported Configuration Features
+- Known Problems
+
+
+New Features
+============
+ o Configuration
+ ================
+ * The H4 to H5 tools have been removed from the main source and placed
+ in a separate package. You can get these tools from the HDF ftp site
+ (ftp://hdf.ncsa.uiuc.edu/). The "--with-hdf4" command-line option
+ during configure is no longer valid. BW - 2002/06/25
+
+ o Library
+ =========
+ o General
+ ---------
+ * Fill-value forward-compatibility with release 1.5 was added. SLU -
+ 2002/04/11
+ * A new query function H5Tget_member_index has been added for compound
+ and enumeration data types. This function retrieves a member's index
+ by name. SLU - 2002/04/05
+ * Added serial multi-gigabyte file size test. "test/big -h" shows
+ the help page. AKC - 2002/03/29
+
+ o APIs
+ ------
+ * The F90 subroutines h5dwrite_f, h5dread_f, h5awrite_f, and h5aread_f
+ were overloaded with a "dims" argument of type INTEGER(HSIZE_T) to
+ specify the size of the array. We recommend using these subroutines
+ with the new type; module subroutines that accept "dims" as an i
+ INTEGER array of size 7 will be deprecated in release 1.6.
+ EIP - 2002/05/06
+
+ o Performance
+ -------------
+ * Added internal "small data" aggregation, which can reduce the number of
+ actual I/O calls made, improving performance. QAK - 2002/06/05
+ * Improved internal metadata aggregation, which can reduce the number of
+ actual I/O calls made, improving performance. Additionally, this can
+ reduce the size of files produced. QAK - 2002/06/04
+ * Improved internal metadata caching, which can reduce the number of
+ actual I/O calls made by a substantial amount, improving
+ performance. QAK - 2002/06/03
+
+
+ o Parallel library
+ ==================
+ * Fixed bug in parallel I/O routines where a collective I/O which used
+ MPI derived types, followed by an independent I/O would cause the library
+ to hang. QAK 2002/06/24
+ * Added environment variable flag to control whether creating MPI derived
+ types is preferred or not. This can affect performance, depending on
+ which way the MPI-I/O library is optimized. The default is set to
+ prefer MPI derived types for collective raw data transfers; setting the
+ HDF5_MPI_PREFER_DERIVED_TYPES environment variable to "0" (i.e.:
+ "setenv HDF5_MPI_PREFER_DERIVED_TYPES 0") changes the preference to avoid
+ using them whenever possible. QAK - 2002/06/19
+ * Changed MPI I/O routines to avoid creating MPI derived types (and thus
+ needing to set the file view) for contiguous selections within datasets.
+ This should result in some performance improvement for those types of
+ selections. QAK - 2002/06/18
+ * Changed MPI type support for collective I/O to be enabled by default.
+ This can be disabled by setting the HDF5_MPI_OPT_TYPES environment
+ variable to the value "0". QAK - 2002/06/14
+ * Allowed chunks in chunked datasets to be cached when parallel file is
+ opened for read-only access (bug #709). QAK - 2002/06/10
+ * Changed method for allocating chunked dataset blocks to only allocate
+ blocks that don't already exist, instead of attempting to create all the
+ blocks all the time. This improves performance for chunked
+ datasets. QAK - 2002/05/17
+ * Allowed the call to MPI_File_sync to be avoided when the file is going to
+ immediately be closed, improving performance. QAK - 2002/05/13
+ * Allowed the metadata writes to be shared among all processes, easing the
+ burden on process 0. QAK - 2002/05/10
+
+
+ o Tools
+ =======
+ * h5redeploy utility was added. It updates HDF5 compiler tools
+ after the HDF5 software has been installed in a new location.
+
+
+ o Support for new platforms and languages
+ =========================================
+ * Parallel Fortran Library works now on HP-UX B.11.00 Sys V.
+ EIP - 2002/05/06
+ * Intel C++ and F90 compilers Version 6.0 are supported on Linux 2.4.
+ * Intel C++ compilers Version 6.0 are supported on Windows 2000.
+
+
+ o Misc.
+ =========================================
+ * zlib has been moved out of the Windows source release. Users should go to
+ the ZLIB homepage(http://www.zlib.org) to download the corresponding
+ zlib library.
+ * The Windows binary release is built with the old version of the zlib
+ library. We expect users to use zlib 1.1.4 to build with the source
+ release.
+ * In the Windows-specific install document, we specify how to test backward
+ compatibility. However, in this release, we are not testing the backward
+ compatibility of HDF5.
+
+
+Bug Fixes since HDF5-1.4.3 Release
+==================================
+ * Fixed bug in chunking routines where they were using internal allocation
+ free routines, instead of malloc/free, preventing user filters from
+ working correctly. Chunks are now allocated/freed with malloc/free and
+ so should the chunks in user filters. QAK 2002/06/18
+ * Fixed bug where regular hyperslab selection could get incorrectly
+ transferred when the number of elements in a row did not fit evenly
+ into the buffer provided. QAK 2002/06/12
+ * Fixed bug (#499) which allowed an "empty" compound or enumerated datatype
+ (one with no members) to be used to create a dataset or to be committed
+ to a file. QAK - 2002/06/11
+ * Fixed bug (#777) which allowed a compound datatype to be inserted into
+ itself. QAK - 2002/06/10
+ * Fixed bug (#789) where creating 1-D dataset region reference caused the
+ library to go into infinite loop. QAK - 2002/06/10
+ * Fixed bug (#699, fix provided by a user) where a scalar dataspace was
+ written to the file and then subsequently queried with the
+ H5Sget_simple_extent_type function; type was reported as H5S_SIMPLE
+ instead of H5S_SCALAR. EIP - 2002/06/04
+ * Clear symbol table node "dirty" flag when flushing symbol tables to
+ disk, to reduce I/O calls made & improve performance. QAK - 2002/06/03
+ * Fixed bug where an object's header could get corrupted in certain
+ obscure situations when many objects were created in the
+ file. QAK - 2002/05/31
+ * Fixed bug where read/write intent in file IDs created with H5Freopen
+ was not being kept the same as the original file. QAK - 2002/05/14
+ * Fixed bug where selection offsets were not being used when iterating
+ through point and hyperslab selections with
+ H5Diterate(). QAK - 2002/04/29
+ * Fixed bug where the data for several level deep nested compound &
+ variable-length datatypes used for datasets were getting corrupted when
+ written to the file. QAK - 2002/04/17
+ * Fixed bug where selection offset was being ignored for certain hyperslab
+ selections when optimized I/O was being performed. QAK - 2002/04/02
+ * Fixed limitation in h5dumper with object names which reached over 1024
+ characters in length. We can now handle arbitrarily larger sizes for
+ object names. BW - 2002/03/29
+ * Fixed bug where variable-length string type did not behave as a
+ string. SLU - 2002/03/28
+ * Fixed bug in H5Gget_objinfo() which was not setting the 'fileno'
+ of the H5G_stat_t struct. QAK - 2002/03/27
+ * Fixed data corruption bug in hyperslab routines when contiguous
+ hyperslab that spans entire dimension and is larger than type
+ conversion buffer is attempted to be read. QAK - 2002/03/26
+
+
+Performance Improvements
+========================
+ This release of the HDF5 library has been extensively tuned to improve
+performance, especially to improve parallel I/O performance.
+ Most of the specific information for particular performance improvements
+is mentioned in the "New Features" and "Bug Fixes since HDF5-1.4.3" sections
+of this document, but in general, the library should make fewer and larger
+I/O requests when accessing a file. Additionally, improvements to the parallel
+I/O portions of the library should have reduced the communications and barriers
+used in various internal algorithms, improving the performance of the library.
+ However, with the extensive changes to some portions of the library that
+were required for these improvements, some errors or unanticipated results may
+have been introduced also. Please report any problems encountered to our
+support team at hdfhelp@ncsa.uiuc.edu.
+ Hopefully these improvements will benefit all HDF5 applications, but if
+there are particular I/O patterns that appear to be slower than necessary,
+please send e-mail to hdfhelp@ncsa.uiuc.edu with a sample program showing the
+problem behavior; we will look into the issue to see if it is possible to
+address it.
+
+
+Documentation
+=============
+ * Documentation was updated for the hdf5-1.4.4 release.
+ * A new "HDF5 User's Guide" is under development. See
+ http://hdf.ncsa.uiuc.edu/HDF5/doc_dev_snapshot/H5_NewUG/current/.
+ * A "Parallel HDF5 Tutorial" is available at
+ http://hdf.ncsa.uiuc.edu/HDF5/doc/Tutor/.
+ * The "HDF5 Tutorial" is not distributed with this release. It is
+ available at http://hdf.ncsa.uiuc.edu/HDF5/doc/Tutor/.
+
+
+Platforms Tested
+================
+
+ AIX 4.3.3.0 (IBM SP powerpc) xlc 5.0.2.0
+ mpcc_r 5.0.2.0
+ xlf 07.01.0000.0002
+ mpxlf 07.01.0000.0002
+ AIX 4.3 (IBM SP RS6000) C for AIX Compiler, Version 5.0.2.0
+ xlf 7.1.0.2
+ poe 3.1.0.12 (includes mpi)
+ AIX 5.1 xlc 5.0.2.0
+ xlf 07.01.0000.0002
+ mpcc_r 5.0.2.0; mpxlf_r 07.01.0000.0002
+ Cray T3E sn6711 2.0.5.57 Cray Standard C Version 6.5.0.3
+ Cray Fortran Version 3.5.0.4
+ Cray SV1 10.0.1.1 Cray Standard C Version 6.5.0.3
+ Cray Fortran Version 3.5.0.4
+ FreeBSD 4.6 gcc 2.95.4
+ g++ 2.95.4
+ HP-UX B.10.20 HP C HP92453-01 A.10.32.30
+ HP F90 v2.3
+ HP-UX B.11.00 HP C HP92453-01 A.11.01.20
+ HP F90 v2.4
+ HP-UX B.11.00 SysV HP C HP92453-01 A.11.01.20
+ HP F90 v2.4
+ HP MPI [not a product] (03/24/2000) B6060BA
+ IRIX 6.5 MIPSpro cc 7.30
+ IRIX64 6.5 (64 & n32) MIPSpro cc 7.3.1.3m
+ F90 MIPSpro 7.3.1.3m (64 only)
+ Linux 2.4.9-31smp gcc 2.95.3
+ g++ 2.95.3
+ Intel(R) C++ Version 6.0
+ Intel(R) Fortran Compiler Version 6.0
+ MPICH 1.2.2
+ Linux 2.2.18smp gcc 2.95.2
+ gcc 2.95.2 with mpich 1.2.1
+ g++ 2.95.2
+ pgf90 3.2-4
+ OSF1 V5.1 Compaq C V6.4-014
+ Compaq Fortran V5.5-1877-48BBF
+ gcc version 3.0 for C++
+ SunOS 5.7 WorkShop Compilers 5.0 98/12/15 C 5.0
+ (Solaris 2.7) WorkShop Compilers 5.0 98/12/15 C++ 5.0
+ WorkShop Compilers 5.0 98/10/25
+ FORTRAN 90 2.0 Patch 107356-04
+ SunOS 5.8/32 Sun WorkShop 6 update 1 C 5.2 2000/09/11
+ (Solaris 2.8) Sun WorkShop 6 update 1 Fortran 95 6.1
+ Patch 109503-07 2001/08/11
+ Sun WorkShop 6 update 1 C++ 5.2 Patch
+ 109508-04 2001/07/11
+ SunOS 5.8/64 Sun WorkShop 6 update 1 C 5.2 2000/09/11
+ (Solaris 2.8) Sun WorkShop 6 update 1 Fortran 95 6.1
+ Patch 109503-07 2001/08/11
+ Sun WorkShop 6 update 1 C++ 5.2 Patch
+ 109508-04 2001/07/11
+ TFLOPS r1.0.4 v4.2.2 i386 pgcc Rel 3.1-4i with mpich-1.2.3 with
+ local modifications
+ IA-32 Linux 2.4.9 cc Intel 5.0.1
+ gcc 2.96
+ Intel(R) C++ Version 6.0
+ Intel(R) Fortran Compiler Version 6.0
+
+ IA-64 Linux 2.4.16 ia64 gcc version 2.96 20000731
+ Intel(R) C++ Version 6.0
+ Intel(R) Fortran Compiler Version 6.0
+ Windows 2000 (NT5.0) MSVC++ 6.0
+ DEC Visual Fortran 6.0
+ Windows NT4.0 MSVC++ 6.0
+ DEC Visual Fortran 6.0
+ Windows NT4.0 Code Warrior 6.0
+
+
+Supported Configuration Features Summary
+========================================
+
+ In the tables below
+ y = tested and supported
+ n = not supported or not tested in this release
+ x = not working in this release
+ ( ) = footnote appears below second table
+
+
+ Platform C C F90 F90 C++ Shared zlib Tools
+ parallel parallel libraries(5)
+ Solaris2.6 y n y n y y y y
+ Solaris2.7 64 y y (1) y n y y y y
+ Solaris2.7 32 y y (1) y n y y y y
+ Solaris2.8 64 y n y n y y y y
+ Solaris2.8 32 y n y n y y y y
+ IRIX6.5 y y (1) n n n y y y
+ IRIX64_6.5 64 y y (2) y y n y y y
+ IRIX64_6.5 n32 y y (2) n n n y y y
+ HPUX10.20 y n y n n y y y
+ HPUX11.00 y n y n n y y y
+ HPUX11 SysV y y y y n y y y
+ OSF1 v5.1 y n y n y y y y
+ T3E y y y y n n y y
+ SV1 y n y n n n y y
+ TFLOPS n y (1) n n n n y y (4)
+ AIX-4.3 y y y y y n y y
+ AIX-5.1 y y y y n n y y
+ WinNT/2000 y n y n y y y y
+ WinNT CW y n n n n n y y
+ FreeBSD y n n n y y y y
+ Linux 2.2 y y (1) y n y y y y
+ Linux 2.4 y y (1) n n y y y y
+ Linux 2.4 Intel(6) y n y n y n y y
+ Linux 2.4 IA32 y n y n n n y y
+ Linux 2.4 IA64 y n y n n n y y
+
+
+ Platform 1.2 static- Thread- SRB GASS STREAM-
+ compatibility exec safe VFD
+ Solaris2.6 y x y n n y
+ Solaris2.7 64 y x y n n y
+ Solaris2.7 32 y x y n n y
+ Solaris2.8 64 y y n n n y
+ Solaris2.8 32 y x y n n y
+ IRIX6.5 y x n n n y
+ IRIX64_6.5 64 y x y n y y
+ IRIX64_6.5 n32 y x y n y y
+ HPUX10.20 y y n n n y
+ HPUX11.00 y x n n n y
+ HPUX11 SysV y x n n n y
+ OSF1 v5.1 y y n n n y
+ T3E y y n n n y
+ SV1 y y n n n y
+ TFLOPS y y n n n n
+ AIX-4.3 y y (3) n n n y
+ AIX-5.1 y y n n n y
+ WinNT/2000 y y n n n n
+ WinNT CW n n n n n n
+ FreeBSD y y y n n y
+ Linux 2.2 y y y n n y
+ Linux 2.4 y y y n n y
+ Linux 2.4 Intel(6) y y n n n y
+ Linux 2.4 IA32 y y n n n y
+ Linux 2.4 IA64 y y n n n y
+
+
+ Footnotes: (1) Using mpich.
+ (2) Using mpt and mpich.
+ (3) When configured with static-exec enabled, tests fail in
+ serial mode.
+ (4) No HDF4-related tools.
+ (5) Shared libraries are provided only for the C library,
+ except on Windows where they are provided for all languages.
+ (6) Linux 2.4 with Intel compilers.
+
+
+Known Problems
+==============
+
+ * Datasets or attributes which have a variable-length string datatype are
+ not printing correctly with h5dump and h5ls.
+
+ * When a dataset with the variable-length datatype is overwritten,
+ the library can develop memory leaks that cause the file to become
+ unnecessarily large. This is planned to be fixed in the next release.
+
+ * On the SV1, the h5ls test fails due to a difference between the
+ SV1 printf precision and the printf precision on other platforms.
+
+ * The h5dump tests may fail to match the expected output on some
+ platforms (e.g. SP2 parallel, Windows) where the error messages
+ directed to "stderr" do not appear in the "right order" with output
+ from stdout. This is not an error.
+
+ * The --enable-static-exec configure flag fails to compile for HP-UX
+ 11.00 platforms.
+
+ * The executables are always dynamic on IRIX64 6.5(64 and n32) and
+ IRIX 6.5 even if they are configured with --enable-static-exec.
+
+ * IRIX 6.5 fails to compile if configured with --enable-static-exec.
+
+ * The HDF5_MPI_OPT_TYPES optimization code in the parallel HDF5 will cause
+ a hang in some cases when chunked storage is used. This is now set to
+ be off by default. One may turn it on by setting the environment
+ variable HDF5_MPI_OPT_TYPES to a non-zero value such as 1.
+
+ * On IA32 and IA64 systems, if you use a compiler other than GCC (such as
+ Intel's ecc or icc compilers), you will need to modify the generated
+ "libtool" program after configuration is finished. On or around line 104
+ of the libtool file, there are lines which look like:
+
+ # How to pass a linker flag through the compiler.
+ wl=""
+
+ Change these lines to this:
+
+ # How to pass a linker flag through the compiler.
+ wl="-Wl,"
+
+ * To build the Fortran library using Intel compilers, one has to
+ x modify the source code in the fortran/src directory to remove the
+ !DEC and !MS compiler directives.
+ x The build will fail in the fortran/test directory and then in the
+ fortran/examples directory; to proceed, edit the work.pcl files in
+ those directories to contain two lines
+
+ work.pc
+ ../src/work.pc
+
+ * To build the Fortran library on IA64 use
+ setenv CC "ecc -DIA64"
+ setenv F9X "efc -cl,work.pcl"
+ before running configure and see the steps described above.
+
+
+%%%%1.4.3%%%% Release Information for hdf5-1.4.3 (18/Februaru/02)
+
+11. Release information for HDF5 version 1.4.3
+==============================================================================
+
+
+INTRODUCTION
+
+This document describes the differences between HDF5-1.4.2 and
+HDF5-1.4.3, and contains information on the platforms tested and
+known problems in HDF5-1.4.2. For more details check the HISTORY.txt
+file in the HDF5 source.
+
+The HDF5 documentation can be found on the NCSA ftp server
+(ftp.ncsa.uiuc.edu) in the directory:
+
+ /HDF/HDF5/docs/
+
+For more information look at the HDF5 home page at:
+
+ http://hdf.ncsa.uiuc.edu/HDF5/
+
+If you have any questions or comments, please send them to:
+
+ hdfhelp@ncsa.uiuc.edu
+
+
+CONTENTS
+
+- New Features
+- Bug Fixes since HDF5-1.4.2
+- Documentation
+- Platforms Tested
+- Supported Configuration Features
+- Known Problems
+
+
+New Features
+============
+ o Configuration
+ ================
+ * Can use just enable-threadsafe if the C compiler has built-in pthreads
+ support.
+
+ o Library
+ =========
+ o General
+ ---------
+ * Added a new test to verify the information provided by the configure
+ command.
+ * Changed internal error handling macros to reduce code size of library by
+ about 10%.
+
+ o APIs
+ ------
+ * Changed prototype for H5Awrite from:
+ H5Awrite(hid_t attr_id, hid_t type_id, void *buf)
+ to:
+ H5Awrite(hid_t attr_id, hid_t type_id, const void *buf)
+ * The H5Pset_fapl_split() accepts raw and meta file names similar to the
+ syntax of H5Pset_fapl_multi() in addition to what it used to accept.
+
+ C++ API:
+ * Added operator= to class PredType
+ * Add the overloaded member function Attribute::getName to return
+ the attribute name's length as in C API. Note that the current
+ Attribute::getName, that returns "string", is still available.
+ * Following the change in the C library, the corresponding C++ API
+ is changed from:
+ void Attribute::write( const DataType& mem_type, void *buf )
+ to:
+ void Attribute::write( const DataType& mem_type, const void *buf )
+
+ o Performance
+ -------------
+ * Added perform programs to test the HDF5 library performance. Programs
+ are installed in directory perform/.
+ * Improved performance of byte-swapping during data conversions.
+ * Improved performance of single, contiguous hyperslabs when reading or
+ writing.
+ * Added support to read/write portions of chunks directly, if they are
+ uncompressed and too large to cache. This should speed up I/O on chunked
+ datasets for a few more cases. -QAK, 1/31/02
+
+ o Parallel Library
+ ==================
+ * Parallel C HDF5 now works on HP-UX platforms, Compaq clusters,
+ Linux clusters, Cplants (alpha-linux clusters).
+
+ o Tools
+ =======
+ * A helper script called ``h5cc'', which helps compilation of HDF5
+ programs, is now distributed with HDF5. See the reference manual
+ for information on how to use this feature.
+ * The H5Dumper can now dump comments associated with groups. -WCW 01-05-02
+
+ o Support for new platforms and languages
+ =========================================
+ * HDF5 C++ Library is supported on Windows platforms (shared and static)
+ * HDF5 F90 shared library is supported on Windows platforms.
+ * HDF5 C Library is supported on IA32 and IA64 platforms.
+
+
+
+Bug Fixes since HDF5-1.4.2 Release
+==================================
+
+ * Fixed a bug when reading chunked datasets where the edge of the dataset
+ would be incorrectly detected and generate an assertion failure.
+ * Fixed a bug where reading an entire dataset wasn't being handled
+ optimally when the dataset had unlimited dimensions. Dataset is read
+ in a single low-level I/O now, instead of being broken into separate
+ pieces internally.
+ * Fixed a bug where reading or writing chunked data which needed datatype
+ conversion could result in data values getting corrupted.
+ * Fixed a bug where appending a point selection to the current selection
+ would not actually append the point when there were no points defined
+ currently.
+ * Fixed a bug where 'or'ing a hyperslab with a 'none' selection would
+ fail. Now adds that hyperslab as the first hyperlab in the selection.
+ * Fixed a bug in the 'big' test where quota limits weren't being detected
+ properly if they caused close() to fail.
+ * Fixed a bug in internal B-tree code where a B-tree was not being copied
+ correctly.
+ * Fixed an off-by-one error in H5Sselect_valid when hyperslab selections
+ which would allow hyperslab selections which overlapped the edge of the
+ selection by one element as valid.
+ * Fixed the internal macros used to encode & decode file metadata, to avoid
+ an unaligned access warning on IA64 machines.
+ * Corrected behavior of H5Tinsert to not allow compound datatype fields to
+ be inserted past the end of the datatype.
+ * Retired the DPSS virtual file driver (--with-gridstorage configure
+ option).
+ * Fixed bug where variable-length datatypes for attributes was not working
+ correctly.
+ * Fixed bug where raw data re-allocated from the free-list would sometimes
+ overlap with the metadata accumulator and get corrupted. QAK - 1/23/02
+ * Fixed bug where a preempted chunk in the chunk data could still be
+ used by an internal pointer and cause an assertion failure or core
+ dump. QAK - 2/13/02
+ * Fixed bug where non-zero fill-value was not being read correctly from
+ certain chunked datasets when using an "all" or contiguous hyperslab
+ selection. QAK - 2/14/02
+
+
+Documentation
+=============
+ * Documentation was updated for the hdf5-1.4.3 release.
+ * A new "HDF5 User's Guide" is under development. See
+ http://hdf.ncsa.uiuc.edu/HDF5/doc_dev_snapshot/H5_NewUG/current/.
+ * Parallel Tutorial is available at http://hdf.ncsa.uiuc.edu/HDF5/doc/Tutor/
+
+
+Platforms Tested
+================
+
+ AIX 4.3.3.0 (IBM SP powerpc) xlc 5.0.2.0
+ mpcc_r 5.0.2.0
+ xlf 07.01.0000.0002
+ mpxlf 07.01.0000.0002
+ AIX 4.3 (IBM SP RS6000) C for AIX Compiler, Version 5.0.2.0
+ xlf 7.1.0.2
+ poe 3.1.0.12 (includes mpi)
+ Cray T3E sn6711 2.0.5.57 Cray Standard C Version 6.5.0.3
+ Cray Fortran Version 3.5.0.4
+ Cray SV1 10.0.0.8 Cray Standard C Version 6.5.0.3
+ Cray Fortran Version 3.5.0.4
+ FreeBSD 4.5 gcc 2.95.3
+ g++ 2.95.3
+ HP-UX B.10.20 HP C HP92453-01 A.10.32.30
+ HP F90 v2.3
+ HP-UX B.11.00 HP C HP92453-01 A.11.01.20
+ HP F90 v2.4
+ HP-UX B.11.00 SysV HP C HP92453-01 A.11.01.20
+ HP F90 v2.4
+ HP MPI [not a product] (03/24/2000) B6060BA
+ IRIX 6.5 MIPSpro cc 7.30
+ IRIX64 6.5 (64 & n32) MIPSpro cc 7.3.1.2m
+ Linux 2.4.4 gcc 2.95.3
+ g++ 2.95.3
+ Linux 2.2.18smp gcc 2.95.2
+ gcc 2.95.2 with mpich 1.2.1
+ g++ 2.95.2
+ pgf90 3.2-4
+ OSF1 V5.1 Compaq C V6.3-028
+ Compaq Fortran V5.4-1283
+ SunOS 5.7 WorkShop Compilers 5.0 98/12/15 C 5.0
+ (Solaris 2.7) Workshop Compilers 5.0 98/12/15 C++ 5.0
+ Workshop Compilers 5.0 98/10/25
+ FORTRAN 90 2.0 Patch 107356-04
+ SunOS 5.8/32 Sun WorkShop 6 update 1 C 5.2 2000/09/11
+ (Solaris 2.8) Sun WorkShop 6 update 1 Fortran 95 6.1
+ Patch 109503-07 2001/08/11
+ Sun WorkShop 6 update 1 C++ 5.2 Patch
+ 109508-04 2001/07/11
+ SunOS 5.8/64 Sun WorkShop 6 update 1 C 5.2 2000/09/11
+ (Solaris 2.8) Sun WorkShop 6 update 1 Fortran 95 6.1
+ Patch 109503-07 2001/08/11
+ Sun WorkShop 6 update 1 C++ 5.2 Patch
+ 109508-04 2001/07/11
+ TFLOPS r1.0.4 v4.0.8 i386 pgcc Rel 3.1-4i with mpich-1.2.1 with
+ local modifications
+ IA-32 Linux 2.2.10smpx cc Intel 5.0.1
+ egcs-2.91.66
+ IA-64 Linux 2.4.16 ia64 gcc version 2.96 20000731
+ Intel(R) C++ Itanium(TM) Compiler
+ for the Itanium(TM)-based applications,
+ Version 6.0 Beta, Build 20010905
+ Windows 2000 (NT5.0) MSVC++ 6.0
+ DEC Visual Fortran 6.0
+ Windows NT4.0 MSVC++ 6.0
+ DEC Visual Fortran 6.0
+ Windows NT4.0 Code Warrior 6.0
+ Windows 98 MSVC++ 6.0
+ DEC Visual Fortran 6.0
+
+
+Supported Configuration Features Summary
+========================================
+
+ In the tables below
+ y = tested and supported
+ n = not supported or not tested in this release
+ x = not working in this release
+ ( ) = footnote appears below second table
+
+
+ Platform C C F90 F90 C++ Shared zlib Tools
+ parallel parallel libraries
+ (5)
+ Solaris2.7 y y (1) y n y y y y
+ Solaris2.8 64 y n y n y y y y
+ Solaris2.8 32 y n y n y y y y
+ IA-64 y n n n n n y y
+ IRIX6.5 y y (1) n n n y y y
+ IRIX64_6.5 64 y y (2) y y n y y y
+ IRIX64_6.5 32 y y (2) n n n y y y
+ HPUX10.20 y n y n n y y y
+ HPUX11.00 y y y n n y y y
+ HPUX11 SysV y y y n n y y y
+ DECOSF y n y n y y y y
+ T3E y y y y n n y y
+ SV1 y n y n n n y y
+ TFLOPS y y (1) n n n n y y (4)
+ AIX-4.3 SP2 y y y y n n y n
+ AIX-4.3 SP3 y y y y y n y n
+ Win2000 y n y n y (6) y y y
+ Win98 y n y n y (6) y y y
+ WinNT y n y n y (6) y y y
+ WinNT CW y n n n n n y y
+ FreeBSD y n n n y y y y
+ Linux 2.2 y y (1) y n y y y y
+ Linux 2.4 y y (1) n n y y y y
+
+
+ Platform 1.2 static- Thread- SRB GASS STREAM-
+ compatibility exec safe VFD
+ Solaris2.7 n x y n n y
+ Solaris2.8 64 n y n n n y
+ Solaris2.8 32 n x n n n y
+ IA-64 n n n n n y
+ IRIX6.5 n x y n n y
+ IRIX64_6.5 64 n x y n y y
+ IRIX64_6.5 32 n x y n y y
+ HPUX10.20 n y n n n y
+ HPUX11.00 n x n n n y
+ HPUX11 SysV n x n n n y
+ DECOSF n y n n n y
+ T3E n y n n n y
+ SV1 n y n n n y
+ TFLOPS n y n n n n
+ AIX-4.3 SP2 n y (3) n n n y
+ AIX-4.3 SP3 n y n n n y
+ Win2000 n y n n n n
+ Win98 n y n n n n
+ WinNT n y n n n n
+ WinNT CW n n n n n n
+ FreeBSD n y y n n y
+ Linux 2.2 n y y n n y
+ Linux 2.4 n y y n n y
+
+
+ Footnotes: (1) Using mpich.
+ (2) Using mpt and mpich.
+ (3) When configured with static-exec enabled, tests fail
+ in serial mode.
+ (4) No HDF4-related tools.
+ (5) Shared libraries are provided only for the C library.
+ (6) Exception of (5): DLL is available for C++ API on Windows
+
+
+Known Problems
+==============
+
+ * Datasets or attributes which have a variable-length string datatype are
+ not printing correctly with h5dump and h5ls.
+
+ * When a dataset with the variable-legth datatype is overwritten,
+ the library can develop memory leaks that cause the file to become
+ unnecessarily large. This is planned to be fixed in the next release.
+
+ * On the SV1, the h5ls test fails due to a difference between the
+ SV1 printf precision and the printf precision on other platforms.
+
+
+ * The h5dump tests may fail to match the expected output in some
+ platforms (e.g. SP2 parallel, Windows) where the error messages
+ directed to "stderr" do not appear in the "right order" with output
+ from stdout. This is not an error.
+
+ * The --enable-static-exec configure flag fails to compile for HP-UX
+ 11.00 platforms.
+
+ * The executables are always dynamic on IRIX64 6.5(64 and n32) and
+ IRIX 6.5 even if they are configured with --enable-static-exec.
+
+ * IRIX 6.5 fails to compile if configured with --enable-static-exec.
+
+ * The HDF5_MPI_OPT_TYPES optimization code in the parallel HDF5 will cause
+ a hang in some cases when chunked storage is used. This is now set to
+ be off by default. One may turn it on by setting environment variable
+ HDF5_MPI_OPT_TYPES to a non-zero value such as 1.
+
+ * On IA64 systems one has to use -DIA64 compilation flag to compile
+ h4toh5 and h5toh4 utilites. After configuration step manually modify
+ Makefile in the tools/h4toh4 and tools/h5toh4 directories to add
+ -DIA64 to the compilation flags.
+
+ * On IA32 ansd IA64 systems, if you use a compiler other than GCC
+ (such as Intel's ecc compiler), you will need to modify the generated
+ "libtool" program after configuration is finished. On or around line 102
+ of the libtool file, there are lines which look like:
+
+ # How to pass a linker flag through the compiler.
+ wl=""
+
+ change the lines to this:
+
+ # How to pass a linker flag through the compiler.
+ wl="-Wl,"
+
+
+%%%%1.4.2%%%% Release Information for hdf5-1.4.2 (31/July/01)
+
+10. Release Information for hdf5-1.4.2
+=================================================================
+
+
+INTRODUCTION
+
+This document describes the differences between HDF5-1.4.1 and
+HDF5-1.4.2, and contains information on the platforms tested and
+known problems in HDF5-1.4.2.
+
+The HDF5 documentation can be found on the NCSA ftp server
+(ftp.ncsa.uiuc.edu) in the directory:
+
+ /HDF/HDF5/docs/
+
+For more information look at the HDF5 home page at:
+
+ http://hdf.ncsa.uiuc.edu/HDF5/
+
+If you have any questions or comments, please send them to:
+
+ hdfhelp@ncsa.uiuc.edu
+
+
+CONTENTS
+
+- New Features
+- Bug Fixes since HDF5-1.4.1
+- Documentation
+- Platforms Tested
+- Supported Configuration Features
+- Known Problems
+
+
+New Features
+============
+
+ * File sizes greater than 2GB are now supported on Linux systems with
+ version 2.4.x or higher kernels.
+ * Added a global string variable H5_lib_vers_info_g which holds the
+ HDF5 library version information. This can be used to identify
+ an hdf5 library or hdf5 application binary.
+ Also added a verification of the consistency between H5_lib_vers_info_g
+ and other version information in the source code.
+ * Parallel HDF5 now runs on the HP V2500 and HP N4000 machines.
+ * F90 API:
+ - Added aditional parameter "dims" to the h5dread_f/h5dwrite_f and
+ h5aread_f/h5awrite_f subroutines. This parameter is a 1-D array
+ of size 7 and contains the sizes of the data buffer dimensions.
+ This change enables portability between Windows and UNIX platforms.
+ In previous versions of the F90 APIs, the data buffer parameters of
+ the above functions were declared as assumed-shape arrays, which
+ were passed to the C functions by a descriptor. There is no
+ portable means, however, of passing descriptors from F90 to C,
+ causing portability problems between Windows and UNIX and among
+ UNIX platforms. With this change, the data buffers are assumed-
+ size arrays, which can be portably passed to the C functions.
+ * F90 static library is available on Windows platforms.
+ See INSTALL_Windows_withF90.txt for details.
+ * F90 APIs are available on HPUX 11.00 and 10.20 and IBM SP platforms.
+ * H5 <-> GIF convertor has been added. This is available under
+ tools/gifconv. The convertor supports the ability to create animated
+ gifs as well.
+ * Verified correct operation of library on Solaris 2.8 in both 64-bit and
+ 32-bit compilation modes. See INSTALL document for instructions on
+ compiling the distribution with 64-bit support.
+ * Added support for the Metrowerks Code Warrior compiler for Windows.
+ * For H4->H5 converter utility, added a new option to choose not to convert
+ HDF4 specified attributes(reference number, class) into HDF5 attributes.
+ * Added support chunking and compression in SDS and image in H4->H5 converter.
+ Currently HDF5 only supports gzip compression, so by default an HDF4 file
+ with any other compression method will be converted into an HDF5 file in
+ gzip compression.
+ * correct the order or reading HDF4 image array in H4->H5 conversion.
+ * Added new parallel hdf5 tests in t_mpi. The new test checks if the
+ filesystem or the MPI-IO can really handle greater than 2GB files.
+ If it fails, it prints information message only without failing the
+ test.
+ * Added a parallel HDF5 example examples/ph5example.c to illustrate
+ the basic way of using parallel HDF5.
+ * Added a new public macro, H5_VERS_INFO, which is a string holding
+ the HDF5 library version information. This string is also compiled
+ into all HDF5 binary code which helps to identify the version information
+ of the binary code. One may use the Unix strings command on the binary
+ file and looks for the pattern "HDF5 library version".
+ * Added new checking in H5check_version() to verify the five HDF5 version
+ information macros (H5_VERS_MAJOR, H5_VERS_MINOR, H5_VERS_RELEASE,
+ H5_VERS_SUBRELEASE and H5_VERS_INFO) are consistent.
+
+
+Bug Fixes since HDF5-1.4.1 Release
+==================================
+
+ * Fixed bug with non-zero userblock sizes causing raw data to not
+ write correctly.
+ * Fixed problems with Pablo build and linking with non-standard MPI I/O.
+ * Fixed build on Linux systems with --enable-static-exec flag. It now
+ works correctly.
+ * IMPORTANT: Fixed file metadata corruption bug which could cause
+ metadata data loss in certain situations.
+ * The allocation by alignment (H5Pset_alignment) feature code somehow
+ got dropped in some 1.3.x version. Re-implemented it with "new and
+ improved" algorithm. It keeps track of "wasted" file-fragment in
+ the free-list too.
+ * Removed limitation that the data transfer buffer size needed to be
+ set for datasets whose dimensions were too large for the 'all'
+ selection code to handle. Any size dimensioned datasets should be
+ handled correctly now.
+ * Changed behavior of H5Tget_member_type to correctly emulate HDF5 v1.2.x
+ when --enable-hdf5v1_2 configure flag is enabled.
+ * Added --enable-linux-lfs flag to allow more control over whether to
+ enable or disable large file support on Linux.
+ * Fixed various bugs releated to SDS dimensional scale conversions in H4->H5
+ converter.
+ * Fixed a bug to correctly convert HDF4 objects with fill value into HDF5.
+ * Fixed a bug of H5pubconf.h causing repeated definitions if it is included
+ more than once. hdf5.h now includes H5public.h which includes
+ H5pubconf.h. Applications should #include hdf5.h which handles multiple
+ inclusion correctly.
+ * Fixed H5FDmpio.h to be C++ friendly by making Parallel HDF5 API's to be
+ external to C++.
+ * Fixed a bug in H5FD_mpio_flush() that might result in negative file seek
+ if both MPIO and Split-file drivers are used together.
+
+
+
+Documentation
+=============
+
+ * The H5T_conv_t and H5T_cdata_t structures are now properly defined
+ in the H5Tregister entry in the "H5T" section of the "HDF5 Reference
+ Manual" and described in detail in section 12, "Data Conversions," in
+ the "Datatypes" chapter of the "HDF5 User's Guide."
+ * The new tools h52gif and gif2h5 have been added to the "Tools" section
+ of the Reference Manual.
+ * A "Freespace Management" section has been added to the "Performance"
+ chapter of the User's Guide.
+ * Several user-reported bugs have been fixed since Release 1.4.1.
+ * The "HDF5 Image and Palette Specification" (in the "HDF5 Application
+ Developer's Guide") has been heavily revised. Based on extensive user
+ feedback and input from visualization software developers, Version 1.2
+ of the image specification is substantially different from prior
+ versions.
+
+
+Platforms Tested
+================
+
+ AIX 4.3.3.0 (IBM SP powerpc) xlc 3.6.6.0
+ mpcc_r 3.6.6.0
+ xlf 07.01.0000.0002
+ mpxlf 07.01.0000.0002
+ AIX 4.3 (IBM SP RS6000) C for AIX Compiler, Version 5.0.2.0
+ xlf 7.1.0.2
+ poe 2.4.0.14 (includes mpi)
+ Cray T3E sn6711 2.0.5.49a Cray Standard C Version 6.5.0.1
+ Cray SV1 10.0.0.2 Cray Standard C Version 6.5.0.1
+ Cray Fortran Version 3.5.0.1
+ FreeBSD 4.3 gcc 2.95.3
+ g++ 2.95.3
+ HP-UX B.10.20 HP C HP92453-01 A.10.32.30
+ HP F90 v2.3
+ HP-UX B.11.00 HP C HP92453-01 A.11.01.20
+ HP F90 v2.4
+ HP-UX B.11.00 SysV HP C HP92453-01 A.11.01.20
+ HP F90 v2.4
+ IRIX 6.5 MIPSpro cc 7.30
+ IRIX64 6.5 (64 & n32) MIPSpro cc 7.3.1.2m
+ Linux 2.4.4 gcc 2.95.3
+ g++ 2.95.3
+ Linux 2.2.18smp gcc 2.95.2
+ gcc 2.95.2 with mpich 1.2.1
+ g++ 2.95.2
+ pgf90 3.2-4
+ OSF1 V4.0 DEC-V5.2-040 on Digital UNIX V4.0 (Rev 564)
+ Digital Fortran 90 V4.1-270
+ SunOS 5.6 WorkShop Compilers 5.0 98/12/15 C 5.0
+ (Solaris 2.6) WorkShop Compilers 5.0 98/10/25 FORTRAN 90
+ 2.0 Patch 107356-04
+ SunOS 5.7 WorkShop Compilers 5.0 98/12/15 C 5.0
+ (Solaris 2.7) Workshop Compilers 5.0 98/12/15 C++ 5.0
+ Workshop Compilers 5.0 98/10/25 FORTRAN 90
+ 2.0 Patch 107356-04
+ SunOS 5.8/32 Sun WorkShop 6 update 1 C 5.2 2000/09/11
+ (Solaris 2.8) Sun WorkShop 6 update 1 Fortran 95 6.1
+ 2000/09/11
+ Sun WorkShop 6 update 1 C++ 5.2 2000/09/11
+ SunOS 5.8/64 Sun WorkShop 6 update 1 C 5.2 2000/09/11
+ (Solaris 2.8) Sun WorkShop 6 update 1 Fortran 95 6.1
+ 2000/09/11
+ Sun WorkShop 6 update 1 C++ 5.2 2000/09/11
+ TFLOPS r1.0.4 v4.0.7 i386 pgcc Rel 3.1-4i with mpich-1.2.1 with
+ local modifications
+ Windows 2000 (NT5.0) MSVC++ 6.0
+ Windows NT4.0 MSVC++ 6.0
+ DEC Visual Fortran 6.0
+ Windows NT4.0 Code Warrior 6.0
+ Windows 98 MSVC++ 6.0
+ DEC Visual Fortran 6.0
+
+
+Supported Configuration Features Summary
+========================================
+
+ In the tables below
+ y = tested and supported
+ n = not supported or not tested in this release
+ x = not working in this release
+ ( ) = footnote appears below second table
+
+
+ Platform C C F90 F90 C++ Shared zlib Tools
+ parallel parallel libraries
+ (5)
+ Solaris2.6 y n y n y y y y
+ Solaris2.7 y y (1) y n y y y y
+ Solaris2.8 64 y n n n y y y y
+ Solaris2.8 32 y n y n y y y y
+ IRIX6.5 y y (1) n n n y y y
+ IRIX64_6.5 64 y y (2) y y n y y y
+ IRIX64_6.5 32 y y (2) n n n y y y
+ HPUX10.20 y n y n n y y y
+ HPUX11.00 y n y n n y y y
+ HPUX11 SysV y n y n n y y y
+ DECOSF y n y n n y y y
+ T3E y y y y n n y y
+ SV1 y n y n n n y y
+ TFLOPS y y (1) n n n n y y (4)
+ AIX-4.3 SP2 y y y y n n y n
+ AIX-4.3 SP3 y y y y n n y n
+ Win2000 y n n n n y y y
+ Win98 y n y n n y y y
+ WinNT y n y n n y y y
+ WinNT CW y n n n n n y y
+ FreeBSD y n n n y y y y
+ Linux 2.2 y y (1) y n y y y y
+ Linux 2.4 y y (1) n n y y y y
+
+
+ Platform 1.2 static- Thread- SRB GASS STREAM-
+ compatibility exec safe VFD
+ Solaris2.6 y x n n n y
+ Solaris2.7 y x y n n y
+ Solaris2.8 64 y y n n n y
+ Solaris2.8 32 y x n n n y
+ IRIX6.5 y x y n n y
+ IRIX64_6.5 64 y x n n n y
+ IRIX64_6.5 32 y x n n n y
+ HPUX10.20 y y n n n y
+ HPUX11.00 y x n n n y
+ HPUX11 SysV y x n n n y
+ DECOSF y y n n n y
+ T3E y y n n n y
+ SV1 y y n n n y
+ TFLOPS y y n n n n
+ AIX-4.3 SP2 y y (3) n n n y
+ AIX-4.3 SP3 y y n n n y
+ Win2000 y y n n n n
+ Win98 n y n n n n
+ WinNT y y n n n n
+ WinNT CW n n n n n n
+ FreeBSD y y n n n y
+ Linux 2.2 y y y n n y
+ Linux 2.4 y y y n n y
+
+
+ Footnotes: (1) Using mpich.
+ (2) Using mpt and mpich.
+ (3) When configured with static-exec enabled, tests fail
+ in serial mode.
+ (4) No HDF4-related tools.
+ (5) Shared libraries are provided only for the C library.
+
+
+Known Problems
+==============
+
+ * When a dataset with the variable-legth datatype is overwritten,
+ the library can develop memory leaks that cause the file to become
+ unnecessarily large. This is planned to be fixed in the next release.
+
+ * On the SV1, the h5ls test fails due to a difference between the
+ SV1 printf precision and the printf precision on other platforms.
+
+ * The h5dump tests may fail to match the expected output in some
+ platforms (e.g. SP2 parallel, Windows) where the error messages
+ directed to "stderr" do not appear in the "right order" with output
+ from stdout. This is not an error.
+
+ * The --enable-static-exec configure flag fails to compile for HP-UX
+ 11.00 platforms.
+
+ * The executables are always dynamic on IRIX64 6.5(64 and n32) and
+ IRIX 6.5 even if they are configured with --enable-static-exec.
+
+ * IRIX 6.5 fails to compile if configured with --enable-static-exec.
+
+ * For 24-bit image conversion from H4->H5, the current conversion is
+ not consistent with HDF5 image specification.
+
+ * In some cases, and SDS with an UNLIMITED dimension that has not
+ been written (current size = 0) is not converted correctly.
+
+ * After "make install" or "make install-doc" one may need to reload
+ the source from the tar file before doing another build.
+
+ * The HDF5_MPI_OPT_TYPES optimization code in the parallel HDF5 will cause
+ a hang in some cases when chunked storage is used. This is now set to
+ be off by default. One may turn it on by setting environment variable
+ HDF5_MPI_OPT_TYPES to a non-zero value such as 1.
+
+%%%%1.4.1%%%% Release Information for hdf5-1.4.1 (April/01)
+
+9. Release Information for hdf5-1.4.1 (April/01)
+=====================================================================
+
+
+
+ HDF5 Release 1.4.1
+
+
+INTRODUCTION
+
+This document describes the differences between HDF5-1.4.0 and
+HDF5-1.4.1, and contains information on the platforms tested and
+known problems in HDF5-1.4.1.
+
+The HDF5 documentation can be found on the NCSA ftp server
+(ftp.ncsa.uiuc.edu) in the directory:
+
+ /HDF/HDF5/docs/
+
+For more information look at the HDF5 home page at:
+
+ http://hdf.ncsa.uiuc.edu/HDF5/
+
+If you have any questions or comments, please send them to:
+
+ hdfhelp@ncsa.uiuc.edu
+
+
+CONTENTS
+
+- New Features
+- Bug Fixes since HDF5-1.4.0
+- Documentation
+- Platforms Tested
+- Supported Configuration Features
+- Known Problems
+
+
+New Features
+============
+
+ * XML output option for h5dump utility.
+
+ A new option --xml to output data in XML format has been added. The
+ XML output contains a complete description of the file, marked up in
+ XML.
+
+ The XML conforms to the HDF5 Document Type Definition (DTD), which
+ is available at:
+
+ http://hdf.ncsa.uiuc.edu/DTDs/HDF5-File.dtd
+
+ The XML output is suitable for use with other tools, including the
+ Java Tools:
+
+ http://hdf.ncsa.uiuc.edu/java-hdf5-html
+
+
+Bug Fixes since HDF5-1.4.0 Release
+==================================
+
+ * h4toh5 utility: conversion of images is fixed
+
+ Earlier releases of the h4toh5 utility produced images that did not
+ correctly conform to the HDF5 Image and Palette Specification.
+
+ http://hdf.ncsa.uiuc.edu/HDF5/doc/ImageSpec.html
+
+ Several required HDF5 attributes are omitted, and the dataspace
+ is reversed (i.e., the ht. and width of the image dataset is
+ incorrectly described.) For more information, please see:
+
+ http://hdf.ncsa.uiuc.edu/HDF5/H5Image/ImageDetails.htm
+
+ * Fixed bug with contiguous hyperslabs not being detected, causing
+ slower I/O than necessary.
+ * Fixed bug where non-aligned hyperslab I/O on chunked datasets was
+ causing errors during I/O
+ * The RCSID string in H5public.h was causing the C++ compiling problem
+ because when it was included multiple times, C++ did not like
+ multiple definitions of the same static variable. All occurance of
+ RCSID definition are removed since we have not used it consistently
+ before.
+
+
+Documentation
+=============
+
+ PDF and Postscript versions of the following documents are available
+ for this release:
+ Document Filename
+ -------- --------
+ Introduction to HDF5 H5-R141-Introduction.pdf
+ HDF5 Reference Manual H5-R141-RefManual.pdf
+ C++ APIs to HDF5 documents H5-R141-Cplusplus.pdf
+ Fortran90 APIs to HDF5 documents H5-R141-Fortran90.pdf
+
+ PDF and Postscript files containing H5-R141-DocSet.pdf
+ all of the above H5-R141-DocSet.ps
+
+ These files are not included in this distribution, but are available
+ via the Web or FTP at the following locations:
+ http://hdf.ncsa.uiuc.edu/HDF5/doc/PSandPDF/
+ ftp://ftp.ncsa.uiuc.edu/HDF/HDF5/docs/
+
+ While these documents are labeled Release 1.4.1, they describe
+ Release 1.4.0 as well.
+
+
+Platforms Tested
+================
+
+Due to the nature of this release only C, C++ libraries and tools were tested.
+
+ AIX 4.3.3.0 (IBM SP powerpc) xlc 3.6.6
+ mpcc_r 3.6.6
+ Cray T3E sn6711 2.0.5.47 Cray Standard C Version 6.5.0.0
+ Cray SV1 10.0.0.8 Cray Standard C Version 6.5.0.0
+ FreeBSD 4.3 gcc 2.95.2
+ HP-UX B.10.20 HP C HP92453-01 A.10.32.30
+ HP-UX B.11.00 HP C HP92453-01 A.11.01.20
+ IRIX 6.5 MIPSpro cc 7.30
+ IRIX64 6.5 (64 & n32) MIPSpro cc 7.3.1m
+ Linux 2.2.18smp gcc-2.95.2
+ g++ 2.95.2
+ OSF1 V4.0 DEC-V5.2-040
+ Digital Fortran 90 V4.1-270
+ SunOS 5.6 WorkShop Compilers 5.0 98/12/15 C 5.0
+ (Solaris 2.6)
+
+ SunOS 5.7 WorkShop Compilers 5.0 98/12/15 C 5.0
+ (Solaris 2.7) Workshop Compilers 5.0 98/12/15 C++ 5.0
+ TFLOPS r1.0.4 v4.0 mpich-1.2.1 with local changes
+ Windows NT4.0, 2000 (NT5.0) MSVC++ 6.0
+ Windows 98 MSVC++ 6.0
+
+
+Supported Configuration Features Summary
+========================================
+
+ * See "Supported Configuration Features Summary" section for the HDF5
+ 1.4.0 release in the HISTORY.txt file.
+
+Known Problems
+==============
+
+ * The h5dump tests may fail to match the expected output in some
+ platforms (e.g. SP2 parallel, Windows) where the error messages
+ directed to "stderr" do not appear in the "right order" with output
+ from stdout. This is not an error.
+
+ * The --enable-static-exec configure flag fails to compile for HP-UX
+ 11.00 platforms.
+
+ * The executable are always dynamic on IRIX64 6.5(64 and n32) and
+ IRIX 6.5 even if they are configured with --enable-static-exec.
+
+ * The shared library failed compilation on IRIX 6.5.
+
+ * After "make install" or "make install-doc" one may need to reload the source
+ from the tar file before doing another build.
+
+ * See "Known problems" section for the HDF5 1.4.0 release in the
+ HISTORY.txt file.
+
+%%%%1.4.0%%%% Release Information for hdf5-1.4.0 (2/22/01)
+
+8. Release Information for hdf5-1.4.0
+===================================================================
+
+ HDF5 Release 1.4.0
+
+
+INTRODUCTION
+
+This document describes the differences between HDF5-1.2.0 and
+HDF5-1.4.0, and contains information on the platforms tested and
+known problems in HDF5-1.4.0. For more details check the HISTORY.txt
+file in the HDF5 source.
+
+The HDF5 documentation can be found on the NCSA ftp server
+(ftp.ncsa.uiuc.edu) in the directory:
+
+ /HDF/HDF5/docs/
+
+For more information look at the HDF5 home page at:
+
+ http://hdf.ncsa.uiuc.edu/HDF5/
+
+If you have any questions or comments, please send them to:
+
+ hdfhelp@ncsa.uiuc.edu
+
+
+CONTENTS
+
+- New Features
+- h4toh5 Utility
+- F90 Support
+- C++ Support
+- Pablo Support
+- Bug Fixes since HDF5-1.2.0
+- Bug Fixes since HDF5-1.4.0-beta2
+- Bug Fixes since HDF5-1.4.0
+- Documentation
+- Platforms Tested
+- Supported Configuration Features
+- Known Problems
+
+
+New Features
+============
+ * The Virtual File Layer, VFL, was added to replace the old file
+ drivers. It also provides an API for user defined file drivers.
+ * New features added to snapshots. Use 'snapshot help' to see a
+ complete list of features.
+ * Improved configure to detect if MPIO routines are available when
+ parallel mode is requested.
+ * Added Thread-Safe support. Phase I implemented. See:
+
+ http://hdf.ncsa.uiuc.edu/HDF5/papers/mthdf/MTHDFpaper.htm
+
+ for more details.
+ * Added data sieve buffering to raw data I/O path. This is enabled
+ for all VFL drivers except the mpio & core drivers. Setting the
+ sieve buffer size is controlled with the new API function,
+ H5Pset_sieve_buf_size(), and retrieved with H5Pget_sieve_buf_size().
+ * Added new Virtual File Driver, Stream VFD, to send/receive entire
+ HDF5 files via socket connections.
+ * As parts of VFL, HDF-GASS and HDF-SRB are also added to this
+ release. To find out details, please read INSTALL_VFL file.
+ * Increased maximum number of dimensions for a dataset (H5S_MAX_RANK)
+ from 31 to 32 to align with HDF4 & netCDF.
+ * Added 'query' function to VFL drivers. Also added 'type' parameter to
+ VFL 'read' & 'write' calls, so they are aware of the type of data
+ being accessed in the file. Updated the VFL document also.
+ * A new h4toh5 utility, to convert HDF4 files to analogous HDF5 files.
+ * Added a new array datatype to the datatypes which can be created.
+ Removed "array fields" from compound datatypes (use an array datatype
+ instead).
+ * Parallel HDF5 works correctly with mpich-1.2.1 on Solaris, SGI, Linux.
+ * You can now install the HDF5 documentation using the
+ ``make install-doc'' command. The documentation is installed in the
+ $(prefix)/doc directory where $(prefix) is the prefix specified by
+ the (optional) ``--prefix'' flag during configuration.
+ * HDF5 can operate correctly in the OpenMP environment in a limited way.
+ Check doc/html/TechNotes/openmp-hdf5.html for details.
+
+
+h4toh5 Utility
+==============
+ The h4toh5 utility is a new utility that converts an HDF4 file to an
+ HDF5 file. For details, see the document, "Mapping HDF4 Objects to
+ HDF5 Objects":
+ http://hdf.ncsa.uiuc.edu/HDF5/papers/H4-H5MappingGuidelines.pdf
+
+ Known Bugs:
+
+ The h4toh5 utility produces images that do not correctly conform
+ to the HDF5 Image and Palette Specification.
+
+ http://hdf.ncsa.uiuc.edu/HDF5/doc/ImageSpec.html
+
+ Several required HDF5 attributes are omitted, and the dataspace
+ is reversed (i.e., the ht. and width of the image dataset is
+ incorrectly described.) For more information, please see:
+
+ http://hdf.ncsa.uiuc.edu/HDF5/H5Image/ImageDetails.html
+
+ This bug has been fixed for the snapshot of hdf5 1.4 release. March 12th,2001
+
+ Known Limitations of the h4toh5 release
+ ---------------------------------------------
+
+ 1. Error handlings
+
+ h4toh5 utility will print out an error message when an error occurs.
+
+ 2. String Datatype
+
+ HDF4 has no 'string' type. String valued data are usually defined as
+ an array of 'char' in HDF4. The h4toh5 utility will generally map
+ these to HDF5 'String' types rather than array of char, with the
+ following additional rules:
+
+ * For the data of an HDF4 SDS, image, and palette, if the data is
+ declared 'DFNT_CHAR8' it will be assumed to be integer and will
+ be an H5T_INTEGER type.
+ * For attributes of any HDF4 object, data of type 'DFNT_CHAR8'
+ will be converted to an HDF5 'H5T_STRING' type.
+ * For an HDF4 Vdata, it is difficult to determine whether data
+ of type 'DFNT_CHAR8' is intended to be bytes or characters. The
+ h4toh5 utility will consider them to be C characters, and will
+ convert them to an HDF5 'H5T_STRING' type.
+
+
+ 3. Compression, Chunking and External Storage
+
+ Chunking is supported, but compression and external storage is not.
+
+ An HDF4 object that uses chunking will be converted to an HDF5 file
+ with analogous chunked storage.
+
+ An HDF4 object that uses compression will be converted to an
+ uncompressed HDF5 object.
+
+ An HDF4 object that uses external storage will be converted to an
+ HDF5 object without external storage.
+
+ 4. Memory Use
+
+ This version of the h4toh5 utility copies data from HDF4 objects
+ in a single read followed by a single write to the HDF5 object. For
+ large objects, this requires a very large amount of memory, which may
+ be extremely slow or fail on some platforms.
+
+ Note that a dataset that has only been partly written will
+ be read completely, including uninitialized data, and all the
+ data will be written to the HDF5 object.
+
+ 5. Platforms
+
+ The h4toh5 utility requires HDF5-1.4.0 and HDF4r1.4
+
+ h4toh5 utility has been tested on all platforms listed below (see
+ section "Platforms Tested") except TFLOPS.
+
+
+F90 Support
+===========
+ This is the first release of the HDF5 Library with fully integrated
+ F90 API support. The Fortran Library is created when the
+ --enable-fortran flag is specified during configuration.
+
+ Not all F90 subroutines are implemented. Please refer to the HDF5
+ Reference Manual for more details.
+
+ F90 APIs are available for the Solaris 2.6 and 2.7, Linux, DEC UNIX,
+ T3E, SV1 and O2K (64 bit option only) platforms. The Parallel version of
+ the HDF5 F90 Library is supported on the O2K and T3E platforms.
+
+ Changes since the last prototype release (July 2000)
+ ----------------------------------------------------
+ * h5open_f and h5close_f must be called instead of h5init_types and
+ h5close_types.
+
+ * The following subroutines are no longer available:
+
+ h5pset_xfer_f
+ h5pget_xfer_f
+ h5pset_mpi_f
+ h5pget_mpi_f
+ h5pset_stdio_f
+ h5pget_stdio_f
+ h5pset_sec2_f
+ h5pget_sec2_f
+ h5pset_core_f
+ h5pget_core_f
+ h5pset_family_f
+ h5pget_family_f
+
+ * The following functions have been added:
+
+ h5pset_fapl_mpio_f
+ h5pget_fapl_mpio_f
+ h5pset_dxpl_mpio_f
+ h5pget_dxpl_mpio_f
+
+ * In the previous HDF5 F90 releases, the implementation of object
+ references and dataset region references was not portable. This
+ release introduces a portable implementation, but it also introduces
+ changes to the read/write APIs that handle references. If object or
+ dataset region references are written or read to/from an HDF5 file,
+ h5dwrite_f and h5dread_f must use the extra parameter, n, for the
+ buffer size:
+
+ h5dwrite(read)_f(dset_id, mem_type_id, buf, n, hdferr, &
+ ^^^
+ mem_space_id, file_space_id, xfer_prp)
+
+ For other datatypes the APIs were not changed.
+
+
+C++ Support
+===========
+ This is the first release of the HDF5 Library with fully integrated
+ C++ API support. The HDF5 C++ library is built when the --enable-cxx
+ flag is specified during configuration.
+
+ Check the HDF5 Reference Manual for available C++ documentation.
+
+ C++ APIs are available for Solaris 2.6 and 2.7, Linux, and FreeBSD.
+
+
+Pablo Support
+=============
+ This version does not allow proper building of the Pablo-instrumented
+ version of the library. A version supporting the pablo build is
+ available on the Pablo Website at
+ www-pablo.cs.uiuc.edu/pub/Pablo.Release.5/HDFLibrary/hdf5_v1.4.tar.gz
+
+
+Bug Fixes since HDF5-1.2.0
+==========================
+
+Library
+-------
+ * The function H5Pset_mpi is renamed as H5Pset_fapl_mpio.
+ * Corrected a floating point number conversion error for the Cray J90
+ platform. The error did not convert the value 0.0 correctly.
+ * Error was fixed which was not allowing dataset region references to
+ have their regions retrieved correctly.
+ * Corrected a bug that caused non-parallel file drivers to fail in
+ the parallel version.
+ * Added internal free-lists to reduce memory required by the library
+ and H5garbage_collect API function
+ * Fixed error in H5Giterate which was not updating the "index"
+ parameter correctly.
+ * Fixed error in hyperslab iteration which was not walking through the
+ correct sequence of array elements if hyperslabs were staggered in a
+ certain pattern
+ * Fixed several other problems in hyperslab iteration code.
+ * Fixed another H5Giterate bug which was causes groups with large
+ numbers of objects in them to misbehave when the callback function
+ returned non-zero values.
+ * Changed return type of H5Aiterate and H5A_operator_t typedef to be
+ herr_t, to align them with the dataset and group iterator functions.
+ * Changed H5Screate_simple and H5Sset_extent_simple to not allow
+ dimensions of size 0 with out the same dimension being unlimited.
+ * QAK - 4/19/00 - Improved metadata hashing & caching algorithms to
+ avoid many hash flushes and also remove some redundant I/O when
+ moving metadata blocks in the file.
+ * The "struct(opt)" type conversion function which gets invoked for
+ certain compound datatype conversions was fixed for nested compound
+ types. This required a small change in the datatype conversion
+ function API.
+ * Re-wrote lots of the hyperslab code to speed it up quite a bit.
+ * Added bounded garbage collection for the free lists when they run
+ out of memory and also added H5set_free_list_limits API call to
+ allow users to put an upper limit on the amount of memory used for
+ free lists.
+ * Checked for non-existent or deleted objects when dereferencing one
+ with object or region references and disallow dereference.
+ * "Time" datatypes (H5T_UNIX_D*) were not being stored and retrieved
+ from object headers correctly, fixed now.
+ * Fixed H5Dread or H5Dwrite calls with H5FD_MPIO_COLLECTIVE requests
+ that may hang because not all processes are transfer the same amount
+ of data. (A.K.A. prematured collective return when zero amount data
+ requested.) Collective calls that may cause hanging is done via the
+ corresponding MPI-IO independent calls.
+ * If configure with --enable-debug=all, couple functions would issue
+ warning messages to "stderr" that the operation is expensive time-wise.
+ This messed up applications (like testings) that did not expect the
+ extra output. It is changed so that the warning will be printed only
+ if the corresponding Debug key is set.
+
+Configuration
+-------------
+ * The hdf5.h include file was fixed to allow the HDF5 Library to be
+ compiled with other libraries/applications that use GNU autoconf.
+ * Configuration for parallel HDF5 was improved. Configure now attempts
+ to link with libmpi.a and/or libmpio.a as the MPI libraries by
+ default. It also uses "mpirun" to launch MPI tests by default. It
+ tests to link MPIO routines during the configuration stage, rather
+ than failing later as before. One can just do "./configure
+ --enable-parallel" if the MPI library is in the system library.
+ * Added support for pthread library and thread-safe option.
+ * The libhdf5.settings file shows the correct machine byte-sex.
+ * Added option "--enable-stream-vfd" to configure w/o the Stream VFD.
+ For Solaris, added -lsocket to the LIBS list of libraries.
+
+Tools
+-----
+ * h5dump now accepts both short and long command-line parameters:
+ -h, --help Print a usage message and exit
+ -B, --bootblock Print the content of the boot block
+ -H, --header Print the header only; no data is displayed
+ -i, --object-ids Print the object ids
+ -V, --version Print version number and exit
+ -a P, --attribute=P Print the specified attribute
+ -d P, --dataset=P Print the specified dataset
+ -g P, --group=P Print the specified group and all members
+ -l P, --soft-link=P Print the value(s) of the specified soft link
+ -o F, --output=F Output raw data into file F
+ -t T, --datatype=T Print the specified named data type
+ -w #, --width=# Set the number of columns
+
+ P - is the full path from the root group to the object.
+ T - is the name of the data type.
+ F - is a filename.
+ # - is an integer greater than 1.
+ * A change from the old way command line parameters were interpreted
+ is that multiple attributes, datasets, groups, soft-links, and
+ object-ids cannot be specified with just one flag but you have to
+ use a flag with each object. I.e., instead of doing this:
+
+ h5dump -a /attr1 /attr2 foo.h5
+
+ do this:
+
+ h5dump -a /attr1 -a /attr2 foo.h5
+
+ The cases are similar for the other object types.
+ * h5dump correctly displays compound datatypes.
+ * Corrected an error in h5toh4 which did not convert the 32bits
+ int from HDF5 to HDF4 correctly for the T3E platform.
+ * h5dump correctly displays the committed copy of predefined types
+ correctly.
+ * Added an option, -V, to show the version information of h5dump.
+ * Fixed a core dumping bug of h5toh4 when executed on platforms like
+ TFLOPS.
+ * The test script for h5toh4 used to not able to detect the hdp
+ dumper command was not valid. It now detects and reports the
+ failure of hdp execution.
+ * Merged the tools with the 1.2.2 branch. Required adding new
+ macros, VERSION12 and VERSION13, used in conditional compilation.
+ Updated the Windows project files for the tools.
+ * h5dump displays opaque and bitfield data correctly.
+ * h5dump and h5ls can browse files created with the Stream VFD
+ (eg. "h5ls <hostname>:<port>").
+ * h5dump has a new feature "-o <filename>" which outputs the raw data
+ of the dataset into ascii text file <filename>.
+ * h5toh4 used to converts hdf5 strings type to hdf4 DFNT_INT8 type.
+ Corrected to produce hdf4 DFNT_CHAR type instead.
+ * h5dump and h5ls displays array data correctly.
+
+
+Bug Fixes since HDF5-1.4.0-beta2
+================================
+ * Fixed a bug in the conversion from a little endian double to a big
+ endian float in some special cases.
+ * Corrected configuration error which was not including compression
+ support correctly.
+ * Cleaned up lots of warnings.
+ * Changed a few h5dump command line switches and added long versions of
+ the switches.
+ * Changed parameters for H5Tconvert, H5Pset_bufer and H5Pget_buffer from
+ size_t to hsize_t
+ * Fixed fairly obscure bug in hyperslab I/O which could (in rare cases)
+ not copy all the data during a transfer.
+ * Removed ragged array code from library.
+ * F90 library and module files are installed properly now on all supported
+ platforms.
+
+
+Bug Fixes since HDF5-1.4.0 Release
+==================================
+
+ * Fixed bug with contiguous hyperslabs not being detected, causing
+ slower I/O than necessary.
+ * Fixed bug where non-aligned hyperslab I/O on chunked datasets was
+ causing errors during I/O
+ * Implemented XML support in h5dump.
+
+
+Documentation
+=============
+ * A new document summarizing the changes in the library leading up to
+ the current release has been added:
+ HDF5 Software Changes from Release to Release
+ This document is in the Application Developer's Guide and is of
+ particular interest to developers who must keep an application
+ synchronized with the library.
+ * The documentation for the Fortran90 and C++ APIs is linked to the
+ opening page of the Reference Manual. Fortran90 functions are
+ individually referenced from the corresponding C functions through-
+ out the Reference Manual.
+ * User's Guide and Reference Manual were updated to reflect changed
+ function syntax and to fix reported bugs.
+ * Functions that are new at this release were added to the Reference
+ Manual.
+ * Functions that have been removed from the library were removed from
+ the User's Guide and the Reference Manual.
+ * PostScript and PDF versions of the Release 1.4 document set are
+ not available at the time of Release 1.4.0.
+
+
+Platforms Tested
+================
+ AIX 4.3.3.0 (IBM SP powerpc) xlc 3.6.6
+ mpcc_r 3.6.6
+ Cray T3E sn6711 2.0.5.45 Cray Standard C Version 6.4.0.0
+ Cray Fortran Version 3.4.0.2
+ Cray SV1 sn9605 10.0.0.7 Cray Standard C Version 6.4.0.0
+ Cray Fortran Version 3.4.0.2
+ FreeBSD 4.2 gcc 2.95.2
+ g++ 2.95.2
+ HP-UX B.10.20 HP C HP92453-01 A.10.32.30
+ HP-UX B.11.00 HP C HP92453-01 A.11.00.13
+ IRIX 6.5 MIPSpro cc 7.30
+ mpich-1.2.1
+ IRIX64 6.5 (64 & n32) MIPSpro cc 7.3.1m
+ mpt.1.4.0.2
+ mpich-1.2.1
+ Linux 2.2.16-3smp gcc-2.95.2
+ g++ 2.95.2
+ pgf90 3.1-3
+ mpich-1.2.1
+ OSF1 V4.0 DEC-V5.2-040
+ Digital Fortran 90 V4.1-270
+ SunOS 5.6 WorkShop Compilers 5.0 98/12/15 C 5.0
+ (Solaris 2.6) WorkShop Compilers 5.0 99/10/25 Fortran 90
+ 2.0 Patch 107356-04
+ Workshop Compilers 5.0 98/12/15 C++ 5.0
+ SunOS 5.7 WorkShop Compilers 5.0 98/12/15 C 5.0
+ (Solaris 2.7) WorkShop Compilers 5.0 99/10/25 Fortran 90
+ 2.0 Patch 107356-04
+ Workshop Compilers 5.0 98/12/15 C++ 5.0
+ mpich-1.2.1
+ SunOS 5.5.1 gcc-2.7.2
+ (Solaris 2.5.1 (x86))
+ TFLOPS r1.0.4 v4.0 mpich-1.2.1 with local changes
+ Windows NT4.0, 2000 (NT5.0) MSVC++ 6.0
+ Windows 98 MSVC++ 6.0
+
+
+Supported Configuration Features Summary
+========================================
+ In the tables below
+ y = tested and supported
+ n = not supported or not working in this release
+ ( ) = footnote appears below table
+
+ Platform C C F90 F90 C++ Shared zlib Tools
+ parallel parallel libraries
+ Solaris2.6 y n y n y y y y
+ Solaris2.7 y y (1) y n y y y y
+ Solarisx86 y n n n n y y y
+ IRIX6.5 y y (1) n n n n y y
+ IRIX64_6.5 64 y y (2) y y n y y y
+ IRIX64_6.5 32 y y (2) n n n y y y
+ HPUX10.20 y n n n n y y y
+ DECOSF y n y n n y y y
+ T3E y y y y n n y y
+ SV1 y n y n n n y y
+ TFLOPS y y (1) n n n n y y (4)
+ AIX-4.3 y y n n n n y n
+ Win2000 y n n n n y y y
+ Win98 y n n n n y y y
+ WinNT y n n n n y y y
+ FreeBSD y n n n y y y y
+ Linux y y (1) y n y y y y
+
+
+ Platform 1.2 static- Thread- SRB GASS STREAM-
+ compatibility exec safe VFD
+ Solaris2.6 y n n n n y
+ Solaris2.7 y n y n n y
+ Solarisx86 y n n n n y
+ IRIX6.5 y n y n n y
+ IRIX64_6.5 64 y n n n n y
+ IRIX64_6.5 32 y n n n n y
+ HPUX10.20 y y n n n y
+ DECOSF y y n n n y
+ T3E y y n n n y
+ SV1 y y n n n y
+ TFLOPS y y n n n n
+ AIX-4.3 y y (3) n n n y
+ Win2000 y y n n n n
+ Win98 y y n n n n
+ WinNT y y n n n n
+ FreeBSD y y n n n y
+ Linux y n y n n y
+
+ Footnotes: (1) Using mpich.
+ (2) Using mpt and mpich.
+ (3) When configured with static-exec enabled, tests fail
+ in serial mode.
+ (4) No HDF4-related tools.
+
+
+Known Problems
+==============
+ * The stream-vfd test uses ip port 10007 for testing. If another
+ application is already using that port address, the test will hang
+ indefinitely and has to be terminated by the kill command. To try the
+ test again, change the port address in test/stream_test.c to one not
+ being used in the host.
+
+ * The --enable-static-exec configure flag fails to compile for Solaris
+ platforms. This is due to the fact that not all of the system
+ libraries on Solaris are available in a static format.
+
+ The --enable-static-exec configure flag also fails to correctly compile
+ on Linux platforms using the gcc-2.95.2 compiler.
+
+ The --enable-static-exec configure flag also fails to correctly compile
+ on IBM SP2 platform for the serial mode. The parallel mode works fine
+ with this option.
+
+ The compilation fails if configured with --enable-static-exec on IRIX 6.5.
+
+ The executable files in hdf5/bin are dynamic-linked for IRIX64 6.5(64 and
+ n32 modes) and IRIX 6.5, even though they are compiled with static library.
+
+ It is suggested that you don't use this option on these platforms
+ during configuration.
+
+ * testhdf5 got bus error with configuration options --prefix and --with-hdf4
+ on IRIX 6.5.
+
+ * With the gcc 2.95.2 compiler, HDF 5 uses the `-ansi' flag during
+ compilation. The ANSI version of the compiler complains about not being
+ able to handle the `long long' datatype with the warning:
+
+ warning: ANSI C does not support `long long'
+
+ This warning is innocuous and can be safely ignored.
+
+ * SunOS 5.6 with C WorkShop Compilers 4.2: Hyperslab selections will
+ fail if library is compiled using optimization of any level.
+
+ * When building hdf5 tools and applications on windows platform, a linking
+ warning: defaultlib "LIBC" conflicts with use of other libs will appear
+ on debug version when running VC++6.0. This warning doesn't affect building
+ and testing hdf5 applications. We will continue investigating this.
+
+ * h5toh4 converter fails two cases(tstr.h5 and tmany.h5) for release dll
+ version on windows 2000 and NT. The reason is possibly due to Windows NT
+ DLL convention on freeing memory. It seems that memory cannot be freed
+ across library or DLL. It is still under investigation.
+
+ * HDF-GASS testings and testhdf5 in the test directory will get bus error if
+ the configured with --with-gass.
+
+ * HDF-SRB testing got segmentation error on Solaris 2.7.
+
+ * The Stream VFD was not tested yet under Windows.
+ It is not supported in the TFLOPS machine.
+
+ * Shared library option is broken for IBM SP and some Origin 2000 platforms.
+ One needs to run ./configure with '--disable-shared --enable-static'.
+
+ * The ./dsets tests failed in the TFLOPS machine if the test program,
+ dsets.c, is compiled with the -O option. The hdf5 library still works
+ correctly with the -O option. The test program works fine if it is
+ compiled with -O1 or -O0. Only -O (same as -O2) causes the test
+ program to fail.
+
+ * Certain platforms give false negatives when testing h5ls:
+ - Solaris x86 2.5.1, Cray T3E and Cray J90 give errors during testing
+ when displaying object references in certain files. These are benign
+ differences due to the difference in sizes of the objects created on
+ those platforms. h5ls appears to be dumping object references
+ correctly.
+ - Cray J90 give errors during testing when displaying
+ some floating-point values. These are benign differences due to the
+ different precision in the values displayed and h5ls appears to be
+ dumping floating-point numbers correctly.
+
+ * Before building HDF5 F90 Library from source on Crays (T3E and SV1)
+ replace H5Aff.f90, H5Dff.f90 and H5Pff.f90 files in the fortran/src
+ subdirectory in the top level directory with the Cray-specific files from
+ the ftp://ftp.ncsa.uiuc.edu/HDF/HDF5/hdf5-1.4.0/src/crayf90/ directory.
+
+ * The h4toh5 utility produces images that do not correctly conform
+ to the HDF5 Image and Palette Specification.
+
+ http://hdf.ncsa.uiuc.edu/HDF5/doc/ImageSpec.html
+
+ Several required HDF5 attributes are omitted, and the dataspace
+ is reversed (i.e., the ht. and width of the image dataset is
+ incorrectly described.) For more information, please see:
+
+ http://hdf.ncsa.uiuc.edu/HDF5/H5Image/ImageDetails.htm
+
+%%%%1.2.2%%%% Release Information for hdf5-1.2.2 (6/23/00)
+
+7. Release Information for hdf5-1.2.2
+=================================================================
+INTRODUCTION
+
This document describes the differences between HDF5-1.2.1 and
HDF5-1.2.2, and contains information on the platforms where HDF5-1.2.2
was tested and known problems in HDF5-1.2.2.
@@ -157,7 +2346,9 @@ Platforms Tested
%%%%1.2.1%%%% Release Information for hdf5-1.2.1
-II. Release Information for hdf5-1.2.1
+6. Release Information for hdf5-1.2.1
+================================================================
+
Bug fixes since HDF5-1.2.0
==========================
@@ -247,7 +2438,8 @@ o SunOS 5.6 with C WorkShop Compilers 4.2: Hyperslab selections will
%%%%1.2.0%%%% Release Information for hdf5-1.2.0
-III. Release Information for hdf5-1.2.0
+5. Release Information for hdf5-1.2.0
+===================================================================
A. Platforms Supported
-------------------
@@ -500,7 +2692,8 @@ C. Changes Since Version 1.0.1
%%%%1.0.1%%%% Release Information for hdf5-1.0.1
-IV. Changes from Release 1.0.0 to Release 1.0.1
+4. Changes from Release 1.0.0 to Release 1.0.1
+=====================================================================
* [Improvement]: configure sets up the Makefile in the parallel tests
suit (testpar/) correctly.
@@ -568,7 +2761,8 @@ IV. Changes from Release 1.0.0 to Release 1.0.1
%%%%1.0.0%%%% Release Information for hdf5-1.0.0
-V. Changes from the Beta 1.0.0 Release to Release 1.0.0
+3. Changes from the Beta 1.0.0 Release to Release 1.0.0
+====================================================================
* Added fill values for datasets. For contiguous datasets fill value
performance may be quite poor since the fill value is written to the
@@ -591,7 +2785,8 @@ V. Changes from the Beta 1.0.0 Release to Release 1.0.0
%%%%1.0.0 Beta%%%% Release Information for hdf5-1.0.0 Beta
-VI. Changes from the Second Alpha 1.0.0 Release to the Beta 1.0.0 Release
+2. Changes from the Second Alpha 1.0.0 Release to the Beta 1.0.0 Release
+=========================================================================
* Strided hyperslab selections in dataspaces now working.
@@ -621,8 +2816,9 @@ VI. Changes from the Second Alpha 1.0.0 Release to the Beta 1.0.0 Release
%%%%1.0.0 Alpha 2%%%% Release Information for hdf5-1.0.0 Alpha 2
-VII. Changes from the First Alpha 1.0.0 Release to
+1. Changes from the First Alpha 1.0.0 Release to
the Second Alpha 1.0.0 Release
+=====================================================================
* Two of the packages have been renamed. The data space API has been
renamed from `H5P' to `H5S' and the property list (template) API has