diff options
author | Allen Byrne <byrn@hdfgroup.org> | 2014-10-01 16:02:19 (GMT) |
---|---|---|
committer | Allen Byrne <byrn@hdfgroup.org> | 2014-10-01 16:02:19 (GMT) |
commit | 4c5cbf9719c69a608f343a049509cb663bd69d75 (patch) | |
tree | 05cfd60a7be6fe6daf1d928b1dd6258ca36402c5 /release_docs | |
parent | 4254a2b1955f04c1b93574a570481f1d12136c8b (diff) | |
download | hdf5-4c5cbf9719c69a608f343a049509cb663bd69d75.zip hdf5-4c5cbf9719c69a608f343a049509cb663bd69d75.tar.gz hdf5-4c5cbf9719c69a608f343a049509cb663bd69d75.tar.bz2 |
[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.
Diffstat (limited to 'release_docs')
-rw-r--r-- | release_docs/INSTALL_Cygwin.txt | 81 | ||||
-rw-r--r-- | 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 |