From 4c5cbf9719c69a608f343a049509cb663bd69d75 Mon Sep 17 00:00:00 2001 From: Allen Byrne Date: Wed, 1 Oct 2014 11:02:19 -0500 Subject: [svn-r25648] Update cygwin install doc with better information contained in the trunk version. Added debug VFD tests to known problems. Checked versions of windows and extra linux VMs. --- release_docs/INSTALL_Cygwin.txt | 81 +++++++++++++++++++++++++++-------------- release_docs/RELEASE.txt | 5 +++ 2 files changed, 58 insertions(+), 28 deletions(-) diff --git a/release_docs/INSTALL_Cygwin.txt b/release_docs/INSTALL_Cygwin.txt index a7e5f67..a56895a 100644 --- a/release_docs/INSTALL_Cygwin.txt +++ b/release_docs/INSTALL_Cygwin.txt @@ -2,14 +2,20 @@ HDF5 Build and Install Instructions for Cygwin ************************************************************************ +This document is a instruction on how to build, test and install HDF5 libary on +Cygwin. See detailed information in hdf5/INSTALL. + +NOTE: hdf5 can be built with CMake, see the INSTALL_CMake.txt file for more guidance. + Preconditions: -------------- -1. Installed Cygwin 1.7.15 or higher +1. Installed Cygwin 1.7.25 or higher To install the Cygwin net release, go to http://www.cygwin.com and - click on "Install or update now!" icon. This will download a GUI - installer called setup.txt which can be run to download a complete + click on "setup-x86.exe" (32-bit installation) under the heading + "Current Cygwin DLL version". This will download a GUI + installer called setup-x86.exe which can be run to download a complete Cygwin installation via the internet. Then follow the instructions on each screen to install Cygwin. @@ -18,42 +24,46 @@ Preconditions: http://www.cygwin.com/packages/ provides detailed information about Cygwin packages. - To build HDF5 on Cygwin, Devel package (including gcc,gcc-g++, - gcc-gfortran, and gcc-java compiles, and gdb tool) should be installed. + Most required dependencies can be satisfied by installing all packages in + the "Devel" category. However, please verify that you have installed all + packages listed below. -2. Compilers Installed +2. Compilers, Libraries and Utilities Installed - 2.1 C/C++ Compilers HDF5-1.8 Supported - - gcc (4.5.3), which includes: + 2.1 Compilers Supported + + The following compilers are supported by HDF5 and included in the Cygwin + package system: + gcc (4.7.3), which includes: gcc4-core : C compiler gcc4-g++ : C++ compiler gcc4-fortran : fortran compiler + - 2.2 Using Compilers Not Supported - - The compilers in 2.1 are supported and tested by HDF - group. Any other compilers may still work but they are not - guaranteed by HDF group. - - If users want to use other compilers except those in 2.1, - try to set the following variables to override the default - choices. + 2.1.1 Using Compilers Not Supported - CXX : C++ compiler command - FC : Fortran compiler command + By default the current configuration uses vendor compilers; to use + another compiler run the following commands before running + configure: + + setenv CC "foo -flags" + setenv FC "fffoo -flags" For example, if users want to use pgf90 as fortran compiler, then setenv FC pgf90 - -3. HDF5 Dependencies - 3.1 Zlib + See the configure help page (configure --help) for a list of + environment variables that have an affect on building the + library. + + 2.2 HDF5 External Library Dependencies + + 2.2.1 Zlib - zlib-1.2.5 or later is supported and tested on Cygwin. + zlib-1.2.5 or later is supported and tested on Cygwin. - 3.2 Szip + 2.2.2 Szip The HDF5 library has a predefined compression filter that uses the extended-Rice lossless compression algorithm for chunked datatsets. For more information about Szip compression and @@ -64,9 +74,24 @@ Preconditions: ftp://ftp.hdfgroup.org/lib-external/szip/2.1. Binary distribution can be found under ftp://ftp.hdfgroup.org/lib-external/szip/2.1/bin/cygwin - -Install HDF5 on Cygwin ----------------------- + + 2.3 Additional Utilities + + The following standard utilities are also required to build and test HDF5: + + bison : yacc implementation + flex : flex utility + make : make utility + + 2.4 Alternate Build Process + + Download the CMake package and follow the notes in the "INSTALL_CMake.txt" + file to build HDF5 with the CMake utilities. + + + +Build, Test and Install HDF5 on Cygwin +-------------------------------------- 1. Get HDF5 source code package Users can download HDF5 source code package from HDF website diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt index 70296c7..05ec7e4 100644 --- a/release_docs/RELEASE.txt +++ b/release_docs/RELEASE.txt @@ -367,6 +367,11 @@ The following platforms are not supported but have been tested for this release. Known Problems ============== +* On windows platforms in debug configurations, the VFD flush1 tests will fail + with the split and multi VFD drivers. These tests will display a modal debug + dialog which must be answered or wait for the test timeout to expire. + (ADB - 2014/06/23 - HDFFV-8851) + * CLANG compiler with the options -fcatch-undefined-behavior and -ftrapv catches some undefined behavior in the alignment algorithm of the macro DETECT_I in H5detect.c (Issue 8147). Since the algorithm is trying to detect the alignment -- cgit v0.12