From d01a78001faa924fd31ae27bb748648442c8913a Mon Sep 17 00:00:00 2001 From: Albert Cheng Date: Tue, 26 Sep 2000 11:10:33 -0500 Subject: [svn-r2595] Purpose: Feature Description: Added a new document of all the controls (compiler macros, environment variables, ...) that affect the functionality of the libraries and tools. Platforms tested: Viewed with MS IE. --- doc/html/TechNotes.html | 6 ++++++ doc/html/TechNotes/SWControls.html | 37 +++++++++++++++++++++++++++++++++++++ 2 files changed, 43 insertions(+) create mode 100755 doc/html/TechNotes/SWControls.html diff --git a/doc/html/TechNotes.html b/doc/html/TechNotes.html index 4a9c6b2..83145b0 100644 --- a/doc/html/TechNotes.html +++ b/doc/html/TechNotes.html @@ -158,6 +158,12 @@ HDF5 Technical Notes datatypes, etc. +HDF5 Software Controls + + A descriptions knobs and turns such as environment variables and settings + that controls the functionalities of HDF5 libraries and tools. + + diff --git a/doc/html/TechNotes/SWControls.html b/doc/html/TechNotes/SWControls.html new file mode 100755 index 0000000..c99d46f --- /dev/null +++ b/doc/html/TechNotes/SWControls.html @@ -0,0 +1,37 @@ + + + + +HDF5 Software Controls + + + + +

HDF5 Software Controls

+(Work in progress draft)
+

A descriptions knobs and turns such as environment variables and settings that controls the functionality of HDF5 libraries and tools. This is intended for HDF5 libraries and tools developers. HDF5 application users may consult the document A guide to debugging HDF5 API calls.

+Library Building Controls
+Environment variables
+

CC -- Used by configure. Override the default C compiler.

LIBS -- Used by configure. Add more libraries to be used.

NP -- number of MPI-processes to invoke for testing. Default to 2.

HDF5_NOCLEANUP -- Used by most test programs. When set, temporary files created during tests are NOT removed. Default is to remove them by the end of each test. Note that the variable value does not matter. E.g., the values of "yes", "no" and "" all have the same effect, that is, NO cleanup.

H5FD_mpio_Debug--Used by the MPIO file driver for debugging. Need to have H5FDmpio_DEBUG macro defined during compiling. Should be set to a string to turn on various tracing. Valid values (cases matter) are:

t: Trace all routine
r: Trace read routines
w: Trace write routines
c: Show result of MPI_Get_count

+Compile Macros
+

H5FDmpio_DEBUG--compile macro. Compile in the MPIO file driver related debugging statements. Defined if macro H5F_DEBUG is defined.

H5FD_mpio_Debug--Compile in debugging used by the MPIO file driver. Need to have H5FDmpio_DEBUG macro defined during compiling. Should be set to a string to turn on the tracing. See environment variable H5FD_mpio_Debug for valid values.

HDF Help Desk

Last modified: September 26, 2000

+ -- cgit v0.12