diff options
| -rwxr-xr-x | doc/html/TechNotes/SWControls.html | 111 |
1 files changed, 84 insertions, 27 deletions
diff --git a/doc/html/TechNotes/SWControls.html b/doc/html/TechNotes/SWControls.html index 2dd5a5e..8dac1ce 100755 --- a/doc/html/TechNotes/SWControls.html +++ b/doc/html/TechNotes/SWControls.html @@ -1,3 +1,4 @@ +<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"> <HTML> <HEAD> <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252"> @@ -5,35 +6,91 @@ <TITLE>HDF5 Software Controls</TITLE> <META NAME="Template" CONTENT="E:\Program Files\Microsoft Office\Office\html.dot"> </HEAD> + <BODY LINK="#0000ff" VLINK="#800080"> -<H1><!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">HDF5 Software Controls</H1> -<I><P>(Work in progress draft)</P> -</I><P>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 HREF="../Debugging.html"><I>A guide to debugging HDF5 API calls</I></A>.</P> -<B><FONT FACE="Arial" SIZE=4><P>Library Building Controls</P> -</FONT><I><FONT FACE="Arial"><P>Environment variables</P> -</B></I></FONT><P>CC -- Used by configure. Override the default C compiler.</P> -<P>LIBS -- Used by configure. Add more libraries to be used.</P> -<P>NP -- number of MPI-processes to invoke for testing. Default to 2.</P> -<P>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.</P> -<P>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:</P> +<H1>HDF5 Software Controls</H1> + +<P> +<I>(Work in progress draft)</i> +</P> + +<P> +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 HREF="../Debugging.html"><I>A guide to +debugging HDF5 API calls</I></A>. +</P> + +<P> +<H2><FONT FACE="Arial">Library Building Controls</FONT></H2> +</P> + +<P> +<H3><FONT FACE="Arial">Environment variables</FONT></H3> +</P> + +<DL> + <DT><B>CC</B></DT> + <DD><I>Used by configure.</I> Override the default C compiler.</DD> + <DT><B>LIBS</B></DT> + <DD><I>Used by configure.</I> Add more libraries to be used.</DD> + <DT><B>NP</B></DT> + <DD>Number of MPI-processes to invoke for testing. Default to 2.</DD> + <DT><B>HDF5_NOCLEANUP</B></DT> + <DD><I>Used by most test programs.</I> 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.</DD> + <DT><B>H5FD_mpio_Debug</B></DT> + <DD><I>Used by the MPIO file driver for debugging.</I> 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: + <DL> + <DT>t</DT> + <DD>Trace all routine</DD> + <DT>r</DT> + <DD>Trace read routines</DD> + <DT>w</DT> + <DD>Trace write routines</DD> + <DT>c</DT> + <DD>Show result of MPI_Get_count</DD> + </DL> + </DD> + <DT><B>HDF5_MPI_OPT_TYPES</B></DT> + <DD><I>Used by the MPIO file driver to control the use of the optimized + mpi input/output routine.</I> 0 turns it off, 1 turns it on (uses + optimized code if it can).</DD> +</DL> + +<P> +<H3><FONT FACE="Arial">Compile Macros</FONT></H3> +</P> + <DL> -<DT>t</DT> -<DD>Trace all routine</DD> -<DT>r</DT> -<DD>Trace read routines</DD> -<DT>w</DT> -<DD>Trace write routines</DD> -<DT>c</DT> -<DD>Show result of MPI_Get_count</DD> + <DT><B>H5FDmpio_DEBUG</B></DT> + <DD><I>Compile macro.</I> Compile in the MPIO file driver related debugging + statements. Defined if macro H5F_DEBUG is defined.</DD> + <DT><B>H5FD_mpio_Debug</B></DT> + <DD>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.</DD> </DL> -<P>HDF5_MPI_OPT_TYPES--Used by the MPIO file driver to control the use of the -optimized mpi input/output routine. 0 turns it off, 1 turns it on (uses optimized code if it can).</P> -<P> </P> -<B><I><FONT FACE="Arial"><P>Compile Macros</P> -</B></I></FONT><P>H5FDmpio_DEBUG--compile macro. Compile in the MPIO file driver related debugging statements. Defined if macro H5F_DEBUG is defined.</P> -<P>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.</P> -<P><HR></P> -<ADDRESS><A HREF="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</A></ADDRESS> -<P><!-- Created: Fri Oct 3 11:52:31 EST 1997 --><!-- hhmts start -->Last modified: September 26, 2000 <!-- hhmts end --></P></BODY> + +<P> +<HR> +</P> + +<ADDRESS> +<A HREF="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</A> +</ADDRESS> + +<P><!-- Created: Fri Oct 3 11:52:31 EST 1997 --><!-- hhmts start -->Last +modified: December 11, 2000 <!-- hhmts end --></P> + +</BODY> </HTML> |