summaryrefslogtreecommitdiffstats
path: root/doc/html
diff options
context:
space:
mode:
authorElena Pourmal <epourmal@hdfgroup.org>2004-09-22 16:39:14 (GMT)
committerElena Pourmal <epourmal@hdfgroup.org>2004-09-22 16:39:14 (GMT)
commit68d88b2cf725fe32392d8cfb59c0bba7ea79e859 (patch)
treeebe6cb2b5fe18457346b22fd4d45af520f7b3e8e /doc/html
parent047be918c872e500f868ecce3cad699d5eb3c7ee (diff)
downloadhdf5-68d88b2cf725fe32392d8cfb59c0bba7ea79e859.zip
hdf5-68d88b2cf725fe32392d8cfb59c0bba7ea79e859.tar.gz
hdf5-68d88b2cf725fe32392d8cfb59c0bba7ea79e859.tar.bz2
[svn-r9304] Purpose: Release maintenancehdf5-1_6_3
Description: I changed the version number to 1.6.3 Solution: Ran bin/h5vers -s 1.6.3 on eirene Platforms tested: Misc. update:
Diffstat (limited to 'doc/html')
-rw-r--r--doc/html/ADGuide/RELEASE.txt412
1 files changed, 303 insertions, 109 deletions
diff --git a/doc/html/ADGuide/RELEASE.txt b/doc/html/ADGuide/RELEASE.txt
index 63fafb8..aff42a5 100644
--- a/doc/html/ADGuide/RELEASE.txt
+++ b/doc/html/ADGuide/RELEASE.txt
@@ -1,12 +1,12 @@
-HDF5 version 1.6.3-snap5 released on Sun Aug 29 20:59:47 CDT 2004
+HDF5 version 1.6.3 released on Wed Sep 22 11:30:11 CDT 2004
================================================================================
INTRODUCTION
This document describes the differences between HDF5-1.6.2 and
-HDF5-1.6.2-*, and contains information on the platforms tested and
-known problems in HDF5-1.6.2-*. For more details check the HISTORY.txt
+HDF5-1.6.3, and contains information on the platforms tested and
+known problems in HDF5-1.6.3. For more details check the HISTORY.txt
file in the HDF5 source.
The HDF5 documentation can be found on the NCSA ftp server
@@ -44,6 +44,31 @@ New Features
define 'H5_USING_PURIFY' in your CFLAGS when building the library.
QAK - 2004/07/23
+ - WINDOWS building,testing and installing improvements
+
+ - On Windows, FORTRAN,C++ and C projects are merged into one zip file,
+ users can choose an option to build either FORTRAN or C++ or both
+ with basic C library.For detailed information,
+ please read INSTALL_Windows.txt.
+
+ - On Windows, szip compression library with or without encoder can be easily
+ turned off or on when building HDF5. For detailed information,
+ please read INSTALL_Windows.txt, especially section V.
+
+ - On Windows, an optional procedure for building,testing and installing
+ HDF5 from command line is provided. This procedure is supposed to be
+ convenient for experienced users, please read
+ INSTALL_windows_From_Command_Line.txt for details.
+
+ - On Windows, an alternative short instruction document for building,
+ testing and installing HDF5 is provided. This instruction is supposed to
+ be convenient for general users, please read
+ INSTALL_Windows_Short.txt for details.
+
+ - On Windows, h5repack,h5diff,h5ls and h5import tool tests have been added.
+ KY - 2004/9/16
+
+
Library:
--------
- Modified the way how HDF5 calculates 'pixels_per_scanline' parameter for
@@ -74,9 +99,31 @@ New Features
Tools:
------
+ - h5repack was added to the tools suite. h5repack regenerates an HDF5 file
+ from another HDF5 file, optionally applying HDF5 filters (compression)
+ and/or chunking to the copied file. The filters options are read from
+ the command line. See /doc/html/Tools.html for more details.
+ PVN - 2004/9/13
+
+ - h5dump includes new features:
+ 1) Printing of dataset filters, storage layout and fill value information.
+ 2) Print a list of the file contents.
+ 3) Escape non printing characters.
+ 4) Print the content of the boot block.
+ 5) Print array indices with the data (the default).
+ These options are all switch controlled. See /doc/html/Tools.html for more details.
+ PVN - 2004/9/13
+
F90 API:
--------
+ - added new subroutines:
+ h5fget_filesize_f
+ h5iget_file_id_f
+ h5premove_filter_f
+ h5zget_filter_info_f
+ EIP 2004/9/21
+
- added new h5fget_name_f and h5fget_filesize_f subroutines
EIP 2004/07/08
@@ -92,14 +139,14 @@ New Features
Support for new platforms, languages and compilers.
=======================================
- - ASdded PGI Fortran support for Linux64 (x86_64) systems
+ - Added PGI Fortran support for Linux64 (x86_64) systems
EIP - 2004/08/19
- Absoft compiler f95 v9.0 is supported on Linux 2.4 32bit
EIP - 2004/07/29
- HDF5 Fortran APIs are supported on Mac OSX with IBM XL Fortran
compiler version 8.1. This is a default compiler.
- HDF5 Fortran APIs are supported on MAC OSX with Absoft F95 compiler
- version 8.2; set F9X environment varibale to f95, for example
+ version 8.2; set F9X environment variable to f95, for example
setenv F9X f95
Use --disable-shared --enable-static configure flags when Absoft
compiler is used.
@@ -110,12 +157,21 @@ Bug Fixes since HDF5-1.6.2 release
Library
-------
+ - Fixed parallel bug in which some processes attempted collective
+ I/O while others did independent I/O. Bug appeared when some
+ processes used point selections, and others didn't. JRM - 2004/9/15
+ - Corrected error where dataset region references were written in an
+ incorrect way on Cray machines. PVN & QAK - 2004/09/13
+ - The H5Tget_native_type now determines the native type for integers
+ based on the precision. This is to avoid cases of wrongly converting
+ an int to a short in machines that have a short of 8 bytes but with
+ 32bit precision (e.g Cray SV1). PVN - 2004/09/07
- Changed H5Dread() to not overwrite data in an application's buffer
with garbage when accessing a chunked dataset with an undefined fill
value and an unwritten chunk is uncountered. QAK - 2004/08/25
- Fixed error which could cause a core dump when a type conversion
routine was registered after a compound datatype had been
- converted and then an equivalment compound datatype was converted
+ converted and then an equivalent compound datatype was converted
again. QAK - 2004/08/07
- Fixed memory overwrite when encoding "multi" file driver information
for file's superblock. QAK - 2004/08/05
@@ -163,7 +219,6 @@ Bug Fixes since HDF5-1.6.2 release
- Fixed dtypes "sw long double -> double" failure in QSC class
machines. AKC - 2004/4/16
-
Configuration
-------------
- Fixed the long compile time of H5detect.c when v7.x Intel Compiler
@@ -174,9 +229,21 @@ Bug Fixes since HDF5-1.6.2 release
Tools
-----
-
+ - On SGI h5dump displayed only part of the data due to the bug
+ in the system printf; fixed.
+ EIP - 2004/09/21
Documentation
-------------
+ - Several descriptive errors have been fixed throughout the
+ documentation, particularly in the reference manual (RM).
+ A selection particularly worthy of note would be these:
+ - The H5Pset_szip description in the RM has been expanded and
+ corrected to facilitate use of SZIP compression.
+ - A note has been added to the H5Dcreate description that an
+ unexplained failure is likely to be due to a property list error
+ that is detected only at the time of dataset creation.
+ -
+ FMB - 2004/09/21
F90 API
-------
@@ -198,27 +265,74 @@ Bug Fixes since HDF5-1.6.2 release
Documentation
=============
-
+ HDF5 Library documentation
+ --------------------------
+ - HDF5 C++ API Reference Manual
+ This document has been added to the HDF5 document set.
+ The predecessor document, "HDF5 C++ Interfaces," has been removed.
+ - HDF5 C++ API Design Specification
+ A first draft of this document has been added to the HDF5 document
+ set. The draft has been posted on the HDF5 website and a link
+ has been added to the HDF5 documents index (index.html at the top
+ level of the document set).
+ - Parallel HDF5
+ In prior releases, the HDF5 document set included two parallel
+ HDF5 documents. Those documents have been deleted and the
+ HDF5 documents index (index.html) now links to a "Parallel HDF5"
+ page on the HDF5 website (http://hdf.ncsa.uiuc.edu/HDF5/PHDF5/).
+ - HDF5 High Level APIs
+ Links to the HDF5 High Level APIs and to the HDF5 High Level
+ Reference Manual have been added to the HDF5 documents index
+ (index.html).
+ - HDF5 Reference Manual
+ Tools: h5repack -- A description of the new h5repack tool has been
+ added to the Tools page.
+ Tools: h5dump -- Several new options have been added to h5dump.
+ New functions -- All new functions have been added to the RM.
+ API changes -- Relevant function descriptions have been updated in
+ instances where programming interfaces have changed.
+ FMB - 2004/09/21
+
+ Windows installation documentation
+ ----------------------------------
+ - INSTALL_Windows.txt has been enhanced to include instructions building
+ HDF5 with FORTRAN and C++.
+ - Two optional installation documents have been added. They are
+ INSTALL_Windows_Short.txt and INSTALL_Windows_From_Command_Line.txt.
+ INSTALL_Windows_Short.txt is supposed to help general users who
+ only want to build,test and install HDF5 in a quick way.
+ INSTALL_Windows_From_Command_Line.txt is supposed to help users who
+ would like to compile,test and install HDF5 in command line environment.
+ - INSTALL_Windows_withcpp.txt and INSTALL_Windows_withF90.txt became
+ obsolete. Files are deleted from the release_docs directory.
+ KY 2004/09/16, EIP 2004/9/21
+
Platforms Tested
================
- AIX 5.1 (32 and 64-bit) xlc 6.0.0.2
- xlf 8.1.0.3
- xlC 6.0.0.4
+ AIX 5.1 (32 and 64-bit) xlc 6.0.0.6
+ xlf 8.1.1.3
+ xlC 6.0.0.6
+ mpcc_r 6.0.0.6
+ mpxlf_r 8.1.1.3
xlc 5.0.2.5
xlf 7.1.1.2
xlC 5.0.2.5
mpcc_r 5.0.2.5
mpxlf_r 7.1.1.2
- poe 3.2.0.10
- Cray T3E sn6606 2.0.6.08 Cray Standard C Version 6.6.0.2
- Cray Fortran Version 3.6.0.2
- Cray SV1 sn9617 10.0.1.2 Cray Standard C Version 6.6.0.2
- Cray Fortran Version 3.6.0.2
- Cray T90IEEE 10.0.0md Cray Standard C Version 6.4.0.3
+ AIX 5.2 xlc 6.0.0.8
+ xlC 6.0.0.8
+ xlf 8.1.1.6
+ mpcc_r 6.0.0.8
+ mpxlf_r 8.1.1.6
+ Cray T90 sn7001 10.0.0md Cray Standard C Version 6.4.0.3
Cray Fortran Version 3.4.0.0
+ Cray T3E sn6606 2.0.6.08 Cray Standard C Version 6.6.0.3
+ Cray Fortran Version 3.6.0.3
+ Cray SV1 sn9617 10.0.1.2 Cray Standard C Version 6.6.0.3.6
+ Cray Fortran Version 3.6.0.3.1
FreeBSD 4.9 gcc 2.95.4
g++ 2.95.4
HP-UX B.11.00 HP C HP92453-01 A.11.01.20
@@ -228,6 +342,7 @@ Platforms Tested
IRIX64 6.5 (64 & n32) MIPSpro cc 7.3.1.3m
F90 MIPSpro 7.3.1.3m (64 only)
C++ MIPSpro cc 7.3.1.3m
+ mpt 1.6
Linux 2.4.18 gcc 2.96, 3.3.2
g++ 3.3.2
Intel(R) C++ Version 7.1
@@ -240,18 +355,22 @@ Platforms Tested
MPIch 1.2.4
Linux 2.4.21-2.9.5ws #3 gcc 3.2.3 (Red Hat Linux 3.2.3-16)
SMP x86_64 g++ 3.2.3
+ Linux 2.4.21-4.ELsmp Intel(R) C++ 32-bit Version 8.0
+ Intel(R) Fortran 32-bit Version 8.0
+ gcc 3.4.0
+ MPICH 1..5.2 Inmel 8.0
Linux 2.4.19-SMP x86_64 gcc (GCC) 3.2.2 (SuSE Linux)
g++ 3.2.2
+ Linux 2.6.4-52smp x86_64 gcc 3.3.3 (SuSE Linux 9.1 AMD64))
+ PGI 5.2-1 C and F90
Linux 2.4.21-sgi Altix
- SMP ia64 Intel(R) C++ Version 7.1
- Intel(R) Fortran Itanium(R) Version 7.1
+ SMP ia64 Intel(R) C++ Version 8.0
+ Intel(R) Fortran Itanium(R) Version 8.0
SGI MPI
- OSF1 V5.1 Compaq C V6.4-014
- Compaq Fortran V5.5-2602
- Compaq Fortran V5.5-1877
- Compaq C++ V6.5-033
- Compaq C++ V6.5-030
+ OSF1 V5.1 Compaq C V6.5-303
+ HP Fortran V5.5A-3548
+ Compaq C++ V6.5-040
MPI_64bit_R13
SunOS 5.7(32 and 64 bit) WorkShop Compilers 5.0 98/12/15 C 5.0
(Solaris 2.7) WorkShop Compilers 5.0 98/12/15 C++ 5.0
@@ -260,27 +379,35 @@ Platforms Tested
SunOS 5.8(32 and 64 bit) Sun WorkShop 6 update 2 C 5.3
(Solaris 2.8) Sun WorkShop 6 update 2 Fortran 90
Sun WorkShop 6 update 2 C++ 5.3
- TFLOPS r1.0.4 v4.4.2 i386 pgcc Rel 3.1-4i with mpich-1.2.4 with
+ TFLOPS r1.0.4 v4.4.3 i386 pgcc Rel 3.1-4i with mpich-1.2.4 with
local modifications
IA-32 Linux 2.4.18 gcc 2.96
Intel(R) C++ Version 7.0
Intel(R) Fortran Compiler Version 7.0
+
+ Xeon Linux 2.4.20-31.9smp_perfctr_lustre
+ Intel(R) C++ Version 8.0
+ Intel(R) Fortran Compiler Version 8.0
IA-64 Linux 2.4.16 ia64 gcc version 3.0.4
Intel(R) C++ Version 7.1
Intel(R) Fortran Compiler Version 7.1
IA-64 Linux 2.4.21.SuSE_128.bef1 ia64
- Intel(R) C++ Version 7.1
- Intel(R) Fortran Compiler Version 7.1
+ Intel(R) C++ Version 8.0
+ Intel(R) Fortran Compiler Version 8.0
mpich-gm-1.2.5..intel
Windows 2000 (NT5.0) MSVC++ 6.0
+ MSVC++ .NET
DEC Visual Fortran 6.0
Intel C and F90 compilers version 7.1
Code Warrior 8.0
Windows XP MSVC++.NET
- MAC OS X Darwin 7.2
+ MSVC++ 6.0
+ DEC Visual Fortran 6.0
+
+ MAC OS X Darwin 7.5
gcc and g++ Apple Computer, Inc. GCC
version 1175, based on gcc version 3.3.2
IBM XL Fortran version 8.1
@@ -297,94 +424,104 @@ Key: y = tested and supported
dna = does not apply
( ) = footnote appears below second table
-Platform C C F90 F90 C++ Shared zlib
- parallel parallel libraries (4)
-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 y (1) y y (1) y y y
-Solaris2.8 32-bit y y y y (1) y 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 y y y y
-OSF1 v5.1 y y y y y y y
-T3E y y (5) y y (5) n n y
-SV1 y y (5) y y (5) n n y
-T90 IEEE y y (5) y y (5) 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 Visual Studio (7) y n n n y y y
-WinXP Intel y n n n y y y
-WinXP CW y n n n n n y
-Win2000 Visual Studio y n y n y y y
-Win2000 Intel y n y n y y y
-Mac OS X 10.3 y n y n y y y
-FreeBSD 4.9 y y (1) n n y y y
-RedHat 7, 8 & 9 ia32 y y (1) y(PGI) n y y y
- W gcc (3)
-RedHat 7.3 ia32 W Intel (3) y n y n y n y
-RedHat 7.3 ia32 W PGI (3) y n y n y n y
-RedHat 7 ia32 C Intel (3) y n y n y n y
-RedHat 7.1 ia64 C Intel (3) y n y n y n y
-RedHat 8 & SuSe x86_64 y n n n y n y
- gcc (3)
-Linux 2.4 SGI Altix ia64 y n y n y y y
- Intel (3)
-
-
-Platform static- Thread- SZIP GASS STREAM- High- H4/H5
- exec safe VFD level tools
- APIs (6)
-Solaris2.7 64-bit x y y n y y n
-Solaris2.7 32-bit x y y n y y y
-Solaris2.8 64-bit x y y n y y n
-Solaris2.8 32-bit x y y n y y y
-IRIX64_6.5 64-bit x y y y y y y
-IRIX64_6.5 32-bit x y y y y y y
-HPUX11.00 x n y n y y y
-OSF1 v5.1 y n y n y y y
-T3E y n n n y y y
-SV1 y n n n y y y
-T90 IEEE y n n n y y n
-TFLOPS y n n n n n n
-AIX-5.1 32-bit y n y n y y y
-AIX-5.1 64-bit y n y n y y y
-WinXP Visual Studio y n y n n y y
-WinXP Intel y n y n n y y
-WinXP CW y n y n n y y
-Win2000 Visual Studio y n y n n y y
-Win2000 Intel y n y n n y y
-Mac OS X 10.3 y n y n y y n
-FreeBSD 4.9 y y y n y y y
-RedHat 7, 8 & 9 ia32 y y y n y y y
- W gcc (3)
-RedHat 7.3 ia32 W Intel (3) y n y n y n n
-RedHat 7.3 ia32 W PGI (3) y n y n y n n
-RedHat 7 ia32 C Intel (3) y n y n y y y
-RedHat 7.1 ia64 C Intel (3) y n y n y y y
-RedHat 8 & SuSe x86_64 y n y n y y y
- gcc (3)
-Linux 2.4 SGI Altix ia64 y n y n y y y
- Intel (3)
+Platform C F90 F90 C++ zlib SZIP
+ parallel parallel
+Solaris2.7 64-bit y (1) y y (1) y y y
+Solaris2.7 32-bit y (1) y y (1) y y y
+Solaris2.8 64-bit y (1) y y (1) y y y
+Solaris2.8 32-bit y y y (1) y y y
+IRIX64_6.5 64-bit y (2) y y y y y
+IRIX64_6.5 32-bit y (2) n n n y y
+HPUX11.00 y (1) y y y y y
+OSF1 v5.1 y y y y y y
+T90 IEEE n y n n y n
+T3E y (5) y y (5) n y n
+SV1 y (5) y y (5) n y n
+TFLOPS y (1) n n n y n
+AIX-5.1 & 5.2 32-bit y y y y y y
+AIX-5.1 & 5.2 64-bit y y y y y y
+WinXP Visual Studio 6.0 n y (9) n y y y
+WinXP .Net n n n y y y
+WinXP Code Warrior n n n n y y
+Win2000 Visual Studio 6.0 n y (10) n y y y
+Win2000 Visual Studio Intel (6) n y n y y y
+Win2000 .Net n n n y y y
+Mac OS X 10.3 n y (11) n y y y
+FreeBSD 4.9 y (1) n n y y y
+RedHat 7 W (3) y (1) y (12) n y y y
+RedHat 7.3 W Intel (3) n y n y y y
+RedHat 7.3 W PGI (3) n y n y y y
+RedHat 8 & SuSe x86_64 gcc (3) n y (13) n y y y
+Linux 2.4 Xeon C Lustre Intel (3,7) n y n y y y
+Linux 2.4 SuSE ia64 C Intel (3,8) y y y y y y
+Linux 2.4 SGI Altix ia64 Intel (3) y y y y y y
+
+
+Platform Shared static- Thread- STREAM-
+ libraries (4) exec safe VFD
+Solaris2.7 64-bit y x y y
+Solaris2.7 32-bit y x y y
+Solaris2.8 64-bit y x y y
+Solaris2.8 32-bit y x y y
+IRIX64_6.5 64-bit y y y y
+IRIX64_6.5 32-bit y y y y
+HPUX11.00 y x n y
+OSF1 v5.1 y y n y
+T90 IEEE n y n y
+T3E n y n y
+SV1 n y n y
+TFLOPS n y n n
+AIX-5.1 & 5.2 32-bit n y n y
+AIX-5.1 & 5.2 64-bit n y n y
+WinXP Visual Studio 6.0 y y n n
+WinXP .Net y y n n
+WinXP Code Warrior n y n n
+Win2000 Visual Studio 6.0 y y n n
+Win2000 Visual Studio Intel (6) y y n n
+Win2000 .Net y y n n
+Mac OS X 10.3 y y n y
+FreeBSD 4.9 y y y y
+RedHat 7 W (3) y y y y
+RedHat 7.3 W Intel (3) n y n y
+RedHat 7.3 W PGI (3) n y n y
+RedHat 8 & SuSe x86_64 gcc (3) n y n y
+Linux 2.4 Xeon C Lustre Intel (3,7) y y n y
+Linux 2.4 SuSE ia64 C Intel (3,8) y y n n
+Linux 2.4 SGI Altix ia64 Intel (3) y y n y
+
Compiler versions for each platform are listed in the "Platforms Tested"
table found elsewhere in this file (RELEASE.txt). Unless otherwise noted,
compilers used are the system compilers.
-Footnotes: (1) Using mpich 1.2.4.
- (2) Using mpt and mpich 1.2.4.
- (3) Linux 2.4 with GNU, Intel, and PGI compilers, as indicated.
- W or C indicates workstation or cluster, respectively.
+Footnotes: (1) Using mpich 1.2.4
+ (2) Using mpt and mpich 1.2.4
+ (3) Linux 2.4 with GNU, Intel, and PGI compilers, as indicated
+ W or C indicates workstation or cluster, respectively
(4) Shared libraries are provided only for the C library,
- except on Windows where they are provided for C and C++.
- (5) Using mpt.
- (6) Includes the H4toH5 Library and the h4toh5 and h5toh4
- utilities.
+ except on Windows where they are provided for C and C++
+ (5) Using mpt
+ (6) Intel 7.1 compilers in Visual Studio 6.0 environment
+ (7) Linux 2.4.20-31.9. Xeon cluster with smp_perfctr_lustre
+ and Intel compilers
+ (8) Linux 2.4.21, SuSE_128.befl. Ia64 cluster with Intel compilers
+ (9) DEC Visual Fortran 6.0 and Intel 7.1
+ (10) DEC Visual Fortran 6.0
+ (11) IBM XLF and Absoft
+ (12) PGI, Absoft
+ (13) PGI
+ FMB/EIP - 2004/09/21
+
Known Problems
==============
+* h5fc and h5c++ compilation scripts have a bug: object files (*.o) cannot be
+ created when source code is compiled using h5fc or h5c++. We will provide
+ a fix. Please check ftp://ftp.ncsa.uiuc.edu/HDF/HDF5/current/src/patches/
+ for the patches.
+
* Fortran subroutine h5pget_driver_f doesn't return a correct driver information.
* There are two h5dump xml tests(h5dump --xml thlink.h5 and h5dump --xml tmany.h5)
@@ -416,7 +553,6 @@ Known Problems
* The Stream VFD was not tested yet under Windows. It is not supported
in the TFLOPS machine.
-
* 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
@@ -433,7 +569,7 @@ Known Problems
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 site:
- ftp://hdf.ncsa.uiuc.edu/pub/outgoing/hdf5/hdf5-1.6.2/F90_source_for_Crays
+ ftp://ftp.ncsa.uiuc.edu/HDF/HDF5/current/src/patches/
* On some platforms that use Intel and Absoft compilers to build HDF5 fortran library,
compilation may fail for fortranlib_test.f90, fflush1.f90 and fflush2.f90
@@ -466,5 +602,63 @@ Known Problems
Testing random sw long double -> double conversions
If -ieee is used, the converted doubles spread over the range 0.0 to 1**-308.
If -ieee is not used, the converted double values are mostly 0.0 but
- occassionaly as 1**-308. This has been reported to the system staff.
+ occasionally as 1**-308. This has been reported to the system staff.
All other tests have passed.
+
+* On at least one system, (SDSC DataStar), the scheduler (in this case
+ LoadLeveler) sends job status updates to standard error when you run
+ any executable that was compiled with the parallel compilers.
+
+ This causes problems when running "make check" on parallel builds, as
+ many of the tool tests function by saving the output from test runs,
+ and comparing it to an exemplar.
+
+ The best solution is to reconfigure the target system so it no longer
+ inserts the extra text. However, this may not be practical.
+
+ In such cases, one solution is to "setenv HDF5_Make_Ignore yes" prior to
+ the configure and build. This will cause "make check" to continue after
+ detecting errors in the tool tests. However, in the case of SDSC DataStar,
+ it also leaves you with some 150 "failed" tests to examine by hand.
+
+ A second solution is to write a script to run serial tests and filter
+ out the text added by the scheduler. A sample script used on SDSC
+ DataStar is given below, but you will probably have to customize it
+ for your installation.
+
+ Observe that the basic idea is to insert the script as the first item
+ on the command line which executes the test. The script then
+ executes the test and filters out the offending text before passing
+ it on.
+
+ #!/bin/csh
+
+ set STDOUT_FILE=~/bin/serial_filter.stdout
+ set STDERR_FILE=~/bin/serial_filter.stderr
+
+ rm -f $STDOUT_FILE $STDERR_FILE
+
+ ($* > $STDOUT_FILE) >& $STDERR_FILE
+
+ set RETURN_VALUE=$status
+
+ cat $STDOUT_FILE
+
+ tail +3 $STDERR_FILE
+
+ exit $RETURN_VALUE
+
+ You get the HDF make files and test scripts to execute your filter script
+ by setting the environment variable "RUNSERIAL" to the full path of the
+ script prior to running configure for parallel builds. Remember to
+ "unsetenv RUNSERIAL" before running configure for a serial build.
+
+ Note that the RUNSERIAL environment variable exists so that we can
+ can prefix serial runs as necessary on the target system. On DataStar,
+ no prefix is necessary. However on an MPICH system, the prefix might
+ have to be set to something like "/usr/local/mpi/bin/mpirun -np 1" to
+ get the serial tests to run at all.
+
+ In such cases, you will have to include the regular prefix in your
+ filter script.
+