HDF5 version 1.4.2 currently under development ================================================================================ 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. 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.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/h5dwrite and h5aread/h5awrite subroutines. This parameter is 1D array of size 7 and contains the sizes of the data buffer dimensions. * F90 static library is available on Windows platforms. See INSTALL_Windows.txt for details. * F90 APIs are available on HPUX 11.00 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. 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. Documentation ============= 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.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.4.4 gcc-2.95.3 g++ 2.95.3 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 ======================================== 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 n 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 ============== * 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. * 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.