diff options
Diffstat (limited to 'INSTALL')
| -rw-r--r-- | INSTALL | 72 |
1 files changed, 48 insertions, 24 deletions
@@ -26,28 +26,27 @@ for the install may be found in the file: INSTALL.ascired. Step 0: Install optional third-party packages. * GNU zlib compression library, version 1.0.2 or later is used for - the `deflate' compression method. If libz.a cannot be found then - this form of compression is not compiled into the library. + the `deflate' compression method if available; otherwise no + compression filters will be predefined. Step 1. Unpack the source tree. - * The tarball will unpack into an hdf5-1.0.0a directory with one of + * The tarball will unpack into an hdf5-1.1.0 directory with one of the following commands: - $ tar xf hdf5-1.0.0a.tar OR - $ gunzip <hdf5-1.0.0a.tar.gz |tar xf - OR - $ bunzip2 <hdf5-1.0.0a.tar.bz2 |tar xf - OR - $ uncompress -c <hdf5-1.0.0a.tar.Z |tar xf - + $ tar xf hdf5-1.1.0.tar OR + $ gunzip <hdf5-1.1.0.tar.gz |tar xf - OR + $ bunzip2 <hdf5-1.1.0.tar.bz2 |tar xf - OR + $ uncompress -c <hdf5-1.1.0.tar.Z |tar xf - Step 2. Configure. * HDF5 uses the GNU autoconf program for configuration. Most installations can be configured by typing just (from the - hdf5-1.0.0a directory) + hdf5-1.1.0 directory) $ sh configure - * The configuration process can be controlled through environment variables, command-line switches, and host configuration files. For a complete list of switches say `sh configure --help'. @@ -92,13 +91,12 @@ Step 2. Configure. `--disable-hsizet' can be given but the resulting library will be unable to handle datasets larger than 4GB. - * By default libraries, include files, programs, and documentation - are installed (when one says `make install') under - /usr/local/lib, /usr/local/include, /usr/local/bin, and - /usr/local/man. However, if you want them in some other - location you can specify a prefix to use instead of /usr/local. - For instance, to install in /usr/lib, /usr/include, /usr/bin, - and /usr/man one would say + * Libraries, include files, programs, and documentation are + installed (when one says `make install') under /usr/local/lib, + /usr/local/include, /usr/local/bin, and /usr/local/man. + However, if you want them in some other location you can specify + a prefix to use instead of /usr/local. For instance, to install + in /usr/lib, /usr/include, /usr/bin, and /usr/man one would say $ ./configure --prefix=/usr @@ -129,11 +127,11 @@ Step 4. Run confidence tests. The command will fail if any test fails, and one will see the word "*FAIL*" in the output. - Note: some old versions of make will report that `test is up to + * Some old versions of make will report that `test is up to date'. If this happens then run `make _test' instead or run `make test' from within the test directory. - Temporary files will be deleted by each test when it completes, + * Temporary files will be deleted by each test when it completes, but may continue to exist in an incomplete state if the test fails. To prevent deletion of the files define the HDF5_NOCLEANUP environment variable. @@ -144,12 +142,38 @@ Step 5. Install public files. $ make install - This step will fail unless you have permission to write to the - installation directories. Of course, you can use the header - files, library, and programs directly out of the source tree if - you like, skipping this step. The directory specified for the - --prefix switch (or "/usr/local") must exist, but the directories - under it are created automatically by make. + * This step will fail unless you have permission to write to the + installation directories. Of course, you can use the header + files, library, and programs directly out of the source tree if + you like, skipping this step. The directory specified for the + --prefix switch (or "/usr/local") must exist, but the + directories under it are created automatically by make. + + * The minimum which must be installed are: + + The library: + ./src/libhdf5.a + + The public header files: + ./src/H5*public.h + + The main header file: + ./src/hdf5.h + + The configuration information: + ./src/H5config.h + + * Additional useful things which are installed: + + The tools library: + ./tools/libh5tools.a + + Some tools: + ./tools/h5ls + ./tools/h5repart + ./tools/h5dump + ./tools/h5debug + ./tools/h5import (a demo) Step 6. Subscribe to mailing lists. |