[svn-r949] Changes since 19981124
---------------------- ./src/H5T.c Fixed a typo in the registration of the `unsigned char' to `unsigned long long' type conversion that caused it to not be registered, falling back to software whenever that conversion path was taken. ./MANIFEST ./test/Makefile.in ./test/testhdf5.c ./test/testhdf5.h ./test/theap.c [REMOVED] ./test/lheap.c [NEW] ./test/tohdr.c [REMOVED] ./test/ohdr.c [NEW] ./test/tstab.c [REMOVED] ./test/stab.c [NEW] Removed the `t' from the front of these names and made each test a stand-alone program following the format of most of the other tests. ./test/big.c Uses libh5test.a but always sets the low-level driver to 1GB file family. The `#if' near the top to set the data space to 8GB has been simplified now that `long_long' is always defined and the error message is improved when `long_long' isn't wide enough. Cleanup code was added to the error handling. ./test/gheap.c ./test/istore.c Uses libh5test.a. Added error cleanup code. ./test/dtypes.c ./test/h5test.c Added 68 new tests that check hardware and software conversions between `long long' and `unsigned long long' and the other integer types. The tests only run on machines where sizeof(long_long)!=sizeof(long). We test a total of 180 different integer conversions, half in hardware and half in software. Cut down the number of times each test is run from 5 to 1 so it doesn't take so long. If you want to run more times there's a constant that can be changed at the top of the file. ./test/extend.c Removed unused variable. ./test/h5test.c ./test/h5test.h ./test/external.c ./test/fillval.c The h5_cleanup() returns true/false so it can be used in an `if' statement to clean up additional files. ./doc/html/Environment.html Indented. Added HDF5_PREFIX and HDF5_DRIVER descriptions. ./src/H5P.c Changed the trace type for the second argument from `Iu' to `x' since it's an output parameter. ./INSTALL Added a warning that the GNU zlib that comes with the latest version of HDF4 is too old to use with HDF5 and must be renamed so configure doesn't see it when `--enable-hdf4' is used.
This commit is contained in:
@@ -1,66 +1,102 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
|
||||
<html>
|
||||
<head>
|
||||
<title>HDF5 Library Environment Variables and Configuration Parameters</title>
|
||||
</head>
|
||||
<head>
|
||||
<title>HDF5 Library Environment Variables
|
||||
and Configuration Parameters</title>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<body>
|
||||
|
||||
<h1>HDF5 Library Environment Variables and Configuration Parameters</h1>
|
||||
<h1>HDF5 Library Environment Variables and Configuration Parameters</h1>
|
||||
|
||||
<h2>1. Environment Variables</h2>
|
||||
<h2>1. Environment Variables</h2>
|
||||
|
||||
The HDF5 library uses UNIX environment variables to control
|
||||
or adjust certain library features at runtime. The variables and
|
||||
their defined effects are as follows:
|
||||
The HDF5 library uses UNIX environment variables to control
|
||||
or adjust certain library features at runtime. The variables and
|
||||
their defined effects are as follows:
|
||||
|
||||
<dir>
|
||||
<dl>
|
||||
<dt><tt>HDF5_DEBUG</tt>
|
||||
<dd>Defines a list of debugging switches documented in the
|
||||
<a href="Debugging.html">Debugging</a> section of the
|
||||
<cite>HDF5 User's Guide</cite>.
|
||||
<center>
|
||||
<table width="90%">
|
||||
<tr>
|
||||
<th>Variable</th>
|
||||
<th>Description</th>
|
||||
</tr>
|
||||
|
||||
<dt><tt>HDF5_NOCLEANUP</tt>
|
||||
<dd>When set to a non-empty value, the programs in the test
|
||||
directory do not remove temporary HDF5 data files.
|
||||
The default is for each test to remove the files before exit.
|
||||
<tr valign=top>
|
||||
<td><code>HDF5_DEBUG</code></td>
|
||||
<td>Defines a list of debugging switches documented in the
|
||||
<a href="Debugging.html">Debugging</a> section of the
|
||||
<cite>HDF5 User's Guide</cite>.</td>
|
||||
</tr>
|
||||
|
||||
<dt><tt>HDF5_MPI_OPT_TYPES</tt>
|
||||
(for parallel beta version only)
|
||||
<dd>When set to <code>1</code>, PHDF5 will use the MPI optimized
|
||||
code to perform parallel read/write accesses to datasets.
|
||||
Currently, this optimization fails when accessing extendable
|
||||
datasets. The default is not to use the optimized code.
|
||||
<tr valign=top>
|
||||
<td><code>HDF5_NOCLEANUP</code></td>
|
||||
<td>If set then programs in the test directories do not
|
||||
remove temporary files. The default is for each test to
|
||||
remove the files before exit if the test succeeds but to
|
||||
leave the files if the test fails.</td>
|
||||
</tr>
|
||||
|
||||
<dt><tt>HDF5_MPI_1_METAWRITE</tt>
|
||||
(for parallel beta version only)
|
||||
<dd>When set to <code>1</code>, PHDF5 will write the metadata
|
||||
via process 0 of each opened parallel HDF5 file. This should
|
||||
improve I/O throughput. The default is not to use this
|
||||
optimization.
|
||||
<tr valign=top>
|
||||
<td><code>HDF5_PREFIX</code></td>
|
||||
<td>The value of this variable is prepended to all temporary
|
||||
file names created by the test programs and separated from
|
||||
the base name of the file by a slash. The default is no
|
||||
prefix.</td>
|
||||
</tr>
|
||||
|
||||
</dl>
|
||||
</dir>
|
||||
<tr valign=top>
|
||||
<td><ode>HDF5_DRIVER</code></td>
|
||||
<td>This variable should hold the name of a low-level HDF5
|
||||
file driver such as <code>sec2</code>, <code>stdio</code>,
|
||||
<code>core</code>, <code>split</code>, or
|
||||
<code>family</code>. The family driver also takes an
|
||||
optional real-valued family member size in MB which
|
||||
defaults to 1. If this variable is not set or empty then
|
||||
the library-defined default file driver is used (which can
|
||||
be set at configuration time with the H5F_LOW_DFLT cpp
|
||||
constant, usually <code>sec2</code>).</td>
|
||||
</tr>
|
||||
|
||||
<h2>2. Configuration Parameters</h2>
|
||||
<tr valign=top>
|
||||
<td><code>HDF5_MPI_OPT_TYPES</code></td>
|
||||
<td>When set to <code>1</code>, parallel HDF5 will use the
|
||||
MPI-optimized code to perform parallel read/write accesses
|
||||
to datasets. Currently, this optimization fails when
|
||||
accessing extendable datasets. The default is not to use
|
||||
the optimized code.</td>
|
||||
</tr>
|
||||
|
||||
The HDF5 configuration script accepts a list of parameters to control
|
||||
configuration features when creating the Makefiles for the library.
|
||||
The command
|
||||
<br>
|
||||
<code> configure --help </code>
|
||||
<br>
|
||||
will display the current list of parameters and their effects.
|
||||
<tr valign=top>
|
||||
<td><code>HDF5_MPI_1_METAWRITE</code></td>
|
||||
<td>When set to <code>1</code>, parallel HDF5 will write the
|
||||
metadata via process 0 of each opened parallel HDF5 file.
|
||||
This should improve I/O throughput. The default is not to
|
||||
use this optimization.</td>
|
||||
</tr>
|
||||
|
||||
<hr>
|
||||
</table>
|
||||
</center>
|
||||
|
||||
<address>
|
||||
<a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a>
|
||||
</address>
|
||||
|
||||
Last modified: 9 September 1998
|
||||
<h2>2. Configuration Parameters</h2>
|
||||
|
||||
</body>
|
||||
The HDF5 configuration script accepts a list of parameters to control
|
||||
configuration features when creating the Makefiles for the library.
|
||||
The command
|
||||
<br>
|
||||
<code> configure --help </code>
|
||||
<br>
|
||||
will display the current list of parameters and their effects.
|
||||
|
||||
<hr>
|
||||
|
||||
<address>
|
||||
<a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a>
|
||||
</address>
|
||||
|
||||
Last modified: 9 September 1998
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user