From 0436e6bc451cd8f283c7b5cfcd12a68713b4efed Mon Sep 17 00:00:00 2001 From: Fang Guo Date: Fri, 19 Aug 2005 15:15:36 -0500 Subject: [svn-r11272] Purpose: Improvement Description: Documentation for installing HDF5 on Cywin Solution: Platforms tested: Misc. update: --- release_docs/INSTALL_Cygwin.txt | 239 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 239 insertions(+) create mode 100644 release_docs/INSTALL_Cygwin.txt diff --git a/release_docs/INSTALL_Cygwin.txt b/release_docs/INSTALL_Cygwin.txt new file mode 100644 index 0000000..52541ed --- /dev/null +++ b/release_docs/INSTALL_Cygwin.txt @@ -0,0 +1,239 @@ +************************************************************************ + HDF5 Build and Install Instructions for Cygwin +************************************************************************ + +Preconditions: +-------------- + +1. Installed Cygwin 1.5.17 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 + Cygwin installation via the internet. Then follow the instructions + on each screen to install Cygwin. + + Cygwin uses packages to manage installing various software. Users can + choose to install or uninstall certain packages by running setup.exe. + http://www.cygwin.com/packages/ provides detailed information about + Cygwin packages. + + To build HDF5 on Cygwin, Devel package (including gcc,gcc-g++, + gcc-g77, and gcc-java compiles, and gdb tool) should be installed. + +2. Compilers Installed + + 2.1 C/C++ Compilers HDF5-1.8.0 Supported + + gcc-3.4.4 is included in Cygwin, which includes: + gcc : GNU C compiler + gcc-g++: GNU C++ compiler + gcc-g77: GNU Fortran 77 compiler + + 2.2 Fortran Compiler HDF5-1.8.0 Supported + + HDF5-1.8.0 supports g95(GCC 4.0.1 (g95!) Jul 22 2005) and higher. + + g95 is a free, open source Fortran 95 compiler. Users can + download the g95 binaries for Cygwin in the following website: + http://www.g95.org. + + 2.3 Using Compilers Not Supported + + The compilers in 2.1 and 2.2 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 and 2.2, + try to set the following variables to override the default + choices. + + CXX : C++ compiler command + FC : Fortran compiler command + + For example, if users want to use pgf90 as fortran compiler, then + + setenv FC pgf90 + +3. HDF5 Dependencies + + 3.1 Zlib + + zlib-1.2.2 or later is supported and tested on Cygwin. + + 3.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 + license terms see + http://hdf.ncsa.uiuc.edu/HDF5/doc_resource/SZIP/index.html. + + The latest supported public release of SZIP is available from + ftp://hdf.ncsa.uiuc.edu/szip/2.0. Binary distribution can be + found under ftp://hdf.ncsa.uiuc.edu/lib-external/szip/2.0/bin + + +Install HDF5 on Cygwin +---------------------- + +1. Get HDF5 source code package + Users can download HDF5 source code package from HDF website + (http://hdf.ncsa.uiuc.edu). + +2. Unpacking the distribution + + The HDF5 source code is distributed in a variety of formats which + can be unpacked with the following commands, each of which creates + an `hdf5-1.8.0' directory. + + 2.1 Non-compressed tar archive (*.tar) + + $ tar xf hdf5-1.8.0.tar + + 2.2 Gzip'd tar archive (*.tar.gz) + + $ gunzip < hdf5-1.8.0.tar.gz | tar xf - + + 2.3 Bzip'd tar archive (*.tar.bz2) + + $ bunzip2 < hdf5-1.8.0.tar.bz2 | tar xf - + +3. Configuring + + Notes: See detailed information in hdf5/release_docs/INSTALL, + part 5. Full installation instructions for source + distributions + + The host configuration file for cygwin i686-pc-cygwin is located + in the `config' directory and are based on architecture name, + vendor name, and operating system which are displayed near the + beginning of the `configure' output. The host config file influences + the behavior of configure by setting or augmenting shell variables. + + In short, + + 3.1 To configure HDF5 C Library, using + + $ ./configure + + 3.2 To configure HDF5 C/C++ Library, using + + $ ./configure --enable-cxx + + 3.3 To configure HDF5 C/Fortran Library, using + + $ ./configure --enable-fortran + + 3.4 To configure HDF5 C with Szip library, using + + $ ./configure --with-szlib="path to szlib" + + For example, if szip library was installed in the directory + /cygdrive/c/szip, which is parent directory of "include" and + "lib", then the following command will configure HDF5 C library + with szip enabled: + + $ ./configure --with-szlib=/cygdrive/c/szip + + 3.5 To configure HDF5 C without Zlib, + + To disable zlib, using + + $ ./configure --without-zlib + + 3.6 Two ways to configure HDF5 C with specified Zlib + + 3.6.1 Using + + $ ./configure --with-zlib=INCDIR,LIBDIR + + For example, if the zlib library is installed in + /cygdrive/c/usr, which is the parent directory of directories + "include" and "lib", + + $ ./configure --with-zlib=/cygdrive/c/usr/include,/cygdrive/c/usr/lib + + 3.6.2 Through the CPPFLAGS and LDFLAGS Variables + + For example, if zlib was installed in the directory + /cygdrive/c/usr then using the following command to configure + HDF5 with zib + + $ CPPFLAGS=-I/cygdrive/c/usr/include \ + $ LDFLAGS=-L/cygdrive/c/usr/lib \ + $ ./configure + + 3.7 To specify the installation directories, using + + $ ./configure --prefix="path for installation" + + By default, HDF5 library, header files, examples, and + support programs will be installed in /usr/local/lib, + /usr/local/include, /usr/local/doc/hdf5/examples, and + /usr/local/bin. To use a path other than /usr/local specify + the path with the `--prefix=PATH' switch as in the above + command. + + 3.8 Combination of Switches + + All of the above switches can be combined together. For + example, if users want to configure HDF5 C/C++/Fortran + library with szip library enabled, with zlib library at + /cygdrive/c/usr/, and install HDF5 into directory + /cygdrive/c/hdf5 using gcc/g++ as C/C++ compiler and g95 + as fortran compiler + + $ ./configure + --with-szlib=/cygdrive/c/szip + --with-zlib=/cygdrive/c/usr/include,/cygdrive/c/usr/lib + --prefix=/cygdrive/c/hdf5 + --enable-cxx + --enable-fortran + <"If no more switches, then hit Enter"> + + Notes: The command format above is for readilibity. In practice, + please type in the command above with at least one + space between each line, No "Enter" until users finish + the switches and want to run the configure. + + + or do it through CPPFLAGS and LDFLAGS variables: + + $ CPPFLAGS=-I/cygdrive/c/usr/include \ + $ LDFLAGS=-L/cygdrive/c/usr/lib \ + + $ ./configure + --with-szlib=/cygdrive/c/szip + --prefix=/cygdrive/c/hdf5 + --enable-cxx + --enable-fortran + <"If no more switches, then hit Enter"> + +4. Make and Make Check + + After configuration is done successfully, run the following series of + commands to build, test and install HDF5 + + $ make > "output file name" + $ make check > "output file name" + + Before run "make install", check output file for "make check", there + should be no failures at all. + +5. Make Install + + $ make install > "output file name" + + +6. Check installed HDF5 library + + After step 4, go to your installation directory, there should be + three subdirectories: "bin" "include" and "lib". + +7. Known Problems + + Shared libraries can not be built on Cygwin In release 1.8.0. + +----------------------------------------------------------------------- + +Need Further assistance, email hdfhelp@ncsa.uiuc.edu -- cgit v0.12