summaryrefslogtreecommitdiffstats
path: root/release_docs
diff options
context:
space:
mode:
authorQuincey Koziol <koziol@hdfgroup.org>2004-02-13 20:08:18 (GMT)
committerQuincey Koziol <koziol@hdfgroup.org>2004-02-13 20:08:18 (GMT)
commit31596fc1bd33360c24c9e53bdd2fbfac14d5d6b9 (patch)
treee0e11660cab56800d2c67306e64afea545087592 /release_docs
parentb8edc9384d4b192109fce2c0ad8bd0b3a4c7658a (diff)
downloadhdf5-31596fc1bd33360c24c9e53bdd2fbfac14d5d6b9.zip
hdf5-31596fc1bd33360c24c9e53bdd2fbfac14d5d6b9.tar.gz
hdf5-31596fc1bd33360c24c9e53bdd2fbfac14d5d6b9.tar.bz2
[svn-r8201] Purpose:
Code cleanup/bug fix Description: Fix configuration files to allow 64-bit compilation of the library with a 64-bit version of zlib. Solution: Moved important compiler flags settings from CC macro to CFLAGS macro. Instead of setting CC (F9X, CXX) environment variable for compiling for 64-bit code, users should just set the CFLAGS (FFLAGS, CXXFLAGS) to -q64. Updated INSTALL file to reflect this change. Platforms tested: IBM p690 (copper) w/parallel, FORTRAN, C++, srcdir. Platforms specific - h5committest does not apply.
Diffstat (limited to 'release_docs')
-rw-r--r--release_docs/INSTALL70
1 files changed, 38 insertions, 32 deletions
diff --git a/release_docs/INSTALL b/release_docs/INSTALL
index df6098f..2dc67fc 100644
--- a/release_docs/INSTALL
+++ b/release_docs/INSTALL
@@ -32,14 +32,18 @@
5.3. Configuring
5.3.1. Specifying the installation directories
5.3.2. Using an alternate C compiler
- 5.3.3. Additional compilation flags
- 5.3.4. Compiling HDF5 wrapper libraries
- 5.3.5. Specifying other programs
- 5.3.6. Specifying other libraries and headers
- 5.3.7. Static versus shared linking
- 5.3.8. Optimization versus symbolic debugging
- 5.3.9. Large (>2GB) vs. small (<2GB) file capability
- 5.3.10. Parallel vs. serial library
+ 5.3.3. Configuring for 64-bit support
+ 5.3.4. Additional compilation flags
+ 5.3.5. Compiling HDF5 wrapper libraries
+ 5.3.6. Specifying other programs
+ 5.3.7. Specifying other libraries and headers
+ 5.3.8. Static versus shared linking
+ 5.3.9. Optimization versus symbolic debugging
+ 5.3.10. Large (>2GB) vs. small (<2GB) file capability
+ 5.3.11. Parallel vs. serial library
+ 5.3.12. Threadsafe capability
+ 5.3.13. Backward compatibility
+ 5.3.14. Network stream capability
5.4. Building
5.5. Testing
5.6. Installing
@@ -251,6 +255,10 @@
$ CC=/usr/local/mpi/bin/mpicc ./configure
+5.3.3. Configuring for 64-bit support
+ Several machine architectures support 32-bit or 64-bit binaries.
+ The options below describe how to enable support for different options.
+
On Irix64 the default compiler is `cc'. To use an alternate
compiler specify it with the CC variable:
@@ -262,19 +270,16 @@
$ CC='cc -xarch=v9' ./configure
- To configure AIX 64 bits including fortran API,
- (Remark: need to hardset $AR to 'ar -X 64'.)
+ To configure AIX 64-bit support including fortran API and C++,
+ (Note: need to set $AR to 'ar -X 64'.)
Serial:
- $ CC='xlc -q64' F9X='xlf -q64' AR='ar -X 64'\
+ $ CFLAGS=-q64 FFLAGS=-q64 CXXFLAGS=-q64 AR='ar -X 64'\
$ ./configure --enable-fortran
- Parallel:
- $ CC='mpcc_r -q64' F9X='mpxlf_r -q64' AR='ar -X 64'\
+ Parallel: (C++ not supported with parallel)
+ $ CFLAGS=-q64 FFLAGS=-q64 AR='ar -X 64'\
$ ./configure --enable-fortran
- Specifying these machine architecture flags in the CFLAGS variable
- (see below) will not work correctly.
-
-5.3.3. Additional compilation flags
+5.3.4. Additional compilation flags
If addtional flags must be passed to the compilation commands
then specify those flags with the CFLAGS variable. For instance,
to enable symbolic debugging of a production version of HDF5 one
@@ -282,7 +287,7 @@
$ CFLAGS=-g ./configure --enable-production
-5.3.4. Compiling HDF5 wrapper libraries
+5.3.5. Compiling HDF5 wrapper libraries
One can optionally build the Fortran and/or C++ interface to the
HDF5 C library. By default, both options are disabled. To build
them, specify `--enable-fortran' and `--enable-cxx' respectively.
@@ -314,7 +319,7 @@
Note: See sections 5.7 and 5.8 for how to build Fortran Library with
PGI or Intel compilers.
-5.3.5. Specifying other programs
+5.3.6. Specifying other programs
The build system has been tuned for use with GNU make but works
also with other versions of make. If the `make' command runs a
non-GNU version but a GNU version is available under a different
@@ -348,7 +353,7 @@
because the HDF5 makefiles also use the install program to
also change file ownership and/or access permissions.
-5.3.6. Specifying other libraries and headers
+5.3.7. Specifying other libraries and headers
Configure searches the standard places (those places known by the
systems compiler) for include files and header files. However,
additional directories can be specified by using the CPPFLAGS
@@ -388,7 +393,7 @@
$ ./configure --with-szlib=/Szip_Install_Directory
-5.3.7. Static versus shared linking
+5.3.8. Static versus shared linking
The build process will create static libraries on all systems and
shared libraries on systems that support dynamic linking to a
sufficient degree. Either form of library may be suppressed by
@@ -404,7 +409,7 @@
$ ./configure --enable-static-exec
-5.3.8. Optimization versus symbolic debugging
+5.3.9. Optimization versus symbolic debugging
The library can be compiled to provide symbolic debugging support
so it can be debugged with gdb, dbx, ddd, etc or it can be
compiled with various optimizations. To compile for symbolic
@@ -441,7 +446,7 @@
releases). The tracing must also be enabled at runtime to see any
output (see Debugging.html).
-5.3.9. Large (>2GB) vs. small (<2GB) file capability
+5.3.10. Large (>2GB) vs. small (<2GB) file capability
In order to read or write files that could potentially be larger
than 2GB it is necessary to use the non-ANSI `long long' data
type on some platforms. However, some compilers (e.g., GNU gcc
@@ -451,31 +456,32 @@
$ ./configure --disable-hsizet
-5.3.10. Parallel vs. serial library
+5.3.11. Parallel vs. serial library
The HDF5 library can be configured to use MPI and MPI-IO for
parallelizm on a distributed multi-processor system. Read the
file INSTALL_parallel for detailed explanations.
-5.3.11. Threadsafe capability
+5.3.12. Threadsafe capability
The HDF5 library can be configured to be thread-safe (on a very
large scale) with the with the `--enable-threadsafe' flag to
configure. Read the file doc/TechNotes/ThreadSafeLibrary.html for
further details.
-5.3.12. Backward compatibility
- The 1.6 version of the HDF5 library can be configured to operate
- identically to the v1.4 library with the `--enable-hdf5v1_4'
+5.3.13. Backward compatibility
+ The 1.8 version of the HDF5 library can be configured to operate
+ identically to the v1.6 library with the `--enable-hdf5v1_6'
configure flag. This allows existing code to be compiled with the
- v1.6 library without requiring immediate changes to the
+ v1.8 library without requiring immediate changes to the
application source code. This flag will only be supported in the
- v1.6 branch of the library, it will not be available in v1.7+.
+ v1.8 branch of the library, it will not be available in v1.9+.
-5.3.13. Network stream capability
+5.3.14. Network stream capability
The HDF5 library can be configured with a network stream file
driver with the `--enable-stream-vfd' configure flag. This option
compiles the "stream" Virtual File Driver into the main library.
See the documentation on the Virtual File Layer for more details
- about the use of this driver.
+ about the use of this driver. The network stream capability is
+ enabled by default.
5.4. Building
The library, confidence tests, and programs can be build by