diff options
| -rw-r--r-- | release_docs/INSTALL_Cygwin.txt | 81 |
1 files changed, 53 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 |