diff options
| author | Scott Wegner <swegner@hdfgroup.org> | 2007-02-26 20:43:21 (GMT) |
|---|---|---|
| committer | Scott Wegner <swegner@hdfgroup.org> | 2007-02-26 20:43:21 (GMT) |
| commit | dc76133bb11a114488ac58454f2a9bf6dfa2e1fb (patch) | |
| tree | f706133bdaf52b02528c197b37a283cfe92f58c7 /release_docs/INSTALL_Windows.html | |
| parent | 611b8dbb8a7bcf6a31a49d1f87b88bacbc377baa (diff) | |
| download | hdf5-dc76133bb11a114488ac58454f2a9bf6dfa2e1fb.zip hdf5-dc76133bb11a114488ac58454f2a9bf6dfa2e1fb.tar.gz hdf5-dc76133bb11a114488ac58454f2a9bf6dfa2e1fb.tar.bz2 | |
[svn-r13397] Various updates to bring Windows documentation up to date.
Diffstat (limited to 'release_docs/INSTALL_Windows.html')
| -rwxr-xr-x | release_docs/INSTALL_Windows.html | 7625 |
1 files changed, 4996 insertions, 2629 deletions
diff --git a/release_docs/INSTALL_Windows.html b/release_docs/INSTALL_Windows.html index 128eecc..fea6cdb 100755 --- a/release_docs/INSTALL_Windows.html +++ b/release_docs/INSTALL_Windows.html @@ -1,3099 +1,5466 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> +<head> -<!-- - * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * - * Copyright by The HDF Group. * - * Copyright by the Board of Trustees of the University of Illinois. * - * All rights reserved. * - * * - * This file is part of HDF5. The full HDF5 copyright notice, including * - * terms governing use, modification, and redistribution, is contained in * - * the files COPYING and Copyright.html. COPYING can be found at the root * - * of the source code distribution tree; Copyright.html can be found at the * - * root level of an installed copy of the electronic HDF5 document set and * - * is linked from the top-level documents page. It can also be found at * - * http://hdfgroup.org/HDF5/doc/Copyright.html. If you do not have * - * access to either file, you may request a copy from help@hdfgroup.org. * - * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * - --> +<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Copyright by The HDF Group. * * Copyright by the Board of Trustees of the University of Illinois. * * All rights reserved. * * * * This file is part of HDF5. The full HDF5 copyright notice, including * * terms governing use, modification, and redistribution, is contained in * * the files COPYING and Copyright.html. COPYING can be found at the root * * of the source code distribution tree; Copyright.html can be found at the * * root level of an installed copy of the electronic HDF5 document set and * * is linked from the top-level documents page. It can also be found at * * http://hdfgroup.org/HDF5/doc/Copyright.html. If you do not have * * access to either file, you may request a copy from help@hdfgroup.org. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * --> + <meta name="GENERATOR" content="Microsoft FrontPage 5.0"> -<head> -<meta name="GENERATOR" content="Microsoft FrontPage 5.0"> -<meta name="ProgId" content="FrontPage.Editor.Document"> -<meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> -<title>HDF5 Build and Install Instructions for Windows XP (Full Version)</title> -<style type="text/css"> + <meta name="ProgId" content="FrontPage.Editor.Document"> + + <meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> + <title>HDF5 Build and Install Instructions for Windows XP (Full +Version)</title> + + <style type="text/css"> a {text-decoration:none} a:link {color:#0000FF;} a:visited {color:purple;} a:hover {background-color:#FAEBD7;} - body { - margin-left:5%; - margin-right:5% - } +margin-left:5%; +margin-right:5% +} h1 { - font-family:font-family:times, arial, 'lucida console', sans-serif; - font-size: 160%; - font-style:bold; - color:#0000FF; - text-align:center; - text-transform:capitalize; - margin-top:30 - } +font-family:font-family:times, arial, 'lucida console', sans-serif; +font-size: 160%; +font-style:bold; +color:#0000FF; +text-align:center; +text-transform:capitalize; +margin-top:30 +} h2 { - font-family:font-family:times, arial, 'lucida console', sans-serif; - font-size: 140%; - font-style:bold; - color:#0000FF; - text-align:center; - text-transform:capitalize; - margin-top:20 - - } +font-family:font-family:times, arial, 'lucida console', sans-serif; +font-size: 140%; +font-style:bold; +color:#0000FF; +text-align:center; +text-transform:capitalize; +margin-top:20 +} h3 { - font-family:font-family:times, arial, 'lucida console', sans-serif; - font-size: 120%; - font-style:bold; - color:#0000FF; - text-transform:capitalize; - } +font-family:font-family:times, arial, 'lucida console', sans-serif; +font-size: 120%; +font-style:bold; +color:#0000FF; +text-transform:capitalize; +} h4 { - font-family:font-family:times, arial, 'lucida console', sans-serif; - font-size: 110%; - font-style:bold; - color:#0000FF; - margin-top:12 - } +font-family:font-family:times, arial, 'lucida console', sans-serif; +font-size: 110%; +font-style:bold; +color:#0000FF; +margin-top:12 +} h5 { - font-family:font-family:times, arial, 'lucida console', sans-serif; - font-size: 100%; - font-style:bold; - color:#0000FF; - margin-top:10 - } - +font-family:font-family:times, arial, 'lucida console', sans-serif; +font-size: 100%; +font-style:bold; +color:#0000FF; +margin-top:10 +} hr.first {color:#0000FF; height:4px;width:100%;magin-top:10px;margin-bottom:10px;border:thick double blue;} hr.second{color:#0000FF;height:2px; width:100%;magin-top:5px;margin-bottom:5px;border:thin dotted;} - -li{ - margin-top:12; - font-size: 98%; - text-align:left; - } - +li{ margin-top:12; +font-size: 98%; +text-align:left; +} p.right { text-align:right; color:#A52A2A; font-size: 90%;} - p { - font-family:font-family:times, arial, 'lucida console', sans-serif; - font-size: 110%; - text-align:left; - } - +font-family:font-family:times, arial, 'lucida console', sans-serif; +font-size: 110%; +text-align:left; +} p.center {text-align:center} - p.note{ - font-family:font-family:times, arial, 'lucida console', sans-serif; - font-size: 80%; - text-align:left; - color:#FF0000 - } - +font-family:font-family:times, arial, 'lucida console', sans-serif; +font-size: 80%; +text-align:left; +color:#FF0000 +} p.insmes{ - font-family:font-family:times, arial, 'lucida console', sans-serif; - font-size: 80%; - text-align:left; - } - +font-family:font-family:times, arial, 'lucida console', sans-serif; +font-size: 80%; +text-align:left; +} p.filename { - font-family:font-family:times, arial, 'lucida console', sans-serif; - font-size: 100%; - font-style:italic; - text-align:center; +font-family:font-family:times, arial, 'lucida console', sans-serif; +font-size: 100%; +font-style:italic; text-align:center; } - span.filename { - font-family:font-family:times, arial, 'lucida console', sans-serif; - font-size: 95%; - font-style:italic; -} - +font-family:font-family:times, arial, 'lucida console', sans-serif; +font-size: 95%; +font-style:italic; } table { - font-family:font-family:times, arial, 'lucida console', sans-serif; - font-size: 100%; - text-align:left; - border:thin solid blue; - } - +font-family:font-family:times, arial, 'lucida console', sans-serif; +font-size: 100%; +text-align:left; +border:thin solid blue; +} td { - font-family:font-family:times, arial, 'lucida console', sans-serif; - font-size: 85%; - text-align:left; - } - +font-family:font-family:times, arial, 'lucida console', sans-serif; +font-size: 85%; +text-align:left; +} ul.normal { margin-left:10%; list-style-type:none; margin-bottom:15px; } - ul.intable { text-align: left; list-style-type:none; } - -</style> + </style> </head> + <body> -<h1>HDF5 Build and Install Instructions for Windows XP (Full Version)</h1> +<h1>HDF5 Build and Install Instructions for Windows XP (Full +Version)</h1> + <hr class="first"> <p class="note">Notes:</p> -<p class="note">The following instructions assume that the HDF5 source code package from<a href="http://hdf.ncsa.uiuc.edu" target="_blank"> -HDF website (http://hdf.ncsa.uiuc.edu)</a> is used. </p> -<h3 style="COLOR: #a52a2a"><a name="content_table">Table of Contents:</a></h3> -</td> -<table style="border-width:0; border-collapse: collapse"> - <tr> - <td colspan="2"><h3><a href="#preconditions">Preconditions</a></h3></td> - </tr> - <tr> - <td> -<h3><a href="#section1">Section I </a></h3> - </td> - <td> -<h3><a href="#section1"> What do we build and install</a></h3> - </td> - </tr> - <tr> - <td> -<h3><a href="#section2">Section II </a></h3> - </td> - <td> -<h3><a href="#section2"> How to build and test HDF5 libraries and tools</a></h3> - </td> - </tr> - <tr> - <td> -<h3><a href="#section3_examples">Section III </a></h3> - </td> - <td> -<h3><a href="#section3_examples"> How to Build Examples (Optional)</a></h3> - </td> - </tr> - <tr> - <td> -<h3><a href="#section4">Section IV </a></h3> - </td> - <td> -<h3><a href="#section4"> How to build an application using the HDF5 -library or DLL</a></h3> - </td> - </tr> - <tr> - <td> -<h3><a href="#section5">Section V </a></h3> - </td> - <td> -<h3><a href="#section5"> How to disable Gzip(Zlib)/Szip compression </a></h3> - </td> - </tr> - <tr> - <td> -<h3><a href="#section6">Section VI </a></h3> - </td> - <td> -<h3><a href="#section6"> How to build HDF5 in .NET 2003</a></h3> - </td> - </tr> - <tr> - <td> -<h3><a href="#section7">Section VII </a></h3> - </td> - <td> -<h3><a href="#section7"> How to build HDF5 with INTEL Compiler</a></h3> - </td> - </tr> - <tr> - <td> -<h3><a href="#section8">Section VIII</a></h3> - </td> - <td> -<h3><a href="#section8"> How to build Multi-threaded version of HDF5 -library</a></h3> - </td> - </tr> - <tr> - <td> -<h3><a href="#section9">Section IX </a></h3> - </td> - <td> -<h3><a href="#section9"> How to build and test HDF5 snapshot release</a></h3> - </td> - </tr> - <tr> - <td> -<h3><a href="#section10">Section X </a></h3> - </td> - <td> -<h3><a href="#section10"> How to build HDF5 with Thread-Safe Feature</a></h3> - </td> - </tr> - <tr> - <td> -<h3><a href="#section11">Section XI </a></h3> - </td> - <td > -<h3><a href="#section11"> Misc.</a></h3> - </td> - </tr> + +<p class="note">The following instructions assume that the +HDF5 source code package from<a href="http://hdfgroup.org" target="_blank"> HDF website (http://hdfgroup.org)</a> +is used. </p> + +<h3 style="color: rgb(165, 42, 42);"><a name="content_table">Table of Contents:</a></h3> + +<table style="border-width: 0pt; border-collapse: collapse;"> + + <tbody> + + <tr> + + <td colspan="2"> + <h3><a href="#preconditions">Preconditions</a></h3> + + </td> + + </tr> + + <tr> + + <td> + <h3><a href="#section1">Section +I </a></h3> + + </td> + + <td> + <h3><a href="#section1"> What do we +build and install</a></h3> + + </td> + + </tr> + + <tr> + + <td> + <h3><a href="#section2">Section +II </a></h3> + + </td> + + <td> + <h3><a href="#section2"> How to +build and test HDF5 libraries and tools</a></h3> + + </td> + + </tr> + + <tr> + + <td> + <h3><a href="#section3_examples">Section +III </a></h3> + + </td> + + <td> + <h3><a href="#section3_examples"> +How to Build Examples (Optional)</a></h3> + + </td> + + </tr> + + <tr> + + <td> + <h3><a href="#section4">Section IV </a></h3> + + </td> + + <td> + <h3><a href="#section4"> How to +build an application using the HDF5 library or DLL</a></h3> + + </td> + + </tr> + + <tr> + + <td> + <h3><a href="#section5">Section +V </a></h3> + + </td> + + <td> + <h3><a href="#section5"> How to +disable Gzip(Zlib)/Szip compression </a></h3> + + </td> + + </tr> + + <tr> + + <td> + <h3><a href="#section6">Section VI </a></h3> + + </td> + + <td> + <h3><a href="#section6"> How to +build HDF5 in .NET 2003</a></h3> + + </td> + + </tr> + + <tr> + + <td> + <h3><a href="#section7">Section VII </a></h3> + + </td> + + <td> + <h3><a href="#section7"> How to +build HDF5 with INTEL Compiler</a></h3> + + </td> + + </tr> + + <tr> + + <td> + <h3><a href="#section8">Section VIII</a></h3> + + </td> + + <td> + <h3><a href="#section8"> How to +build Multi-threaded version of HDF5 library</a></h3> + + </td> + + </tr> + + <tr> + + <td> + <h3><a href="#section9">Section IX </a></h3> + + </td> + + <td> + <h3><a href="#section9"> How to +build and test HDF5 snapshot release</a></h3> + + </td> + + </tr> + + <tr> + + <td> + <h3><a href="#section10">Section +X </a></h3> + + </td> + + <td> + <h3><a href="#section10"> How to +build +HDF5 with Thread-Safe Feature</a></h3> + + </td> + + </tr> + + <tr> + + <td> + <h3><a href="#section11">Section +XI </a></h3> + + </td> + + <td> + <h3><a href="#section11"> How to +build HDF5 in Visual Studio 2005</a></h3> + + </td> + + </tr> + + <tr> + + <td> + <h3><a href="#section12">Section +XII </a></h3> + + </td> + + <td> + <h3><a href="#section12"> Misc.</a></h3> + + </td> + + </tr> + + </tbody> </table> + <hr class="second"> <h2><a name="preconditions">Preconditions</a> </h2> + <hr class="second"> -<p>Please read CAREFULLY about the following preconditions and notes first.</p> -<h4><u>1. Installed Microsoft Visual C++ 6.0 or Intel C compiler and WinZip.</u></h4> +<p>Please read CAREFULLY about the following preconditions and +notes first.</p> + +<h4><u>1. Installed Microsoft Visual C++ 6.0 or Intel C +compiler and WinZip.</u></h4> + <blockquote> -<p>Installed Compaq Visual Fortran compiler(6.0 or higher version), or Intel Fortran -compiler if you want to build HDF5 Fortran libraries. </p> -<p class="note">Notes:</p> -<p class="note">By default, WinZip will convert the Unix end of line format when extracting .tar -file. This conversion will cause "false" failure in some HDF5 tools testings. Please -uncheck the "TAR file smart CR/LF conversion" option in your WinZip to prevent the -conversion when extracting .tar file. To uncheck the "TAR file smart CR/LF conversion" -option: Invoke WinZip, go to "Options", select "Configuration..." Click the "Miscellaneous" -tab and uncheck "TAR file smart CR/LF conversion" option, then click OK. </p> + <p>Installed Compaq Visual Fortran compiler(6.0 or higher +version), or Intel Fortran compiler if you want to build HDF5 Fortran +libraries. </p> + + <p class="note">Notes:</p> + + <p class="note">By default, WinZip will convert the Unix +end of line format when extracting .tar file. This conversion will +cause "false" failure in some HDF5 tools testings. Please uncheck the +"TAR file smart CR/LF conversion" option in your WinZip to prevent the +conversion when extracting .tar file. To uncheck the "TAR file smart +CR/LF conversion" option: Invoke WinZip, go to "Options", select +"Configuration..." Click the "Miscellaneous" tab and uncheck "TAR file +smart CR/LF conversion" option, then click OK. </p> + </blockquote> -<h4><u>2. Set up a directory structure to unpack the library.</u></h4> + +<h4><u>2. Set up a directory structure to unpack the +library.</u></h4> + <p>For example:</p> -<table style="border-collapse: collapse; border-width: 0" bordercolor="#111111" cellpadding="0" cellspacing="0"> -<tr> -<td><p class="filename" style="text-align: left">c:\ (any drive)</p></td> -</tr> -<tr> -<td> -<p class="filename" style="text-align: left">MyHDFstuff\ (any folder name)</p> -</td> -</tr> +<table style="border-width: 0pt; border-collapse: collapse;" bordercolor="#111111" cellpadding="0" cellspacing="0"> + + <tbody> + + <tr> + + <td> + <p class="filename" style="text-align: left;">c:\ +(any drive)</p> + + </td> + + </tr> + + <tr> + + <td> + <p class="filename" style="text-align: left;">MyHDFstuff\ +(any folder name)</p> + + </td> + + </tr> + + </tbody> </table> + <h4> </h4> -<h4><u>3. Download the hdf5-1.8.x source code package </u> </h4> -<p>Use WinZip to extract the HDF5 package into <span class="filename">c:\MyHDFstuff</span>. -This creates a directory called 'hdf5-1.8.x' under <span class="filename">MyHDFstuff</span> -which contains several files and directories. Rename <span class="filename">"hdf5-1.8.x"</span> -to<span class="filename"> "hdf5"</span>. </p> -<h4><u>4. HDF5 provide options to do in-memory compress within HDF5 library.</u></h4> -<p>Currently, two external compression libraries Zlib and Szip can be used with -HDF5. </p> +<h4><u>3. Download the hdf5-1.8.x source code package </u> +</h4> + +<p>Use WinZip to extract the HDF5 package into <span class="filename">c:\MyHDFstuff</span>. This creates a +directory called 'hdf5-1.8.x' under <span class="filename">MyHDFstuff</span> +which contains several files and directories. Rename <span class="filename">"hdf5-1.8.x"</span> to<span class="filename"> "hdf5"</span>. </p> + +<h4><u>4. HDF5 provide options to do in-memory compress +within HDF5 library.</u></h4> + +<p>Currently, two external compression libraries Zlib and Szip +can be used with HDF5. </p> + <ul class="intable"> + <li> - <p>1. HDF5 uses Zlib version 1.2.2 for compression and Zlib is NOT distributed - with HDF5 library in 1.8.x release. To use Zlib library, you have to install your - own Zlib DLL library or go to - <a href="ftp://hdf.ncsa.uiuc.edu/lib-external/zlib/1.2/bin" target="_blank">ftp://hdf.ncsa.uiuc.edu/lib-external/zlib/1.2/bin - </a>to download the Zlib library.</p> - <p class="note">Notes:</p> - <p class="note">1. Zlib 1.2.2 DLL library can also be downloaded from <a href="http://www.zlib.net/zlib122-dll.zip" target="_blank">http://www.zlib.net/zlib122-dll.zip - </a></p> + <p>1. HDF5 uses Zlib version 1.2.2 for compression and Zlib +is NOT distributed with HDF5 library in 1.8.x release. To use Zlib +library, you have to install your own Zlib DLL library or go to <a href="ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/" target="_blank">ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/ + </a>to download the Zlib library.</p> + + <p class="note">Notes:</p> + + <p class="note">1. Zlib 1.2.2 DLL library can also be +downloaded from <a href="ftp://ftp.hdfgroup.org/lib-external/zlib/1.2/bin" target="_blank">ftp://ftp.hdfgroup.org/lib-external/zlib/1.2/bin + </a></p> + </li> + <li> - <p class="note">2. HDF5 uses Szip version 2.0 for compression and Szip compression software - is provided with HDF5 products in 1.8.0 release. To use Szip 2.0 library, you - can download Szip source codes and binaries from - <a href="ftp://hdf.ncsa.uiuc.edu/lib-external/szip/2.0/bin/windows" target="_blank"> - ftp://hdf.ncsa.uiuc.edu/lib-external/szip/2.0/bin/windows </a></p> - <p class="note">3. Please note that Szip is not a totally open-source free software. For licensing - issue of Szip, please check "Licensing terms" at - <a href="http://hdf.ncsa.uiuc.edu/doc_resource/SZIP/index.html" target="_blank"> - http://hdf.ncsa.uiuc.edu/doc_resource/SZIP/index.html.</a> </p> - <p class="note">Szip compression feature inside HDF5 is optional.</p> + <p class="note">2. HDF5 uses Szip version 2.0 for +compression and Szip compression software is provided with HDF5 +products in 1.8.0 release. To use Szip 2.0 library, you can download +Szip source codes and binaries from <a href="ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/" target="_blank"> +ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/ </a></p> + + <p class="note">3. Please note that Szip is not a +totally open-source free software. For licensing issue of Szip, please +check "Licensing terms" at <a href="http://hdfgroup.org/doc_resource/SZIP/index.html" target="_blank"> +http://hdfgroup.org/doc_resource/SZIP/index.html.</a> </p> + + <p class="note">Szip compression feature inside HDF5 +is optional.</p> + </li> + </ul> -<h4><u>5. Define the following environment variables: </u> </h4> + +<h4><u>5. Define the following environment variables: </u> +</h4> + <ul class="normal"> + <li>HDF5_EXT_ZLIB </li> + <li>HDF5_EXT_SZIP</li> + </ul> -<p>In this section, Zlib and Szip compression packages are assumed to be used. Please -read <a href="#section5">Section V</a> as well as this section if -you do not want to use compression feature inside HDF5. </p> + +<p>In this section, Zlib and Szip compression packages are +assumed to be used. Please read <a href="#section5">Section +V</a> as well as this section if you do not want to use +compression feature inside HDF5. </p> + <p>To define these environment variables:</p> -<p>Click <span class="filename">"Start"</span> -> <span class="filename">"Control -Panel"</span> -> <span class="filename">"System"</span> -> <span class="filename">"Advanced"</span> --> <span class="filename">"Environment -Variables"</span>. If you are logged on as administrator to the local computer AND -want to let all other users use these two environment variables, click -<span class="filename">"New"</span> under <span class="filename">"System Variables"</span> -box; otherwise, click <span class="filename">"New"</span> under -<span class="filename">"User Variables"</span> box. In the New Variable window, -set </p> -<p> <span class="filename">"Variable name"</span> as <span class="filename">HDF5_EXT_ZLIB</span> </p> -<p> <span class="filename">"Variable value"</span> as <span class="filename">zdll.lib</span>, -then click OK. </p> + +<p>Click <span class="filename">"Start"</span> +-> <span class="filename">"Control Panel"</span> +-> <span class="filename">"System"</span> +-> <span class="filename">"Advanced"</span> +-> <span class="filename">"Environment Variables"</span>. +If you are logged on as administrator to the local computer AND want to +let all other users use these two environment variables, click +<span class="filename">"New"</span> under <span class="filename">"System Variables"</span> box; +otherwise, click <span class="filename">"New"</span> +under +<span class="filename">"User Variables"</span> box. +In the New Variable window, set </p> + +<p> <span class="filename">"Variable name"</span> +as <span class="filename">HDF5_EXT_ZLIB</span> </p> + +<p> <span class="filename">"Variable value"</span> +as <span class="filename">zdll.lib</span>, then +click OK. </p> + <p>Similarly, you can set:</p> -<p><span class="filename">HDF5_EXT_SZIP</span> environment variable as + +<p><span class="filename">HDF5_EXT_SZIP</span> +environment variable as <span class="filename">szlibdll.lib</span></p> + <p class="note">Notes:</p> + <ul class="intable"> + <li> - <p class="note">a. You might have to close and reopen running programs for the new environment - variable settings to take effect. </p> + <p class="note">a. You might have to close and reopen +running programs for the new environment variable settings to take +effect. </p> + </li> + <li> - <p class="note">b. <span class="filename">c:\zlib122\zlib1.dll </span>and - <span class="filename">c:\szip\dll\szlibdll.dll</span> should be copied into the - location that the application can find, one suggestion is to use the - <span class="filename">c:\WINDOWS\system</span>. </p> + <p class="note">b. <span class="filename">c:\zlib122\zlib1.dll + </span>and <span class="filename">c:\szip\dll\szlibdll.dll</span> +should be copied into the location that the application can find, one +suggestion is to use the <span class="filename">c:\WINDOWS\system</span>. + </p> + </li> + </ul> -<h4><a name="precondition6"><u>6. Set up path for external libraries and headers</u></a></h4> -<p>Skip this part if you don't want to use ANY compression features provided by -HDF5. Please do read <a href="#section5">Section V</a>.</p> -<p>You have to read this part even if you want to only use Zlib or Szip. You also -need to read <a href="#section5">Section V</a>. </p> -<p>Invoke Microsoft Visual C++ and go to "Tools" and select "Options", find "Directories"; + +<h4><a name="precondition6"><u>6. Set up path +for external libraries and headers</u></a></h4> + +<p>Skip this part if you don't want to use ANY compression +features provided by HDF5. Please do read <a href="#section5">Section +V</a>.</p> + +<p>You have to read this part even if you want to only use Zlib +or Szip. You also need to read <a href="#section5">Section +V</a>. </p> + +<p>Invoke Microsoft Visual C++ and go to "Tools" and select +"Options", find "Directories"; </p> + <ul class="intable"> + <li> - <p>1. Find the box <span class="filename">"Show directories for"</span>, choose - <span class="filename">"Include files"</span>, if you can not find your Zlib and - Szip header path (for example, <span class="filename">c:\zlib122\include, c:\szip\include</span>) - from the directory list, add the header path (<span class="filename">c:\zlib122\include, - c:\szip\include</span>) to the included directories. </p> + <p>1. Find the box <span class="filename">"Show +directories for"</span>, choose <span class="filename">"Include +files"</span>, if you can not find your Zlib and Szip header path +(for example, <span class="filename">c:\zlib122\include, +c:\szip\include</span>) from the directory list, add the header +path (<span class="filename">c:\zlib122\include, +c:\szip\include</span>) to the included directories. </p> + </li> + <li> - <p>2. Find the box <span class="filename">"Show directories for"</span>, choose - <span class="filename">"Library files"</span>, If you cannot find your Zlib and - Szip library path (for example, <span class="filename">c:\zlib122\lib, c:\szip\dll</span>) - from the directory list, add the library path (<span class="filename">c:\zlib122\lib, - c:\szip\dll</span>) to the library directories. </p> + <p>2. Find the box <span class="filename">"Show +directories for"</span>, choose <span class="filename">"Library +files"</span>, If you cannot find your Zlib and Szip library path +(for example, <span class="filename">c:\zlib122\lib, +c:\szip\dll</span>) from the directory list, add the library path +(<span class="filename">c:\zlib122\lib, c:\szip\dll</span>) +to the library directories. </p> + </li> + </ul> + <p class="note">Notes:</p> + <ul class="intable"> + + <li> + <p class="note">1. In release 1.8.0, <span class="filename">all.zip</span> is deprecated. Users +should go to <span class="filename">hdf5/windows</span> +directory, run <span class="filename">copy_hdf.bat</span> +first and then open <span class="filename">all.dsw</span> +under <span class="filename">hdf5/windows/proj/all</span> +to start building process. </p> + + </li> + + <li> + <p class="note">2. In release 1.8.0, all.sln was +provided for command line use ONLY. all.sln should never be opened to +start building HDF5 using IDE.</p> + + </li> + + <li> + <p class="note">3. To build HDF5 C++ and FORTRAN +libraries, please read through this document. </p> + + </li> + <li> - <p class="note">1. In release 1.8.0, <span class="filename">all.zip</span> is deprecated. Users - should go to <span class="filename">hdf5/windows</span> directory, run - <span class="filename">copy_hdf.bat</span> first and then open - <span class="filename">all.dsw</span> under <span class="filename">hdf5/windows/proj/all</span> - to start building process. </p> + <p class="note">4. For users who want to quickly build +HDF5 library or do not want to know HDF5 building and installation +details, please read <span class="filename">INSATLL_Windows_Short.txt. + </span></p> + </li> + <li> - <p class="note">2. To build HDF5 C++ and FORTRAN libraries, please read through this document. - </p> + <p class="note">5. For users who would like to build +and test HDF5 package from the command line, please read <span class="filename">INSATLL_Windows_From_Command_Line.txt. </span></p> + </li> + <li> - <p class="note">3. For users who want to quickly build HDF5 library or do not want to know - HDF5 building and installation details, please read <span class="filename">INSATLL_Windows_Short.txt. - </span></p> + <p class="note">6. HDF4-related tools are not built +and released with HDF5 library packages any more . To obtain +HDF4-releated tools, please check</p> + + <p class="note"><a href="http://hdfgroup.org/h4toh5/" target="blank" ,="">http://hdfgroup.org/h4toh5/</a></p> + + <p class="note"><a href="ftp://ftp.hdfgroup.org/HDF5/h4toh5" target="blank" ,="">ftp://ftp.hdfgroup.org/HDF5/h4toh5</a> </p> + </li> + <li> - <p class="note">4. For users who would like to build and test HDF5 package from the command - line, please read <span class="filename">INSATLL_Windows_From_Command_Line.txt. - </span></p> + <p class="note">7. For DLL users, please do read and +follow <a href="#dll_hints_section4">"DLL Hints" Section +IV.</a> </p> + </li> + <li> - <p class="note">5. HDF4-related tools are not built and released with HDF5 library packages - any more . To obtain HDF4-releated tools, please check</p> - <p class="note"><a href="http://hdf.ncsa.uiuc.edu/h4toh5/" target="blank" ,>http://hdf.ncsa.uiuc.edu/h4toh5/</a></p> - <p class="note"><a href="ftp://hdf.ncsa.uiuc.edu/HDF5/h4toh5/" target="blank" ,>ftp://hdf.ncsa.uiuc.edu/HDF5/h4toh5/</a> - </p> + <p class="note">8. For .NET users, please read <a href="#section6">Section VI.</a> </p> + </li> + <li> - <p class="note">6. For DLL users, please do read and follow - <a href="#dll_hints_section4">"DLL Hints" Section IV.</a> </p> + <p class="note">9. For Intel Compiler users, Intel +7.x +works with MSVS 6.0 and Intel 8.1 only works with MSVS .net 2003 when +you build HDF5-1.8.x. </p> + </li> + <li> - <p class="note">7. For .NET users, please read <a href="#section6">Section - VI.</a> </p> + <p class="note">10. For users who would like to build +Muti-threaded version of HDF5 library, please read <a href="section8">Section VIII</a>.</p> + </li> + <li> - <p class="note">8. For users who would like to build, test and use HDF5 snapshot release, please - read <a href="#section8">Section VIII.</a> </p> + <p class="note">11. For users who would like to build, +test and use HDF5 snapshot release, please read <a href="#section9">Section +IX.</a> </p> + </li> + <li> - <p class="note">9. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and Intel 8.1 only - works with MSVS .net 2003 when you build HDF5-1.8.x. </p> + <p class="note">12. For .Net and Intel users, if you +are not building HDF5 with Thread-Safe Feature (see <a href="#section10">Section X</a>), ttsafedll.dsp should +always be turned off.</p> + </li> - <li><p class="note">10. For .Net and Intel users, if you are not in - <a href="#section10">Section X How to build HDF5 with Thread-Safe Feature</a>, - ttsafedll.dsp should be turned off always.</p> </li> + </ul> -<p class="right"><a href="#preconditions">Go to TOP Preconditions</a></p> -<p class="right"><a href="#content_table">Go to Table of Contents</a></p> + +<p class="right"><a href="#preconditions">Go +to TOP Preconditions</a></p> + +<p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + <hr class="second"> -<h2><a name="section1">Section I: What do we build and install? </a></h2> +<h2><a name="section1">Section I: What do we build +and install? </a></h2> + <hr class="second"> <ul class="intable"> + <li> - <h4>1. Build and Install</h4> - <ul class="normal"> - <li> - <p>HDF5 Static Library: debug and release version</p> - </li> - <li> - <p>HDF5 Dynamic Link Library(DLL): debug and release version as well as export - libraries for DLL</p> - </li> - <li> - <p>HDF5 High-Level Library (Optional):HDF5 C++ Library and HDF5 HL-Fortran Library</p> - </li> - <li> - <p>HDF5 Tools: HDF5 tools </p> - </li> - </ul> + <h4>1. Build and Install</h4> + + <ul class="normal"> + + <li> + <p>HDF5 Static Library: debug and release version</p> + + </li> + + <li> + <p>HDF5 Dynamic Link Library(DLL): debug and release +version as well as export libraries for DLL</p> + + </li> + + <li> + <p>HDF5 High-Level Library (Optional):HDF5 C++ Library +and HDF5 HL-Fortran Library</p> + + </li> + + <li> + <p>HDF5 Tools: HDF5 tools </p> + + </li> + + </ul> + </li> + <li> - <h4>2. Build Only (Not included in the binary distribution)</h4> - <ul class="normal"> - <li> - <p>HDF5 tool library: debug and release version</p> - </li> - <li> - <p>HDF5 tool export library for DLL: debug and release version</p> - </li> - <li> - <p>HDF5 library testing programs: HDF5 library comprehensive tests</p> - </li> - <li> - <p>HDF5 related tools testing programs: HDF5 tools comprehensive tests</p> - </li> - </ul> + <h4>2. Build Only (Not included in the binary distribution)</h4> + + <ul class="normal"> + + <li> + <p>HDF5 tool library: debug and release version</p> + + </li> + + <li> + <p>HDF5 tool export library for DLL: debug and release +version</p> + + </li> + + <li> + <p>HDF5 library testing programs: HDF5 library +comprehensive tests</p> + + </li> + + <li> + <p>HDF5 related tools testing programs: HDF5 tools +comprehensive tests</p> + + </li> + + </ul> + </li> + <li> - <h4>3. Examples (Not included in the binary distribution)</h4> - <ul class="normal"> - <li> - <p>HDF5 examples: simple HDF5 C/C++/Fortran and high level C examples</p> - </li> - </ul> + <h4>3. Examples (Not included in the binary distribution)</h4> + + <ul class="normal"> + + <li> + <p>HDF5 examples: simple HDF5 C/C++/Fortran and high +level C examples</p> + + </li> + + </ul> + </li> + </ul> -<p class="right"><a href="#content_table">Go to Table of Contents</a></p> + +<p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + <hr class="second"> -<h2><a name="section2">Section II: How to build and test HDF5 libraries and tools +<h2><a name="section2">Section II: How to build and +test HDF5 libraries and tools </a></h2> + <hr class="second"> <h3>This section includes:</h3> -<p><a href="##step1_section2">STEP 1: Building HDF5 libraries and tools</a></p> -<p><a href="#step2_section2">STEP 2: Testing HDF5 libraries and tools</a></p> -<p><a href="#step3_section2">STEP 3: Installing HDF5 Libraries</a></p> + +<p><a href="##step1_section2">STEP 1: Building HDF5 +libraries and tools</a></p> + +<p><a href="#step2_section2">STEP 2: Testing HDF5 +libraries and tools</a></p> + +<p><a href="#step3_section2">STEP 3: Installing HDF5 +Libraries</a></p> + <p> </p> -<h3><a name="#step1_section2"><u>STEP 1: Building HDF5 libraries and tools</u></a></h3> + +<h3><a name="#step1_section2"><u>STEP 1: +Building HDF5 libraries and tools</u></a></h3> + <ul class="intable"> + <li> - <h4>1. Run batch file copy_hdf.bat.</h4> - <p>Go to <span class="filename">c:\MyHDFstuff\hdf5\windows</span> and run - <span class="filename">copy_hdf.bat</span>. This process will copy all the necessary - batch files, windows specific source codes and text files saved under - <span class="filename">c:\MyHDFstuff\hdf5\windows</span> directory to the corresponding - directories under <span class="filename">hdf5</span>. </p> + <h4>1. Run batch file copy_hdf.bat.</h4> + + <p>Go to <span class="filename">c:\MyHDFstuff\hdf5\windows</span> +and run <span class="filename">copy_hdf.bat</span>. +This process will copy all the necessary batch files, windows specific +source codes and text files saved under <span class="filename">c:\MyHDFstuff\hdf5\windows</span> +directory to the corresponding directories under <span class="filename">hdf5</span>. </p> + </li> + <li> - <h4><a name="step1_2_section2">2. Invoke Microsoft Visual C++ compiler</a></h4> - <p>Invoke Microsoft Visual C++. From the main menu, go to - <span class="filename">"File" </span>and select the <span class="filename">"Open - Workspace" </span>option. Then open the <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw</span> - workspace. </p> - <p>You should find windows project files listed as "all files, big files etc." - on the left. </p> + <h4><a name="step1_2_section2">2. Invoke +Microsoft Visual C++ compiler</a></h4> + + <p>Invoke Microsoft Visual C++. From the main menu, go to <span class="filename">"File" </span>and select the <span class="filename">"Open Workspace" </span>option. Then +open the <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw</span> +workspace. </p> + + <p>You should find windows project files listed as "all +files, big files etc." on the left. </p> + </li> + <li> - <h4>3. (Optional)HDF5 C++, Fortran libraries, HL-CPP, HL-Fortran and Intel compiler</h4> - <ul class="intable"> - <li> - <h5><a name="section1_3.1">3.1 Skip this step if you do not want to build HDF5 - C++ libraries</a></h5> - <p>Go to <span class="filename">"Project"</span> and select - <span class="filename">"dependencies"</span>; Select <span class="filename"> - "all"</span> in the <span class="filename">"Select project to modify:"</span> - box, then enable the desired projects: </p> - <ul class="normal"> - <li>dsets_cpp </li> - <li>dsets_cppdll </li> - <li>hdf5_cpp </li> - <li>hdf5_cppdll </li> - <li>testhdf5_cpp </li> - <li>testhdf5_cppdll</li> - </ul> - </li> - <li> - <h5><a name="section1_3.2">3.2 Skip this step if you do not want to build HDF5 - Fortran libraries</a></h5> - <p>Go to <span class="filename">"Project"</span> and select - <span class="filename">"dependencies"</span>; Select <span class="filename"> - "all"</span> in the <span class="filename">"Select project to modify:"</span> - box, then enable the desired projects: </p> - <ul class="normal"> - <li>flush1_fortran </li> - <li>flush1_fortrandll </li> - <li>flush2_fortran </li> - <li>flush2_fortrandll </li> - <li>hdf5_f90cstub </li> - <li>hdf5_f90cstubdll </li> - <li>hdf5_fortran </li> - <li>hdf5_fortrandll </li> - <li>libtest_cstubdll </li> - <li>libtest_fortran </li> - <li>libtest_fortrandll </li> - <li>testhdf5_fortran </li> - <li>testhdf5_fortrandll</li> - </ul> - </li> - <li> - <h5>3.3 Skip this step if you do not want to build HDF5 High-Level libraries</h5> - <p>Go to <span class="filename">"Project"</span> and select - <span class="filename">"dependencies"</span>; Select <span class="filename"> - "all"</span> in the <span class="filename">"Select project to modify:"</span> - box, then enable the desired projects: </p> - <ul class="normal"> - <li>hdf5_hl </li> - <li>hdf5_hldll </li> - <li>hl_test_image </li> - <li>hl_test_imagedll </li> - <li>hl_test_lite </li> - <li>hl_test_litedll </li> - <li>hl_test_table </li> - <li>hl_test_tabledll </li> - <li>hl_test_ds </li> - <li>hl_test_dsdll </li> - <li>hl_test_packet</li> - <li>hl_test_packetdll</li> - </ul> - </li> - <li> - <h5>3.4 Skip this step if you do not want to build HDF5 High-Level C++ libraries</h5> - <p>Go to <span class="filename">"Project"</span> and select - <span class="filename">"dependencies"</span>; Select <span class="filename"> - "all"</span> in the <span class="filename">"Select project to modify:"</span> - box, then enable all of the project files listed in - <a href="#section1_3.1">Section II, Step 1(3.1)</a> and the - following desired projects: </p> - <ul class="normal"> - <li>hdf5_hl_cpp </li> - <li>hdf5_hl_cppdll </li> - <li>hl_test_table_cpp</li> - <li>hl_test_table_cppdll</li> - </ul> - </li> - <li> - <h5>3.5 Skip this step if you do not want to build HDF5 High-Level Fortran libraries</h5> - <p>Go to <span class="filename">"Project"</span> and select - <span class="filename">"dependencies"</span>; Select <span class="filename"> - "all"</span> in the <span class="filename">"Select project to modify:"</span> - box, then enable all of the project files listed in - <a href="#section1_3.2">Section II, Step 1(3.2)</a> and the - following desired projects: </p> - <ul class="normal"> - <li>hdf5_hl_f90cstubdll </li> - <li>hdf5_hl_fortran </li> - <li>hdf5_hl_fortrandll </li> - <li>hl_test_image_fortran </li> - <li>hl_test_image_fortrandll </li> - <li>hl_test_lite_fortran </li> - <li>hl_test_lite_fortrandll </li> - <li>hl_test_table_fortran </li> - <li>hl_test_table_fortrandll</li> + <h4>3. (Optional)HDF5 C++, Fortran libraries, High level C++, +High level Fortran and Intel compiler</h4> + + <ul class="intable"> + + <li> + <h5><a name="section1_3.1">3.1 Skip this +step if you do not want to build HDF5 C++ libraries</a></h5> + + <p>Go to <span class="filename">"Project"</span> +and select <span class="filename">"dependencies"</span>; +Select <span class="filename"> "all"</span> in the <span class="filename">"Select project to modify:"</span> +box, then enable the desired projects: </p> + + <ul class="normal"> + + <li>dsets_cpp </li> + + <li>dsets_cppdll </li> + + <li>hdf5_cpp </li> + + <li>hdf5_cppdll </li> + + <li>testhdf5_cpp </li> + + <li>testhdf5_cppdll</li> + + </ul> + + </li> + + <li> + <h5><a name="section1_3.2">3.2 Skip this +step if you do not want to build HDF5 Fortran libraries</a></h5> + + <p>Go to <span class="filename">"Project"</span> +and select <span class="filename">"dependencies"</span>; +Select <span class="filename"> "all"</span> in the <span class="filename">"Select project to modify:"</span> +box, then enable the desired projects: </p> + + <ul class="normal"> + + <li>flush1_fortran </li> + + <li>flush1_fortrandll </li> + + <li>flush2_fortran </li> + + <li>flush2_fortrandll </li> + + <li>hdf5_f90cstub </li> + + <li>hdf5_f90cstubdll </li> + + <li>hdf5_fortran </li> + + <li>hdf5_fortrandll </li> + + <li>libtest_cstubdll </li> + + <li>libtest_fortran </li> + + <li>libtest_fortrandll </li> + + <li>testhdf5_fortran </li> + + <li>testhdf5_fortrandll</li> + + </ul> + + </li> + + <li> + <h5>3.3 Skip this step if you do not want to build HDF5 +High-Level libraries</h5> + + <p>Go to <span class="filename">"Project"</span> +and select <span class="filename">"dependencies"</span>; +Select <span class="filename"> "all"</span> in the <span class="filename">"Select project to modify:"</span> +box, then enable the desired projects: </p> + + <ul class="normal"> + + <li>hdf5_hl </li> + + <li>hdf5_hldll </li> + + <li>hl_test_image </li> + + <li>hl_test_imagedll </li> + + <li>hl_test_lite </li> + + <li>hl_test_litedll </li> + + <li>hl_test_table </li> + + <li>hl_test_tabledll </li> + + <li>hl_test_ds </li> + + <li>hl_test_dsdll </li> + + <li>hl_test_packet</li> + + <li>hl_test_packetdll</li> + + </ul> + + </li> + + <li> + <h5>3.4 Skip this step if you do not want to build HDF5 +High-Level C++ libraries</h5> + + <p>Go to <span class="filename">"Project"</span> +and select <span class="filename">"dependencies"</span>; +Select <span class="filename"> "all"</span> in the <span class="filename">"Select project to modify:"</span> +box, then enable all of the project files listed in <a href="#section1_3.1">Section II, Step 1(3.1)</a> and +the following desired projects: </p> + + <ul class="normal"> + + <li>hdf5_hl_cpp </li> + + <li>hdf5_hl_cppdll </li> + + <li>hl_test_table_cpp</li> + + <li>hl_test_table_cppdll</li> + + </ul> + + </li> + + <li> + <h5>3.5 Skip this step if you do not want to build HDF5 +High-Level Fortran libraries</h5> + + <p>Go to <span class="filename">"Project"</span> +and select <span class="filename">"dependencies"</span>; +Select <span class="filename"> "all"</span> in the <span class="filename">"Select project to modify:"</span> +box, then enable all of the project files listed in <a href="#section1_3.2">Section II, Step 1(3.2)</a> and +the following desired projects: </p> + + <ul class="normal"> + + <li>hdf5_hl_f90cstubdll </li> + + <li>hdf5_hl_fortran </li> + + <li>hdf5_hl_fortrandll </li> + + <li>hl_test_image_fortran </li> + + <li>hl_test_image_fortrandll </li> + + <li>hl_test_lite_fortran </li> + + <li>hl_test_lite_fortrandll </li> + + <li>hl_test_table_fortran </li> + + <li>hl_test_table_fortrandll</li> + + </ul> + + </li> + + <li> + <h5>3.6 If you are using Intel compilers, please read <a href="#section7">Section VII.</a></h5> + + </li> + </ul> - </li> - <li> - <h5>3.6 If you are using Intel compilers, please read - <a href="#section7">Section VII.</a></h5> - </li> - </ul> + </li> + <li> - <h4><a name="step1_4_section2">4. Select "Build", then Select "Set Active Configuration".</a></h4> - <ul class="intable"> - <li> - <h5>4.1 To build debug versions of single-threaded static libraries, Debug multithreaded - DLLs and tests</h5> - <p>In <span class="filename">"Project configurations"</span>, select - <span class="filename">"all -- Win32 Debug"</span>, select - <span class="filename">"ok"</span>. Select <span class="filename">"Build" -> - "Build" or "Rebuild All"</span> to build debug version of project - <span class="filename">"all"</span>. </p> - </li> - <li> - <h5>4.2 To build release versions of single-threaded static libraries, multithreaded - DLLs and tests</h5> - <p>In <span class="filename">"Project configurations"</span>, select - <span class="filename">"all -- Win32 Release"</span>, select - <span class="filename">"ok"</span>. Select <span class="filename">"Build" -> - "Build" or "Rebuild All"</span> to build release version of project - <span class="filename">"all"</span>. </p> - <ol> - </ol> - <p class="note">Notes:</p> - <p class="note">1. Both debug and release versions must be built.</p> - <p class="note">2. Warning messages can be ignored. </p> - </li> - </ul> - <p>When the debug or release build is done the directories listed below will contain - the following files:</p> - <div style="TEXT-ALIGN: center"> - <table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"> - <tr> - <th>Location</th> - <th>File Name</th> - <th>Illustration</th> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5\debug</td> - <td>hdf5d.lib</td> - <td>the hdf5 static library</td> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5\release</td> - <td>hdf5.lib</td> - <td>the hdf5 static library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5dll\debug</td> - <td>hdf5ddll.dll</td> - <td>DLL</td> - </tr> - <tr> - <td>hdf5ddll.lib</td> - <td>the DLL export library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5dll\release</td> - <td>hdf5dll.dll</td> - <td>DLL</td> - </tr> - <tr> - <td>hdf5dll.lib</td> - <td>the DLL export library</td> - </tr> - <tr> - <td> - c:\MyHDFstuff\hdf5\test\libtest\debug - c:\MyHDFstuff\hdf5\test\libtest\release - </td> - <td>libtest.lib</td> - <td>the internal library for test</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\test\libtestD\debug</td> - <td>libtestD.dll</td> - <td>the internal DLL for test</td> - </tr> - <tr> - <td>libtestD.lib</td> - <td>the internal DLL export library for test</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\test\libtestD\release</td> - <td>libtestD.dll</td> - <td>the internal DLL for test</td> - </tr> - <tr> - <td>libtestD.lib</td> - <td>the internal DLL export library for test</td> - </tr> - <tr> - <td> - c:\MyHDFstuff\hdf5\tools\toolslib\debug - c:\MyHDFstuff\hdf5\tools\toolslib\release - </td> - <td>toolslib.lib</td> - <td>the internal tools library</td> - </tr> - <tr> - <td rowspan="2"> - c:\MyHDFstuff\hdf5\tools\toolslibD\debug - c:\MyHDFstuff\hdf5\tools\toolslibD\release - </td> - <td>toolslibD.dll</td> - <td>DLL</td> - </tr> - <tr> - <td>toolslibD.lib</td> - <td>the internal DLL export library for tools</td> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\tools\"tools directory"</td> - <td> </td> - <td>where tools are located</td> - </tr> + <h4><a name="step1_4_section2">4. Select +"Build", then Select "Set Active Configuration".</a></h4> + + <ul class="intable"> + + <li> + <h5>4.1 To build debug versions of single-threaded static +libraries, Debug multithreaded DLLs and tests</h5> + + <p>In <span class="filename">"Project +configurations"</span>, select <span class="filename">"all +-- Win32 Debug"</span>, select <span class="filename">"ok"</span>. +Select <span class="filename">"Build" -> "Build" +or "Rebuild All"</span> to build debug version of project <span class="filename">"all"</span>. </p> + + </li> + + <li> + <h5>4.2 To build release versions of single-threaded +static libraries, multithreaded DLLs and tests</h5> + + <p>In <span class="filename">"Project +configurations"</span>, select <span class="filename">"all +-- Win32 Release"</span>, select <span class="filename">"ok"</span>. +Select <span class="filename">"Build" -> "Build" +or "Rebuild All"</span> to build release version of project <span class="filename">"all"</span>. </p> + + <ol> + + </ol> + + <p class="note">Notes:</p> + + <p class="note">1. Both debug and release versions +must be built.</p> + + <p class="note">2. Warning messages can be +ignored. </p> + + </li> + + </ul> + + <p>When the debug or release build is done the directories +listed below will contain the following files:</p> + + <div style="text-align: center;"> + <table style="border: thin solid blue;" border="1"> + + <tbody> + + <tr> + + <th>Location</th> + + <th>File Name</th> + + <th>Illustration</th> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5\debug</td> + + <td>hdf5d.lib</td> + + <td>the hdf5 static library</td> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5\release</td> + + <td>hdf5.lib</td> + + <td>the hdf5 static library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5dll\debug</td> + + <td>hdf5ddll.dll</td> + + <td>DLL</td> + + </tr> + + <tr> + + <td>hdf5ddll.lib</td> + + <td>the DLL export library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5dll\release</td> + + <td>hdf5dll.dll</td> + + <td>DLL</td> + + </tr> + + <tr> + + <td>hdf5dll.lib</td> + + <td>the DLL export library</td> + + </tr> + + <tr> + + <td> c:\MyHDFstuff\hdf5\test\libtest\debug +c:\MyHDFstuff\hdf5\test\libtest\release </td> + + <td>libtest.lib</td> + + <td>the internal library for test</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\test\libtestD\debug</td> + + <td>libtestD.dll</td> + + <td>the internal DLL for test</td> + + </tr> + + <tr> + + <td>libtestD.lib</td> + + <td>the internal DLL export library for test</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\test\libtestD\release</td> + + <td>libtestD.dll</td> + + <td>the internal DLL for test</td> + + </tr> + + <tr> + + <td>libtestD.lib</td> + + <td>the internal DLL export library for test</td> + + </tr> + + <tr> + + <td> c:\MyHDFstuff\hdf5\tools\toolslib\debug +c:\MyHDFstuff\hdf5\tools\toolslib\release </td> + + <td>toolslib.lib</td> + + <td>the internal tools library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\tools\toolslibD\debug +c:\MyHDFstuff\hdf5\tools\toolslibD\release </td> + + <td>toolslibD.dll</td> + + <td>DLL</td> + + </tr> + + <tr> + + <td>toolslibD.lib</td> + + <td>the internal DLL export library for tools</td> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\tools\"tools directory"</td> + + <td> </td> + + <td>where tools are located</td> + + </tr> + + </tbody> </table> - </div> - <p>The directories listed below will contain the following files ONLY when you - choose to build HDF5 C++ libraries:</p> - <div style="TEXT-ALIGN: center"> - <table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"> - <tr> - <th>Location</th> - <th>File Name</th> - <th>Illustration</th> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5_cpp\debug</td> - <td>hdf5_cppd.lib</td> - <td>the HDF5 C++ API static library</td> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5_cpp\release</td> - <td>hdf5_cpp.lib</td> - <td>the HDF5 C++ API static library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_cppdll\debug</td> - <td>hdf5_cppddll.dll</td> - <td>the HDF5 C++ API DLL</td> - </tr> - <tr> - <td>hdf5_cppddll.lib</td> - <td>the C++ API DLL export library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_cppdll\release</td> - <td>hdf5_cppdll.dll</td> - <td>the HDF5 C++ API DLL</td> - </tr> - <tr> - <td>hdf5_cppdll.lib</td> - <td>the C++ API DLL export library</td> - </tr> + + </div> + + <p>The directories listed below will contain the following +files ONLY when you choose to build HDF5 C++ libraries:</p> + + <div style="text-align: center;"> + <table style="border: thin solid blue;" border="1"> + + <tbody> + + <tr> + + <th>Location</th> + + <th>File Name</th> + + <th>Illustration</th> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5_cpp\debug</td> + + <td>hdf5_cppd.lib</td> + + <td>the HDF5 C++ API static library</td> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5_cpp\release</td> + + <td>hdf5_cpp.lib</td> + + <td>the HDF5 C++ API static library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_cppdll\debug</td> + + <td>hdf5_cppddll.dll</td> + + <td>the HDF5 C++ API DLL</td> + + </tr> + + <tr> + + <td>hdf5_cppddll.lib</td> + + <td>the C++ API DLL export library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_cppdll\release</td> + + <td>hdf5_cppdll.dll</td> + + <td>the HDF5 C++ API DLL</td> + + </tr> + + <tr> + + <td>hdf5_cppdll.lib</td> + + <td>the C++ API DLL export library</td> + + </tr> + + </tbody> </table> - </div> - <p>The directories listed below will contain the following files ONLY when you - choose to build HDF5 Fortran libraries:</p> - <div style="TEXT-ALIGN: center"> - <table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"> - <tr> - <th>Location</th> - <th>File Name</th> - <th>Illustration</th> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5_fortran\debug</td> - <td>hdf5_fortrand.lib</td> - <td>the HDF5 Fortran API static library</td> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5_fortran\release</td> - <td>hdf5_fortran.lib</td> - <td>the HDF5 Fortran API static library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_fortrandll\debug</td> - <td>hdf5_fortranddll.dll</td> - <td>the HDF5 Fortran API DLL</td> - </tr> - <tr> - <td>hdf5_fortranddll.lib</td> - <td>the HDF5 Fortran API DLL export library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_fortrandll\release</td> - <td>hdf5_fortrandll.dll</td> - <td>the HDF5 Fortran API DLL</td> - </tr> - <tr> - <td>hdf5_fortrandll.lib</td> - <td>the HDF5 Fortran API DLL export library </td> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5_f90sctub\debug</td> - <td>hdf5_f90cstubd.lib</td> - <td>the HDF5 C and Fortran stub static library</td> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5_f90cstub\release</td> - <td>hdf5_f90cstub.lib</td> - <td>the HDF5 C and Fortran stub static library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_f90cstubdll\debug</td> - <td>hdf5_f90cstubddll.dll</td> - <td>the HDF5 C and Fortran stub DLL</td> - </tr> - <tr> - <td>hdf5_f90cstubddll.lib</td> - <td>the HDF5 C and Fortran stub DLL export library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_f90cstubdll\release</td> - <td>hdf5_f90cstubdll.dll</td> - <td>the HDF5 C and Fortran stub DLL</td> - </tr> - <tr> - <td>hdf5_f90cstubdll.lib</td> - <td>the HDF5 C and Fortran stub DLL export library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\fortran\test\libtest_cstubdll\debug</td> - <td>libtest_cstubddll.dll</td> - <td>the HDF5 Fortran test C and Fortran stub DLL</td> - </tr> - <tr> - <td>libtest_cstubddll.lib</td> - <td>the HDF5 Fortran test C and Fortran stub DLL export library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\fortran\test\libtest_cstubdll\release</td> - <td>libtest_cstubdll.dll</td> - <td>the HDF5 Fortran test C and Fortran stub DLL</td> - </tr> - <tr> - <td>libtest_cstubdll.lib</td> - <td>the HDF5 Fortran test C and Fortran stub DLL export library</td> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\fortran\test\libtest_fortran\debug</td> - <td>libtest_fortrand.lib</td> - <td>the HDF5 Fortran test static library</td> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\fortran\test\libtest_fortran\release</td> - <td>libtest_fortran.lib</td> - <td>the HDF5 Fortran test static library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\fortran\test\libtest_fortrandll\debug</td> - <td>libtest_fortranddll.dll</td> - <td>the HDF5 Fortran test DLL</td> - </tr> - <tr> - <td>libtest_fortranddll.lib</td> - <td>the HDF5 Fortran test DLL export library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\fortran\test\libtest_fortran\release</td> - <td>libtest_fortrandll.dll</td> - <td>the HDF5 Fortran test DLL</td> - </tr> - <tr> - <td>libtest_fortrandll.lib</td> - <td>the HDF5 Fortran test DLL export library</td> - </tr> + + </div> + + <p>The directories listed below will contain the following +files ONLY when you choose to build HDF5 Fortran libraries:</p> + + <div style="text-align: center;"> + <table style="border: thin solid blue;" border="1"> + + <tbody> + + <tr> + + <th>Location</th> + + <th>File Name</th> + + <th>Illustration</th> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5_fortran\debug</td> + + <td>hdf5_fortrand.lib</td> + + <td>the HDF5 Fortran API static library</td> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5_fortran\release</td> + + <td>hdf5_fortran.lib</td> + + <td>the HDF5 Fortran API static library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_fortrandll\debug</td> + + <td>hdf5_fortranddll.dll</td> + + <td>the HDF5 Fortran API DLL</td> + + </tr> + + <tr> + + <td>hdf5_fortranddll.lib</td> + + <td>the HDF5 Fortran API DLL export library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_fortrandll\release</td> + + <td>hdf5_fortrandll.dll</td> + + <td>the HDF5 Fortran API DLL</td> + + </tr> + + <tr> + + <td>hdf5_fortrandll.lib</td> + + <td>the HDF5 Fortran API DLL export library </td> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5_f90sctub\debug</td> + + <td>hdf5_f90cstubd.lib</td> + + <td>the HDF5 C and Fortran stub static library</td> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5_f90cstub\release</td> + + <td>hdf5_f90cstub.lib</td> + + <td>the HDF5 C and Fortran stub static library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_f90cstubdll\debug</td> + + <td>hdf5_f90cstubddll.dll</td> + + <td>the HDF5 C and Fortran stub DLL</td> + + </tr> + + <tr> + + <td>hdf5_f90cstubddll.lib</td> + + <td>the HDF5 C and Fortran stub DLL export library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_f90cstubdll\release</td> + + <td>hdf5_f90cstubdll.dll</td> + + <td>the HDF5 C and Fortran stub DLL</td> + + </tr> + + <tr> + + <td>hdf5_f90cstubdll.lib</td> + + <td>the HDF5 C and Fortran stub DLL export library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\fortran\test\libtest_cstubdll\debug</td> + + <td>libtest_cstubddll.dll</td> + + <td>the HDF5 Fortran test C and Fortran stub DLL</td> + + </tr> + + <tr> + + <td>libtest_cstubddll.lib</td> + + <td>the HDF5 Fortran test C and Fortran stub DLL export +library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\fortran\test\libtest_cstubdll\release</td> + + <td>libtest_cstubdll.dll</td> + + <td>the HDF5 Fortran test C and Fortran stub DLL</td> + + </tr> + + <tr> + + <td>libtest_cstubdll.lib</td> + + <td>the HDF5 Fortran test C and Fortran stub DLL export +library</td> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\fortran\test\libtest_fortran\debug</td> + + <td>libtest_fortrand.lib</td> + + <td>the HDF5 Fortran test static library</td> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\fortran\test\libtest_fortran\release</td> + + <td>libtest_fortran.lib</td> + + <td>the HDF5 Fortran test static library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\fortran\test\libtest_fortrandll\debug</td> + + <td>libtest_fortranddll.dll</td> + + <td>the HDF5 Fortran test DLL</td> + + </tr> + + <tr> + + <td>libtest_fortranddll.lib</td> + + <td>the HDF5 Fortran test DLL export library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\fortran\test\libtest_fortran\release</td> + + <td>libtest_fortrandll.dll</td> + + <td>the HDF5 Fortran test DLL</td> + + </tr> + + <tr> + + <td>libtest_fortrandll.lib</td> + + <td>the HDF5 Fortran test DLL export library</td> + + </tr> + + </tbody> </table> + <div> - <p>The directories listed below will contain the following files ONLY when - you choose to build HDF5 High Level libraries:</p> - <div style="TEXT-ALIGN: center"> - <table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"> - <tr> - <th>Location</th> - <th>File Name</th> - <th>Illustration</th> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5_hl\Release</td> - <td>hdf5_hl.lib</td> - <td>HDF5 High Level Static Library</td> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5_hl\Debug</td> - <td>hdf5_hld.lib</td> - <td>HDF5 High Level Static Library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hldll\Release</td> - <td>hdf5_hldll.lib</td> - <td>HDF5 High Level export Library</td> - </tr> - <tr> - <td>hdf5_hldll.dll</td> - <td>HDF5 High Level DLL</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hldll\Debug</td> - <td>hdf5_hldlld.lib</td> - <td>HDF5 High Level export Library</td> - </tr> - <tr> - <td>hdf5_hldlld.dll</td> - <td>HDF5 High Level DLL</td> - </tr> - </table> - </div> - <p>The directories listed below will contain the following files ONLY when - you choose to build HDF5 High Level C++ libraries:</p> - <div style="TEXT-ALIGN: center"> - <table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"> - <tr> - <th>Location</th> - <th>File Name</th> - <th>Illustration</th> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5_hl_cpp\Release</td> - <td>hdf5_hl_cpp.lib</td> - <td>HDF5 High Level Static Library</td> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5_hl_cpp\Debug</td> - <td>hdf5_hl_cpp.lib</td> - <td>HDF5 High Level Static Library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_cppdll\Release</td> - <td>hdf5_hl_cppdll.lib</td> - <td>HDF5 High Level C++ export Library</td> - </tr> - <tr> - <td>hdf5_hl_cppdll.dll</td> - <td>HDF5 High Level C++ DLL</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_cppdll\Debug</td> - <td>hdf5_hl_cppdlld.lib</td> - <td>HDF5 High Level C++ export Library</td> - </tr> - <tr> - <td>hdf5_hl_cppdlld.dll</td> - <td>HDF5 High Level C++ DLL</td> - </tr> - </table> - </div> - <p>The directories listed below will contain the following files ONLY when - you choose to build HDF5 High Level Fortran libraries:</p> - <div style="TEXT-ALIGN: center"> - <table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"> - <tr> - <th>Location</th> - <th>File Name</th> - <th>Illustration</th> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortran\Release</td> - <td>hdf5_hl_fortranr.lib</td> - <td>HDF5 High Level Fortran Static Library</td> - </tr> - <tr> - <td>c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortran\Debug</td> - <td>hdf5_hl_fortrand.lib</td> - <td>HDF5 High-Level Fortran Static Library</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortrandll\Release</td> - <td>hdf5_hl_fortrandll.lib</td> - <td>HDF5 High Level Fortran export Library</td> - </tr> - <tr> - <td>hdf5_hl_fortrandll.dll</td> - <td>HDF5 High Level Fortran DLL</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortrandll\Debug</td> - <td>hdf5_hl_fortrandlld.lib</td> - <td>HDF5 High Level Fortran export Library</td> - </tr> - <tr> - <td>hdf5_hl_fortrandlld.dll</td> - <td>HDF5 High Level Fortran DLL</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Release</td> - <td>hdf5_hl_f90cstubdll.lib</td> - <td>HDF5 High Level Fortran C stub export Library</td> - </tr> - <tr> - <td>hdf5_hl_f90cstubdll.dll</td> - <td>HDF5 High Level Fortran C stub DLL</td> - </tr> - <tr> - <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Debug</td> - <td>hdf5_hl_f90cstubdlld.lib</td> - <td>HDF5 High Level Fortran C stub export Library</td> - </tr> - <tr> - <td>hdf5_hl_f90cstubdlld.dll</td> - <td>HDF5 High Level Fortran C stub DLL</td> - </tr> - </table> - </div> + <p>The directories listed below will contain the following +files ONLY when you choose to build HDF5 High Level libraries:</p> + + <div style="text-align: center;"> + <table style="border: thin solid blue;" border="1"> + + <tbody> + + <tr> + + <th>Location</th> + + <th>File Name</th> + + <th>Illustration</th> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5_hl\Release</td> + + <td>hdf5_hl.lib</td> + + <td>HDF5 High Level Static Library</td> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5_hl\Debug</td> + + <td>hdf5_hld.lib</td> + + <td>HDF5 High Level Static Library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hldll\Release</td> + + <td>hdf5_hldll.lib</td> + + <td>HDF5 High Level export Library</td> + + </tr> + + <tr> + + <td>hdf5_hldll.dll</td> + + <td>HDF5 High Level DLL</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hldll\Debug</td> + + <td>hdf5_hldlld.lib</td> + + <td>HDF5 High Level export Library</td> + + </tr> + + <tr> + + <td>hdf5_hldlld.dll</td> + + <td>HDF5 High Level DLL</td> + + </tr> + + </tbody> + </table> + + </div> + + <p>The directories listed below will contain the following +files ONLY when you choose to build HDF5 High Level C++ libraries:</p> + + <div style="text-align: center;"> + <table style="border: thin solid blue;" border="1"> + + <tbody> + + <tr> + + <th>Location</th> + + <th>File Name</th> + + <th>Illustration</th> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5_hl_cpp\Release</td> + + <td>hdf5_hl_cpp.lib</td> + + <td>HDF5 High Level Static Library</td> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5_hl_cpp\Debug</td> + + <td>hdf5_hl_cpp.lib</td> + + <td>HDF5 High Level Static Library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_cppdll\Release</td> + + <td>hdf5_hl_cppdll.lib</td> + + <td>HDF5 High Level C++ export Library</td> + + </tr> + + <tr> + + <td>hdf5_hl_cppdll.dll</td> + + <td>HDF5 High Level C++ DLL</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_cppdll\Debug</td> + + <td>hdf5_hl_cppdlld.lib</td> + + <td>HDF5 High Level C++ export Library</td> + + </tr> + + <tr> + + <td>hdf5_hl_cppdlld.dll</td> + + <td>HDF5 High Level C++ DLL</td> + + </tr> + + </tbody> + </table> + + </div> + + <p>The directories listed below will contain the following +files ONLY when you choose to build HDF5 High Level Fortran libraries:</p> + + <div style="text-align: center;"> + <table style="border: thin solid blue;" border="1"> + + <tbody> + + <tr> + + <th>Location</th> + + <th>File Name</th> + + <th>Illustration</th> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortran\Release</td> + + <td>hdf5_hl_fortranr.lib</td> + + <td>HDF5 High Level Fortran Static Library</td> + + </tr> + + <tr> + + <td>c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortran\Debug</td> + + <td>hdf5_hl_fortrand.lib</td> + + <td>HDF5 High-Level Fortran Static Library</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortrandll\Release</td> + + <td>hdf5_hl_fortrandll.lib</td> + + <td>HDF5 High Level Fortran export Library</td> + + </tr> + + <tr> + + <td>hdf5_hl_fortrandll.dll</td> + + <td>HDF5 High Level Fortran DLL</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortrandll\Debug</td> + + <td>hdf5_hl_fortrandlld.lib</td> + + <td>HDF5 High Level Fortran export Library</td> + + </tr> + + <tr> + + <td>hdf5_hl_fortrandlld.dll</td> + + <td>HDF5 High Level Fortran DLL</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Release</td> + + <td>hdf5_hl_f90cstubdll.lib</td> + + <td>HDF5 High Level Fortran C stub export Library</td> + + </tr> + + <tr> + + <td>hdf5_hl_f90cstubdll.dll</td> + + <td>HDF5 High Level Fortran C stub DLL</td> + + </tr> + + <tr> + + <td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Debug</td> + + <td>hdf5_hl_f90cstubdlld.lib</td> + + <td>HDF5 High Level Fortran C stub export Library</td> + + </tr> + + <tr> + + <td>hdf5_hl_f90cstubdlld.dll</td> + + <td>HDF5 High Level Fortran C stub DLL</td> + + </tr> + + </tbody> + </table> + </div> - </div> + + </div> + + </div> + </li> + </ul> -<h3><a name="step2_section2"><u>STEP 2: Testing HDF5 libraries and tools</u></a></h3> -<p>HDF5 libraries and tools should be tested to make sure that they were built correctly.</p> -<p>We provide 2 options for users to test HDF5 libraries and tools.</p> + +<h3><a name="step2_section2"><u>STEP 2: +Testing HDF5 libraries and tools</u></a></h3> + +<p>HDF5 libraries and tools should be tested to make sure that +they were built correctly.</p> + +<p>We provide 2 options for users to test HDF5 libraries and +tools.</p> + <h4>Option 1: Automatic Testings</h4> -<p>HDF5 comes with various test suites, all of which can be tested with hdf5check.bat -batch file in c:\MyHDFstuff\hdf5 directory. </p> -<p>hdf5check batch file can be run with one of the following four options: </p> -<div style="TEXT-ALIGN: center"> - <table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"> + +<p>HDF5 comes with various test suites, all of which can be +tested with hdf5check.bat batch file in c:\MyHDFstuff\hdf5 directory. </p> + +<p>hdf5check batch file can be run with one of the following four +options: </p> + +<div style="text-align: center;"> +<table style="border: thin solid blue;" border="1"> + + <tbody> + <tr> + <th>Options</th> + <th>Illustration</th> + </tr> + <tr> + <td> <p>hdf5check</p> + </td> + <td> <p>test HDF5 C library and tools only</p> + </td> + </tr> + <tr> + <td> <p>hdf5check enablecpp</p> + </td> + <td> <p>test HDF5 C/C++ libraries and tools.</p> - <p>To use this option, HDF5 C++ libraries must have been built in - <a href="#section1_3.1">step I.</a></p> + + <p>To use this option, HDF5 C++ libraries must have been +built in <a href="#section1_3.1">step I.</a></p> + </td> + </tr> + <tr> + <td> <p>hdf5check enablefortran</p> + </td> + <td> <p>test HDF5 C/FORTRAN libraries and tools</p> - <p>To use this option, HDF5 Fortran libraries must have been built in - <a href="#section1_3.2">step I.</a></p> + + <p>To use this option, HDF5 Fortran libraries must have +been built in <a href="#section1_3.2">step I.</a></p> + </td> + </tr> + <tr> + <td> <p>hdf5check enableall</p> + </td> + <td> <p>test HDF5 C/C++/FORTRAN libraries and tools</p> - <p>To use this option, HDF5 C++ and Fortran libraries must have been built - in step I.</p> + + <p>To use this option, HDF5 C++ and Fortran libraries must +have been built in step I.</p> + </td> + </tr> - </table> + + </tbody> +</table> + </div> -<p>Invoke a command prompt window and run hdf5check with appropriate option.</p> + +<p>Invoke a command prompt window and run hdf5check with +appropriate option.</p> + <p>Test results are saved in two files:</p> + <p class="filename">c:\MyHDFstuff\hdf5\check_results.txt</p> + <p class="filename">c:\MyHDFstuff\hdf5\tests_results.txt.</p> -<p>In general, you only need to check<span class="filename"> tests_results.txt</span>. -If all the tests passed, then you do not have to check <span class="filename">check_results.txt</span>. -If some tests failed, check <span class="filename">check_results.txt</span> can -help you figure out what was wrong. </p> + +<p>In general, you only need to check<span class="filename"> +tests_results.txt</span>. If all the tests passed, then you do +not have to check <span class="filename">check_results.txt</span>. +If some tests failed, check <span class="filename">check_results.txt</span> +can help you figure out what was wrong. </p> + <h4>Option 2: Step-by-step HDF5 libraries and tools testings</h4> -<p>You can also test HDF5 libraries and tools one by one. There are four -versions of HDF5 libraries and tools testing. They are: </p> + +<p>You can also test HDF5 libraries and tools one by one. There +are four versions of HDF5 libraries and tools testing. They are: </p> + <ul class="normal"> + <li> - <p>release version</p> + <p>release version</p> + </li> + <li> - <p>release dll version</p> + <p>release dll version</p> + </li> + <li> - <p>debug version</p> + <p>debug version</p> + </li> + <li> - <p>debug dll version</p> + <p>debug dll version</p> + </li> + </ul> -<p>We strongly suggest you to redirect your testing results into an output file -so that you can easily check the testing results. You may use either Notepad or -WordPad or whatever other windows word processor to check the results. For the purpose -of printing, please choose font less than 14 for better alignment of the text. + +<p>We strongly suggest you to redirect your testing results into +an output file so that you can easily check the testing results. You +may use either Notepad or WordPad or whatever other windows word +processor to check the results. For the purpose of printing, please +choose font less than 14 for better alignment of the text. </p> -<p>DLLs listed below should be placed into the Windows system directory. A batch -file named <span class="filename">install_dll.bat</span> is included in -<span class="filename">c:\MyHDFstuff\hdf5</span> directory. Run this batch file -and the following HDF5 DLLs will be copied to the system directory. </p> + +<p>DLLs listed below should be placed into the Windows system +directory. A batch file named <span class="filename">install_dll.bat</span> +is included in +<span class="filename">c:\MyHDFstuff\hdf5</span> +directory. Run this batch file and the following HDF5 DLLs will be +copied to the system directory. </p> + <ul class="normal"> + <li>hdf5\proj\hdf5dll\release\hdf5dll.dll </li> + <li>hdf5\proj\hdf5dll\debug\hdf5ddll.dll </li> + <li>hdf5\test\libtestD\release\libtestD.dll </li> + <li>hdf5\test\libtestD\debug\libtestDd.dll</li> + </ul> + <ul class="intable"> + <li> - <h5>1. HDF5 library testing</h5> - <p>cd into the hdf5\test directory.</p> - <ul class="intable"> - <li> - <h5>(1) Basic Tests</h5> - <p>Go to a, b, c, or d to test your chosen version</p> + <h5>1. HDF5 library testing</h5> + + <p>cd into the hdf5\test directory.</p> + <ul class="intable"> + <li> - <h5>a. release static version</h5> - <p>type:</p> - <p>hdf5test release >"Your output filename" </p> - </li> - <li> - <h5>b. release dll version</h5> - <p>type:</p> - <p>hdf5test release dll > "Your output filename"</p> - </li> - <li> - <h5>c. debug static version</h5> - <p>type:</p> - <p>hdf5test debug >"Your output filename"</p> + <h5>(1) Basic Tests</h5> + + <p>Go to a, b, c, or d to test your chosen version</p> + + <ul class="intable"> + + <li> + <h5>a. release static version</h5> + + <p>type:</p> + + <p>hdf5test release >"Your output filename" </p> + + </li> + + <li> + <h5>b. release dll version</h5> + + <p>type:</p> + + <p>hdf5test release dll > "Your output +filename"</p> + + </li> + + <li> + <h5>c. debug static version</h5> + + <p>type:</p> + + <p>hdf5test debug >"Your output filename"</p> + + </li> + + <li> + <h5>d. debug dll version</h5> + + <p>type:</p> + + <p>hdf5test debug dll >"Your output filename"</p> + + </li> + + </ul> + </li> + <li> - <h5>d. debug dll version</h5> - <p>type:</p> - <p>hdf5test debug dll >"Your output filename"</p> + <h5>(2) Timing tests</h5> + + <p>Go to a, b, c, or d to test your chosen version</p> + + <ul class="intable"> + + <li> + <h5>a. release static version</h5> + + <p>type:</p> + + <p>hdf5timingtest release >"Your output +filename" </p> + + </li> + + <li> + <h5>b. release dll version</h5> + + <p>type:</p> + + <p>hdf5timingtest release dll >"Your output +filename" </p> + + </li> + + <li> + <h5>c. debug static version</h5> + + <p>type:</p> + + <p>hdf5timingtest debug >"Your output +filename" </p> + + </li> + + <li> + <h5>d. debug dll version</h5> + + <p>type:</p> + + <p>hdf5timingtest debug dll >"Your output +filename" </p> + + </li> + + </ul> + </li> + </ul> - </li> - <li> - <h5>(2) Timing tests</h5> + + <p class="note">Notes:</p> + + <p class="note">Use Notepad or WordPad to check +results. You should not find any FAILED marks in your output files.</p> + + </li> + + <li> + <h5>2. HDF5 tools testing</h5> + + <p>To test HDF5 tools, go to directory <span class="filename">c:\MyHDFstuff\hdf5\tools</span>. The +HDF5 tools testing results are saved into output files in tools +directory by the <span class="filename">testhdf5tools.bat</span> +as described below. </p> + <p>Go to a, b, c, or d to test your chosen version</p> + <ul class="intable"> + <li> - <h5>a. release static version</h5> - <p>type:</p> - <p>hdf5timingtest release >"Your output filename" </p> + <h5>a. release static version</h5> + + <p>type:</p> + + <p>testhdf5tools release</p> + + <p>output file: <span class="filename">toolstest_release.txt</span></p> + </li> + <li> - <h5>b. release dll version</h5> - <p>type:</p> - <p>hdf5timingtest release dll >"Your output filename" </p> + <h5>b. release dll version</h5> + + <p>type:</p> + + <p>testhdf5tools release dll</p> + + <p>output file: <span class="filename">toolstest_releasedll.txt</span></p> + </li> + <li> - <h5>c. debug static version</h5> - <p>type:</p> - <p>hdf5timingtest debug >"Your output filename" </p> + <h5>c. debug static version</h5> + + <p>type:</p> + + <p>testhdf5tools debug</p> + + <p>output file: <span class="filename">toolstest_debug.txt</span></p> + </li> + <li> - <h5>d. debug dll version</h5> - <p>type:</p> - <p>hdf5timingtest debug dll >"Your output filename" </p> + <h5>d. debug dll version</h5> + + <p>type:</p> + + <p>testhdf5tools debug dll</p> + + <p>output file: <span class="filename">toolstest_debugdll.txt</span></p> + </li> + </ul> - </li> - </ul> - <p class="note">Notes:</p> - <p class="note">Use Notepad or WordPad to check results. You should not find any FAILED marks - in your output files.</p> - </li> - <li> - <h5>2. HDF5 tools testing</h5> - <p>To test HDF5 tools, go to directory <span class="filename">c:\MyHDFstuff\hdf5\tools</span>. - The HDF5 tools testing results are saved into output files in tools directory - by the <span class="filename">testhdf5tools.bat</span> as described below. </p> - <p>Go to a, b, c, or d to test your chosen version</p> - <ul class="intable"> - <li> - <h5>a. release static version</h5> - <p>type:</p> - <p>testhdf5tools release</p> - <p>output file: <span class="filename">toolstest_release.txt</span></p> - </li> - <li> - <h5>b. release dll version</h5> - <p>type:</p> - <p>testhdf5tools release dll</p> - <p>output file: <span class="filename">toolstest_releasedll.txt</span></p> - </li> - <li> - <h5>c. debug static version</h5> - <p>type:</p> - <p>testhdf5tools debug</p> - <p>output file: <span class="filename">toolstest_debug.txt</span></p> - </li> - <li> - <h5>d. debug dll version</h5> - <p>type:</p> - <p>testhdf5tools debug dll</p> - <p>output file: <span class="filename">toolstest_debugdll.txt</span></p> - </li> - </ul> - <p class="note">Notes:</p> - <p class="note">Use Notepad or WordPad to check results. You should not find any FAILED marks - in your output files.</p> + + <p class="note">Notes:</p> + + <p class="note">Use Notepad or WordPad to check +results. You should not find any FAILED marks in your output files.</p> + </li> + <li> - <h5>3. HDF5 C++ library test</h5> - <p>Skip this step UNLESS you have built HDF5 C++ libraries and want to test them.</p> - <p>DLLs listed below should be placed into to the Windows system directory. A - batch file named <span class="filename">install_cppdll.bat</span> is included - in <span class="filename">c:\MyHDFstuff\hdf5</span> directory. Run this batch - file and the following HDF5 C++ DLLs will be copied to the system directory. - </p> - <ul class="normal"> - <li>hdf5\proj\hdf5_cppdll\release\hdf5_cppdll.dll </li> - <li>hdf5\proj\hdf5_cppdll\debug\hdf5_cppddll.dll</li> - </ul> - <p>Run <span class="filename">hdf5cpptest.bat</span> in the - <span class="filename">hdf5\c++\test </span>directory at the command prompt as - below:</p> - <ul class="normal"> - <li>hdf5cpptest release >"Your output filename" </li> - <li>hdf5cpptest release dll >"Your output filename" </li> - <li>hdf5cpptest debug >"Your output filename" </li> - <li>hdf5cpptest debug dll >"Your output filename"</li> - </ul> - <p class="note">Notes:</p> - <p class="note">Use Notepad or WordPad to check results. You should not find any FAILED marks - in your output files. </p> + <h5>3. HDF5 C++ library test</h5> + + <p>Skip this step UNLESS you have built HDF5 C++ libraries +and want to test them.</p> + + <p>DLLs listed below should be placed into to the Windows +system directory. A batch file named <span class="filename">install_cppdll.bat</span> +is included in <span class="filename">c:\MyHDFstuff\hdf5</span> +directory. Run this batch file and the following HDF5 C++ DLLs will be +copied to the system directory. </p> + + <ul class="normal"> + + <li>hdf5\proj\hdf5_cppdll\release\hdf5_cppdll.dll </li> + + <li>hdf5\proj\hdf5_cppdll\debug\hdf5_cppddll.dll</li> + + </ul> + + <p>Run <span class="filename">hdf5cpptest.bat</span> +in the <span class="filename">hdf5\c++\test </span>directory +at the command prompt as below:</p> + + <ul class="normal"> + + <li>hdf5cpptest release >"Your output filename" </li> + + <li>hdf5cpptest release dll >"Your output filename" </li> + + <li>hdf5cpptest debug >"Your output filename" </li> + + <li>hdf5cpptest debug dll >"Your output filename"</li> + + </ul> + + <p class="note">Notes:</p> + + <p class="note">Use Notepad or WordPad to check +results. You should not find any FAILED marks in your output files. </p> + </li> + <li> - <h5>4. HDF5 Fortran library test</h5> - <p>Skip this step UNLESS you have built HDF5 Fortran libraries and want to test - them.</p> - <p>DLLs listed below should be placed into to the Windows system directory. A - batch file named <span class="filename">install_f90dll.bat</span> is included - in <span class="filename">c:\MyHDFstuff\hdf5</span> directory. Run this batch - file and the following HDF5 Fortran DLLs will be copied to the system directory. - </p> - <ul class="normal"> - <li>hdf5\proj\hdf5_f90cstubdll\release\hdf5_f90cstubdll.dll </li> - <li>hdf5\proj\hdf5_f90cstubdll\debug\hdf5_f90cstubddll.dll </li> - <li>hdf5\proj\hdf5_fortrandll\release\hdf5_fortrandll.dll </li> - <li>hdf5\proj\hdf5_fortrandll\debug\hdf5_fortranddll.dll </li> - <li>hdf5\fortran\test\libtest_cstubdll\release\libtest_cstubdll.dll </li> - <li>hdf5\fortran\test\libtest_cstubdll\debug\libtest_cstubddll.dll </li> - <li>hdf5\fortran\test\libtest_fortrandll\release\libtest_fortrandll.dll </li> - <li>hdf5\fortran\test\libtest_fortrandll\debug\libtest_fortranddll.dll</li> - </ul> - <p>Run <span class="filename">testhdf5_fortran.bat</span> at the command prompt - as below:</p> - <ul class="normal"> - <li>testhdf5_fortran release > "Your output filename" </li> - <li>testhdf5_fortran release dll > "Your output filename" </li> - <li>testhdf5_fortran debug > "Your output filename" </li> - <li>testhdf5_fortran debug dll > "Your output filename"</li> - </ul> - <p class="note">Notes:</p> - <p class="note">Use Notepad or WordPad to check results. You should not find any FAILED marks - in your output files.</p> + <h5>4. HDF5 Fortran library test</h5> + + <p>Skip this step UNLESS you have built HDF5 Fortran +libraries and want to test them.</p> + + <p>DLLs listed below should be placed into to the Windows +system directory. A batch file named <span class="filename">install_f90dll.bat</span> +is included in <span class="filename">c:\MyHDFstuff\hdf5</span> +directory. Run this batch file and the following HDF5 Fortran DLLs will +be copied to the system directory. </p> + + <ul class="normal"> + + <li>hdf5\proj\hdf5_f90cstubdll\release\hdf5_f90cstubdll.dll + </li> + + <li>hdf5\proj\hdf5_f90cstubdll\debug\hdf5_f90cstubddll.dll </li> + + <li>hdf5\proj\hdf5_fortrandll\release\hdf5_fortrandll.dll </li> + + <li>hdf5\proj\hdf5_fortrandll\debug\hdf5_fortranddll.dll </li> + + <li>hdf5\fortran\test\libtest_cstubdll\release\libtest_cstubdll.dll + </li> + + <li>hdf5\fortran\test\libtest_cstubdll\debug\libtest_cstubddll.dll + </li> + + <li>hdf5\fortran\test\libtest_fortrandll\release\libtest_fortrandll.dll + </li> + + <li>hdf5\fortran\test\libtest_fortrandll\debug\libtest_fortranddll.dll</li> + + </ul> + + <p>Run <span class="filename">testhdf5_fortran.bat</span> +at the command prompt as below:</p> + + <ul class="normal"> + + <li>testhdf5_fortran release > "Your output +filename" </li> + + <li>testhdf5_fortran release dll > "Your output +filename" </li> + + <li>testhdf5_fortran debug > "Your output filename" </li> + + <li>testhdf5_fortran debug dll > "Your output +filename"</li> + + </ul> + + <p class="note">Notes:</p> + + <p class="note">Use Notepad or WordPad to check +results. You should not find any FAILED marks in your output files.</p> + </li> + <li> - <h5>5. HDF5 High-Level C library test</h5> - <p>Skip this step UNLESS you have built HDF5 High-Level libraries and want to - test them.</p> - <p>DLLs listed below should be placed into the Windows system directory. A batch - file named <span class="filename">install_hldll.bat</span> is included in - <span class="filename">c:\MyHDFstuff\hdf5</span> directory. Run this batch file - and the following HDF5 high level DLLs will be copied to the system directory.</p> - <ul class="normal"> - <li>c:\MyHDFstuff\hdf5\proj\hdf5_hldll\Release\hdf5_hldll.dll</li> - <li>c:\MyHDFstuff\hdf5\proj\hdf5_hldll\Debug\hdf5_hldlld.dll</li> - </ul> - <p>Run <span class="filename">test_hdf5_hl.bat</span> in the - <span class="filename">hdf5\hl\test</span> directory at the command prompt as - below:</p> - <ul class="normal"> - <li>test_hdf5_hl release >"Your output filename" </li> - <li>test_hdf5_hl release dll >"Your output filename" </li> - <li>test_hdf5_hl debug >"Your output filename" </li> - <li>test_hdf5_hl debug dll >"Your output filename"</li> - </ul> - <p class="note">Notes:</p> - <p class="note">Use Notepad or WordPad to check results. You should not find any FAILED marks - in your output files.</p> + <h5>5. HDF5 High-Level C library test</h5> + + <p>Skip this step UNLESS you have built HDF5 High-Level +libraries and want to test them.</p> + + <p>DLLs listed below should be placed into the Windows system +directory. A batch file named <span class="filename">install_hldll.bat</span> +is included in <span class="filename">c:\MyHDFstuff\hdf5</span> +directory. Run this batch file and the following HDF5 high level DLLs +will be copied to the system directory.</p> + + <ul class="normal"> + + <li>c:\MyHDFstuff\hdf5\proj\hdf5_hldll\Release\hdf5_hldll.dll</li> + + <li>c:\MyHDFstuff\hdf5\proj\hdf5_hldll\Debug\hdf5_hldlld.dll</li> + + </ul> + + <p>Run <span class="filename">test_hdf5_hl.bat</span> +in the <span class="filename">hdf5\hl\test</span> +directory at the command prompt as below:</p> + + <ul class="normal"> + + <li>test_hdf5_hl release >"Your output filename" </li> + + <li>test_hdf5_hl release dll >"Your output filename" + </li> + + <li>test_hdf5_hl debug >"Your output filename" </li> + + <li>test_hdf5_hl debug dll >"Your output filename"</li> + + </ul> + + <p class="note">Notes:</p> + + <p class="note">Use Notepad or WordPad to check +results. You should not find any FAILED marks in your output files.</p> + </li> + <li> - <h5>6. HDF5 High-Level C++ library test</h5> - <p>Skip this step UNLESS you have built HDF5 High-Level C++ libraries and want - to test them.</p> - <p>DLLs listed below should be placed into the Windows system directory. A batch - file named <span class="filename">install_hlcppdll.bat</span> is included in - <span class="filename">c:\MyHDFstuff\hdf5</span> directory. Run this batch file - and the following HDF5 high level DLLs will be copied to the system directory.</p> - <ul class="normal"> - <li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_cppdll\Release\hdf5_hl_cppdll.dll</li> - <li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_cppdll\Debug\hdf5_hl_cppdlld.dll</li> - </ul> - <p>Run <span class="filename">test_hdf5_hl_cpp.bat</span> in the - <span class="filename">hdf5\hl\c++\test</span> directory at the command prompt - as below:</p> - <ul class="normal"> - <li>test_hdf5_hl_cpp release >"Your output filename" </li> - <li>test_hdf5_hl_cpp release dll >"Your output filename" </li> - <li>test_hdf5_hl_cpp debug >"Your output filename" </li> - <li>test_hdf5_hl_cpp debug dll >"Your output filename"</li> - </ul> - <p class="note">Notes:</p> - <p class="note">Use Notepad or WordPad to check results. You should not find any FAILED marks - in your output files.</p> + <h5>6. HDF5 High-Level C++ library test</h5> + + <p>Skip this step UNLESS you have built HDF5 High-Level C++ +libraries and want to test them.</p> + + <p>DLLs listed below should be placed into the Windows system +directory. A batch file named <span class="filename">install_hlcppdll.bat</span> +is included in <span class="filename">c:\MyHDFstuff\hdf5</span> +directory. Run this batch file and the following HDF5 high level DLLs +will be copied to the system directory.</p> + + <ul class="normal"> + + <li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_cppdll\Release\hdf5_hl_cppdll.dll</li> + + <li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_cppdll\Debug\hdf5_hl_cppdlld.dll</li> + + </ul> + + <p>Run <span class="filename">test_hdf5_hl_cpp.bat</span> +in the <span class="filename">hdf5\hl\c++\test</span> +directory at the command prompt as below:</p> + + <ul class="normal"> + + <li>test_hdf5_hl_cpp release >"Your output filename" + </li> + + <li>test_hdf5_hl_cpp release dll >"Your output +filename" </li> + + <li>test_hdf5_hl_cpp debug >"Your output filename" </li> + + <li>test_hdf5_hl_cpp debug dll >"Your output +filename"</li> + + </ul> + + <p class="note">Notes:</p> + + <p class="note">Use Notepad or WordPad to check +results. You should not find any FAILED marks in your output files.</p> + </li> + <li> - <h5>7. HDF5 High-Level Fortran library test</h5> - <p>Skip this step UNLESS you have built HDF5 High-Level Fortran libraries and - want to test them.</p> - <p>DLLs listed below should be placed into the Windows system directory. A batch - file named <span class="filename">install_hlf90dll.bat</span> is included in - <span class="filename">c:\MyHDFstuff\hdf5</span> directory. Run this batch file - and the following HDF5 high level DLLs will be copied to the system directory.</p> - <ul class="normal"> - <li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Release\hdf5_hl_f90cstubdll.dll</li> - <li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Debug\hdf5_hl_f90cstubdlld.dll</li> - <li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortrandll\Release\hdf5_hl_fortrandll.dll</li> - <li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortrandll\Debug\hdf5_hl_fortrandlld.dll</li> - </ul> - <p>Run <span class="filename">test_hdf5_hl_fortran.bat</span> in the - <span class="filename">hdf5\hl\fortran\test</span> directory at the command prompt - as below:</p> - <ul class="normal"> - <li>test_hdf5_hl_fortran release >"Your output filename" </li> - <li>test_hdf5_hl_fortran release dll >"Your output filename" </li> - <li>test_hdf5_hl_fortran debug >"Your output filename" </li> - <li>test_hdf5_hl_fortran debug dll >"Your output filename"</li> - </ul> - <p class="note">Notes:</p> - <p class="note">Use Notepad or WordPad to check results. You should not find any FAILED marks - in your output files.</p> + <h5>7. HDF5 High-Level Fortran library test</h5> + + <p>Skip this step UNLESS you have built HDF5 High-Level +Fortran libraries and want to test them.</p> + + <p>DLLs listed below should be placed into the Windows system +directory. A batch file named <span class="filename">install_hlf90dll.bat</span> +is included in <span class="filename">c:\MyHDFstuff\hdf5</span> +directory. Run this batch file and the following HDF5 high level DLLs +will be copied to the system directory.</p> + + <ul class="normal"> + + <li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Release\hdf5_hl_f90cstubdll.dll</li> + + <li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Debug\hdf5_hl_f90cstubdlld.dll</li> + + <li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortrandll\Release\hdf5_hl_fortrandll.dll</li> + + <li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortrandll\Debug\hdf5_hl_fortrandlld.dll</li> + + </ul> + + <p>Run <span class="filename">test_hdf5_hl_fortran.bat</span> +in the <span class="filename">hdf5\hl\fortran\test</span> +directory at the command prompt as below:</p> + + <ul class="normal"> + + <li>test_hdf5_hl_fortran release >"Your output +filename" </li> + + <li>test_hdf5_hl_fortran release dll >"Your output +filename" </li> + + <li>test_hdf5_hl_fortran debug >"Your output +filename" </li> + + <li>test_hdf5_hl_fortran debug dll >"Your output +filename"</li> + + </ul> + + <p class="note">Notes:</p> + + <p class="note">Use Notepad or WordPad to check +results. You should not find any FAILED marks in your output files.</p> + </li> + </ul> -<h3><a name="step3_section2"><u>STEP 3: Installing HDF5 Libraries</u></a></h3> -<p>We provide a batch file for users to relocate all HDF5 libraries in one folder -(C++ and Fortran libraries will also be copied into this folder if they have been -built in step I). The file is called <span class="filename">installhdf5lib.bat</span> -under <span class="filename">c:\MyHDFstuff\hdf5</span> directory. Run the batch -file, you may see a folder called hdf5lib under <span class="filename">c:\MyHDFstuff\hdf5</span>. + +<h3><a name="step3_section2"><u>STEP 3: +Installing HDF5 Libraries</u></a></h3> + +<p>We provide a batch file for users to relocate all HDF5 +libraries in one folder (C++ and Fortran libraries will also be copied +into this folder if they have been built in step I). The file is called +<span class="filename">installhdf5lib.bat</span> +under <span class="filename">c:\MyHDFstuff\hdf5</span> +directory. Run the batch file, you may see a folder called hdf5lib +under <span class="filename">c:\MyHDFstuff\hdf5</span>. </p> -<p>The <release> layout of <hdf5lib> should be:</p> + +<p>The <release> layout of <hdf5lib> +should be:</p> + <ul class="normal"> + <li>release\include -- HDF5 header files </li> + <li>release\bin -- HDF5 static tool executables </li> + <li>release\bindll -- HDF5 DLL tool executables </li> + <li>release\lib -- HDF5 static libraries </li> + <li>release\dll -- HDF5 DLLs</li> + </ul> -<p>You may also find the similar layout for the <debug>. </p> -<p class="right"><a href="#section2">Go to TOP Section II</a></p> -<p class="right"><a href="#content_table">Go to Table of Contents</a></p> + +<p>You may also find the similar layout for the +<debug>. </p> + +<p class="right"><a href="#section2">Go to +TOP Section II</a></p> + +<p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + <hr class="second"> -<h2><a name="section3_examples">Section III: How to build Examples -(Optional)</a></h2> +<h2><a name="section3_examples">Section III: How to +build Examples (Optional)</a></h2> + <hr class="second"> <p>This section include:</p> -<p><a href="#cexamples">How to build and test C examples</a></p> -<p><a href="#cppexamples">How to build and test C++ examples</a></p> -<p><a href="#f90examples">How to build and test Fortran examples</a></p> -<p><a href="#hlcexamples">How to build and test High Level C examples</a></p> -<p><a href="#hlf90examples">How to build and test High Level Fortran examples</a></p> + +<p><a href="#cexamples">How to build and test C +examples</a></p> + +<p><a href="#cppexamples">How to build and test C++ +examples</a></p> + +<p><a href="#f90examples">How to build and test +Fortran examples</a></p> + +<p><a href="#hlcexamples">How to build and test High +Level C examples</a></p> + +<p><a href="#hlf90examples">How to build and test +High Level Fortran examples</a></p> + <p class="note">Notes:</p> + <ul class="intable"> + <li> - <p class="note">1. To build HDF5 C++ examples, HDF5 C++ library must have been built in - Section III, step - I. </p> + <p class="note">1. To build HDF5 C++ examples, HDF5 +C++ library must have been built in Section III, step I. </p> + </li> + <li> - <p class="note">2. To build HDF5 Fortran examples, HDF5 Fortran library must have been built - in Section III, step I. </p> + <p class="note">2. To build HDF5 Fortran examples, +HDF5 Fortran library must have been built in Section III, step I. </p> + </li> + <li> - <p class="note">3. To build HDF5 High Level C examples, HDF5 High Level C library must have - been built in Section III, step I.</p> + <p class="note">3. To build HDF5 High Level C +examples, HDF5 High Level C library must have been built in Section +III, step I.</p> + </li> + <li> - <p class="note">4. By default, the debug versions of HDF5 C/C++/Fortran/HL examples are linked - with the debug versions of HDF5 C/C++/Fortran/HL libraries and DLLs. The debug - versions of <span style="font-size: 100%">HDF5</span> C/C++/Fortran/HL examples will fail if they are linked with HDF5 - binary distribution, which only includes the release versions of HDF5 C/C++/Fortran - libraries and DLLs. </p> + <p class="note">4. By default, the debug versions of +HDF5 C/C++/Fortran/HL examples are linked with the debug versions of +HDF5 C/C++/Fortran/HL libraries and DLLs. The debug versions of <span style="font-size: 100%;">HDF5</span> C/C++/Fortran/HL +examples will fail if they are linked with HDF5 binary distribution, +which only includes the release versions of HDF5 C/C++/Fortran +libraries and DLLs. </p> + </li> + </ul> - <p> </p> -<hr /> + +<p> </p> + +<hr> <ul class="intable"> + <li> - <h3><a name="cexamples"><u>How to build and test C examples:</u></a></h3> - <ul class="intable"> - <li> - <p>1. Open C Examples Workspace</p> - <p>Invoke Microsoft Visual C++, go to <span class="filename">"File"</span> - and select the <span class="filename">"Open Workspace"</span> option.</p> - <p>Then open the workspace <span class="filename">c:\MyHDFstuff\hdf5\windows\examples\allexamples\allexamples.dsw.</span></p> - </li> - <li> - <p>2. Compile/Build C Examples</p> - <p>Select <span class="filename">"Build"</span>, then Select - <span class="filename">"Set Active Configuration"</span>. </p> + <h3><a name="cexamples"><u>How to build +and test C examples:</u></a></h3> + <ul class="intable"> + <li> - <p>To build debug versions of C examples,</p> - <p>In <span class="filename">"Project configurations"</span>, select - <span class="filename">"allexamples -- Win32 Debug"</span>, select - <span class="filename">"ok"</span>. Select <span class="filename">"Build" - -> "Build" or "Rebuild All"</span> to build debug version of project - <span class="filename">"allexamples"</span>. </p> + <p>1. Open C Examples Workspace</p> + + <p>Invoke Microsoft Visual C++, go to <span class="filename">"File"</span> and select the <span class="filename">"Open Workspace"</span> option.</p> + + <p>Then open the workspace <span class="filename">c:\MyHDFstuff\hdf5\windows\examples\allexamples\allexamples.dsw.</span></p> + </li> + <li> - <p>To build release versions of C examples,</p><p>In <span class="filename">"Project configurations"</span>, select - <span class="filename">"allexamples -- Win32 Release"</span>, select - <span class="filename">"ok".</span> Select <span class="filename">"Build" - -> "Build" or "Rebuild All"</span> to build release version of project - <span class="filename">"allexamples"</span>. </p> + <p>2. Compile/Build C Examples</p> + + <p>Select <span class="filename">"Build"</span>, +then Select <span class="filename">"Set Active +Configuration"</span>. </p> + + <ul class="intable"> + + <li> + <p>To build debug versions of C examples,</p> + + <p>In <span class="filename">"Project +configurations"</span>, select <span class="filename">"allexamples +-- Win32 Debug"</span>, select <span class="filename">"ok"</span>. +Select <span class="filename">"Build" -> "Build" +or "Rebuild All"</span> to build debug version of project <span class="filename">"allexamples"</span>. </p> + + </li> + + <li> + <p>To build release versions of C examples,</p> + + <p>In <span class="filename">"Project +configurations"</span>, select <span class="filename">"allexamples +-- Win32 Release"</span>, select <span class="filename">"ok".</span> +Select <span class="filename">"Build" -> "Build" +or "Rebuild All"</span> to build release version of project <span class="filename">"allexamples"</span>. </p> + + </li> + + </ul> + + <p>When the debug build or release build is done, there +should be the following subdirectories in c:\MyHDFstuff\hdf5\examples\</p> + + <ul class="normal"> + + <li>attributetest </li> + + <li>attributetestdll </li> + + <li>chunkread </li> + + <li>chunkreaddll </li> + + <li>compoundtest </li> + + <li>compoundtestdll </li> + + <li>extendwritetest </li> + + <li>extendwritetestdll </li> + + <li>grouptest </li> + + <li>grouptestdll </li> + + <li>readtestdll </li> + + <li>selectest </li> + + <li>selectestdll </li> + + <li>writetest </li> + + <li>writetestdll</li> + + </ul> + </li> + + <li> + <p>3. Install C Examples</p> + + </li> + + <li> + <p>Invoke a command prompt window and run the batch file <span class="filename">InstallExamples.bat</span> which +resides in the top level directory (<span class="filename">c:\MyHDFstuff\hdf5</span>). +This file creates 4 new directories, <span class="filename">examplesREL, +examplesRELDLL, examplesDBG, and examplesDBGDLL</span>, in the <span class="filename">c:\MyHDFstuff\hdf5\examples</span> +directory and places all the executables in it. Both the release and +debug versions of the examples should be built before this step is +done. </p> + + </li> + + <li> + <p>4.Test C examples</p> + + <p>We provide a batch file named <span class="filename">testExamples.bat</span> and an +expected examples tests output file named <span class="filename">testExamples_exp_output.txt</span> +in <span class="filename">c:\MyHDFstuff\hdf5\examples</span> +directory for you to test HDF5 C examples.</p> + + <p>testExamples.bat batch file has 4 options:</p> + + <ul class="normal"> + + <li>testExamples release -- for release version </li> + + <li>testExamples release dll -- for release DLL version + </li> + + <li>testExamples debug -- for debug version </li> + + <li>testExamples debug dll -- for debug DLL version</li> + + </ul> + + <p>Invoke a command prompt window and run testExamples +with appropriate options. You should get "All HDF5 C examples tests +passed." when the C examples are built successfully. Otherwise, the +difference between the expected outputs and actual outputs wil be +given. </p> + + </li> + </ul> - <p>When the debug build or release build is done, there should be the following - subdirectories in c:\MyHDFstuff\hdf5\examples\</p> - <ul class="normal"> - <li>attributetest </li> - <li>attributetestdll </li> - <li>chunkread </li> - <li>chunkreaddll </li> - <li>compoundtest </li> - <li>compoundtestdll </li> - <li>extendwritetest </li> - <li>extendwritetestdll </li> - <li>grouptest </li> - <li>grouptestdll </li> - <li>readtestdll </li> - <li>selectest </li> - <li>selectestdll </li> - <li>writetest </li> - <li>writetestdll</li> - </ul> - </li> - <li> - <p>3. Install C Examples</p> - </li> - <li> - <p>Invoke a command prompt window and run the batch file - <span class="filename">InstallExamples.bat</span> which resides in the top level - directory (<span class="filename">c:\MyHDFstuff\hdf5</span>). This file creates - 4 new directories, <span class="filename">examplesREL, examplesRELDLL, examplesDBG, - and examplesDBGDLL</span>, in the <span class="filename">c:\MyHDFstuff\hdf5\examples</span> - directory and places all the executables in it. Both the release and debug versions - of the examples should be built before this step is done. </p> - </li> - <li> - <p>4.Test C examples</p> - <p>We provide a batch file named <span class="filename">testExamples.bat</span> - and an expected examples tests output file named <span class="filename">testExamples_exp_output.txt</span> - in <span class="filename">c:\MyHDFstuff\hdf5\examples</span> directory for you - to test HDF5 C examples.</p> - <p>testExamples.bat batch file has 4 options:</p> - <ul class="normal"> - <li>testExamples release -- for release version </li> - <li>testExamples release dll -- for release DLL version </li> - <li>testExamples debug -- for debug version </li> - <li>testExamples debug dll -- for debug DLL version</li> - </ul> - <p>Invoke a command prompt window and run testExamples with appropriate options. - You should get "All HDF5 C examples tests passed." when the C examples are built - successfully. Otherwise, the difference between the expected outputs and actual - outputs wil be given. </p> - </li> - </ul> + </li> + <li> - <h3><a name="cppexamples"><u>How to build and test C++ examples</u></a></h3> - <ul class="intable"> - <li> - <p>1. Open C++ Examples Workspace</p> - <p>Invoke Microsoft Visual C++, go to <span class="filename">"File"</span> - and select the <span class="filename">"Open Workspace"</span> option.</p> - <p>Then open the workspace</p> - <p class="filename">c:\myHDFstuff\hdf5\windows\c++\examples\allcppexamples\allcppexamples.dsw.</p> - </li> - <li> - <p>2. Compile/Build C++ Examples</p> - <p>Select <span class="filename">"Build"</span>, then Select - <span class="filename">"Set Active Configuration"</span>.</p> + <h3><a name="cppexamples"><u>How to build +and test C++ examples</u></a></h3> + <ul class="intable"> + <li> - <p>To build debug versions of C++ examples,</p> - <p>In <span class="filename">"Project configurations"</span>, select - <span class="filename">"allcppexamples -- Win32 Debug"</span>, select - <span class="filename">"ok"</span>. Select <span class="filename">"Build" - -> "Build" or "Rebuild All"</span> to build debug version of project - <span class="filename">"allcppexamples".</span> </p> + <p>1. Open C++ Examples Workspace</p> + + <p>Invoke Microsoft Visual C++, go to <span class="filename">"File"</span> and select the <span class="filename">"Open Workspace"</span> option.</p> + + <p>Then open the workspace</p> + + <p class="filename">c:\myHDFstuff\hdf5\windows\c++\examples\allcppexamples\allcppexamples.dsw.</p> + </li> + <li> - <p>To build release versions of C++ examples,</p> - <p>In <span class="filename">"Project configurations"</span>, select - <span class="filename">"allcppexamples -- Win32 Release"</span>, select - <span class="filename">"ok"</span>. Select <span class="filename">"Build" - -> "Build" or "Rebuild All"</span> to build release version of project - <span class="filename">"allcppexamples".</span> </p> + <p>2. Compile/Build C++ Examples</p> + + <p>Select <span class="filename">"Build"</span>, +then Select <span class="filename">"Set Active +Configuration"</span>.</p> + + <ul class="intable"> + + <li> + <p>To build debug versions of C++ examples,</p> + + <p>In <span class="filename">"Project +configurations"</span>, select <span class="filename">"allcppexamples +-- Win32 Debug"</span>, select <span class="filename">"ok"</span>. +Select <span class="filename">"Build" -> "Build" +or "Rebuild All"</span> to build debug version of project <span class="filename">"allcppexamples".</span> </p> + + </li> + + <li> + <p>To build release versions of C++ examples,</p> + + <p>In <span class="filename">"Project +configurations"</span>, select <span class="filename">"allcppexamples +-- Win32 Release"</span>, select <span class="filename">"ok"</span>. +Select <span class="filename">"Build" -> "Build" +or "Rebuild All"</span> to build release version of project <span class="filename">"allcppexamples".</span> </p> + + </li> + + </ul> + + <p>When the debug build or release build is done, there +should be the following subdirectories in <span class="filename">c:\MyHDFstuff\hdf5\c++\examples\</span></p> + + <ul class="normal"> + + <li>chunkstest </li> + + <li>chunkstestdll </li> + + <li>compoundtest </li> + + <li>compoundtestdll </li> + + <li>createtest </li> + + <li>createtestdll </li> + + <li>extend_dstest </li> + + <li>extend_dstestdll </li> + + <li>h5grouptest </li> + + <li>h5grouptestdll </li> + + <li>readdatatest </li> + + <li>readdatatestdll </li> + + <li>writedatatest </li> + + <li>writedatatestdll </li> + + </ul> + </li> + + <li> + <p>3. Install C++ Examples</p> + + </li> + + <li> + <p>Invoke a command prompt window and run the batch file <span class="filename">InstallcppExamples.bat</span> which +resides in the top level directory (<span class="filename">c:\MyHDFstuff\hdf5</span>). +This file creates 4 new directories, <span class="filename">cppexamplesREL, +cppexamplesRELDLL, cppexamplesDBG, and cppexamplesDBGDLL</span>, +in the <span class="filename"> c:\MyHDFstuff\c++\examples</span> +directory and places all the executables in it. Both the release and +debug versions of the examples should be built before this step is +done. </p> + + </li> + + <li> + <p>4. Test C++ Examples</p> + + <p>We provide a batch file named <span class="filename">testcppExamples.bat</span> in <span class="filename">c:\MyHDFstuff\hdf5\c++\examples</span> +directory for you to test HDF5 C++ examples. </p> + + <p><span class="filename">testcppExamples.bat</span> +batch file has 4 options:</p> + + <ul class="normal"> + + <li>testcppExamples release -- for release version </li> + + <li>testcppExamples release dll -- for release DLL +version </li> + + <li>testcppExamples debug -- for debug version </li> + + <li>testcppExamples debug dll -- for debug DLL version</li> + + </ul> + + <p>Invoke a command prompt window and run testcppExamples +with appropriate options. You should get <span class="filename">"All +HDF5 C++ examples tests passed."</span> when the C++ examples are +built successfully. Otherwise, the difference between the expected +outputs and actual outputs will be given. </p> + + </li> + </ul> - <p>When the debug build or release build is done, there should be the following - subdirectories in <span class="filename">c:\MyHDFstuff\hdf5\c++\examples\</span></p> - <ul class="normal"> - <li>chunkstest </li> - <li>chunkstestdll </li> - <li>compoundtest </li> - <li>compoundtestdll </li> - <li>createtest </li> - <li>createtestdll </li> - <li>extend_dstest </li> - <li>extend_dstestdll </li> - <li>h5grouptest </li> - <li>h5grouptestdll </li> - <li>readdatatest </li> - <li>readdatatestdll </li> - <li>writedatatest </li> - <li>writedatatestdll </li> - </ul> - </li> - <li> - <p>3. Install C++ Examples</p> - </li> - <li> - <p>Invoke a command prompt window and run the batch file - <span class="filename">InstallcppExamples.bat</span> which resides in the top - level directory (<span class="filename">c:\MyHDFstuff\hdf5</span>). This file - creates 4 new directories, <span class="filename">cppexamplesREL, cppexamplesRELDLL, - cppexamplesDBG, and cppexamplesDBGDLL</span>, in the <span class="filename"> - c:\MyHDFstuff\c++\examples</span> directory and places all the executables in - it. Both the release and debug versions of the examples should be built before - this step is done. </p> - </li> - <li> - <p>4. Test C++ Examples</p> - <p>We provide a batch file named <span class="filename">testcppExamples.bat</span> - in <span class="filename">c:\MyHDFstuff\hdf5\c++\examples</span> directory for - you to test HDF5 C++ examples. </p> - <p><span class="filename">testcppExamples.bat</span> batch file has 4 options:</p> - <ul class="normal"> - <li>testcppExamples release -- for release version </li> - <li>testcppExamples release dll -- for release DLL version </li> - <li>testcppExamples debug -- for debug version </li> - <li>testcppExamples debug dll -- for debug DLL version</li> - </ul> - <p>Invoke a command prompt window and run testcppExamples with appropriate options. - You should get <span class="filename">"All HDF5 C++ examples tests passed."</span> - when the C++ examples are built successfully. Otherwise, the difference between - the expected outputs and actual outputs will be given. </p> - </li> - </ul> + </li> + <li> - <h3><a name="f90examples"><u>How to Build and test HDF5 Fortran examples:</u></a></h3> - <ul class="intable"> - <li> - <p>1. Open Fortran Examples Workspace</p> - <p>Invoke Compaq Visual Fortran or intel Fortran under Microsoft Visual studio - development environment, go to <span class="filename">"File"</span> and select - the <span class="filename">"Open Workspace" </span>option. </p> - <p>Then open the workspace</p> - <p class="filename">c:\MyHDFstuff\hdf5\windows\fortran\examples\allf90examples\allf90examples.dsw.</p> - </li> - <li> - <p>2. Compile/Build Fortran Examples</p> - <p>Select "Build", then Select "Set Active Configuration".</p> + <h3><a name="f90examples"><u>How to Build +and test HDF5 Fortran examples:</u></a></h3> + <ul class="intable"> + + <li> + <p>1. Open Fortran Examples Workspace</p> + + <p>Invoke Compaq Visual Fortran or intel Fortran under +Microsoft Visual studio development environment, go to <span class="filename">"File"</span> and select the <span class="filename">"Open Workspace" </span>option. </p> + + <p>Then open the workspace</p> + + <p class="filename">c:\MyHDFstuff\hdf5\windows\fortran\examples\allf90examples\allf90examples.dsw.</p> + + </li> + + <li> + <p>2. Compile/Build Fortran Examples</p> + + <p>Select "Build", then Select "Set Active Configuration".</p> + + <ul class="intable"> + + <li> + <p>To build debug versions of Fortran examples,</p> + + <p>In <span class="filename">"Project +configurations"</span>, select <span class="filename">"allf90examples +-- Win32 Debug"</span>, select <span class="filename">"ok"</span>. +Select <span class="filename">"Build" -> "Build" +or "Rebuild All"</span> to build debug version of project <span class="filename">"allf90examples".</span> </p> + + </li> + + <li> + <p>To build release versions of Fortran examples,</p> + + <p>In <span class="filename">"Project +configurations"</span>, select <span class="filename">"allf90examples +-- Win32 Release"</span>, select <span class="filename">"ok"</span>. +Select <span class="filename">"Build" -> "Build" +or "Rebuild All"</span> to build release version of project <span class="filename">"allf90examples".</span> </p> + + </li> + + </ul> + + <p>When the debug build or release build is done, there +should be the following subdirectories in <span class="filename">c:\MyHDFstuff\hdf5\fortran\examples\ + </span></p> + + <ul class="normal"> + + <li>attreexampletest </li> + + <li>attreexampletestdll </li> + + <li>compoundtest </li> + + <li>compoundtestdll </li> + + <li>dsetexampletest </li> + + <li>dsetexampletestdll </li> + + <li>fileexampletest </li> + + <li>fileexampletestdll </li> + + <li>groupexampletest </li> + + <li>groupexampletestdll </li> + + <li>grpdsetexampletest </li> + + <li>grpdsetexampletestdll </li> + + <li>grpittest </li> + + <li>grpittestdll </li> + + <li>grpsexampletest </li> + + <li>grpsexampletestdll </li> + + <li>hyperslabtest </li> + + <li>hyperslabtestdll </li> + + <li>mountexampletest </li> + + <li>mountexampletest </li> + + <li>refobjexampletest </li> + + <li>refobjexampletestdll </li> + + <li>refregexampletest </li> + + <li>refregexampletestdll </li> + + <li>rwdsetexampletest </li> + + <li>rwdsetexampletestdll </li> + + <li>selecteletest </li> + + <li>selecteletestdll</li> + + </ul> + + </li> + <li> - <p>To build debug versions of Fortran examples,</p> - <p>In <span class="filename">"Project configurations"</span>, select - <span class="filename">"allf90examples -- Win32 Debug"</span>, select - <span class="filename">"ok"</span>. Select <span class="filename">"Build" - -> "Build" or "Rebuild All"</span> to build debug version of project - <span class="filename">"allf90examples".</span> </p> + <p>3. Install Fortran Examples</p> + </li> + <li> - <p>To build release versions of Fortran examples,</p> - <p>In <span class="filename">"Project configurations"</span>, select - <span class="filename">"allf90examples -- Win32 Release"</span>, select - <span class="filename">"ok"</span>. Select <span class="filename">"Build" - -> "Build" or "Rebuild All"</span> to build release version of project - <span class="filename">"allf90examples".</span> </p> + <p>Invoke a command prompt window and run the batch file <span class="filename">Installf90Examples.bat</span> which +resides in the top level directory (<span class="filename">c:\MyHDFstuff\hdf5</span>). +This file creates 4 new directories, <span class="filename">f90examplesREL, +f90examplesRELDLL, f90examplesDBG, and f90examplesDBGDLL</span>, +in the <span class="filename"> +c:\MyHDFstuff\fortran\examples</span> directory and places all +the executables in it. Both the release and debug versions of the +examples should be built before this step is done. </p> + </li> + + <li> + <p>4. Test Fortran Examples</p> + + </li> + + <li> + <p>The batch file is not available for the time being.</p> + + </li> + </ul> - <p>When the debug build or release build is done, there should be the following - subdirectories in <span class="filename">c:\MyHDFstuff\hdf5\fortran\examples\ - </span></p> - <ul class="normal"> - <li>attreexampletest </li> - <li>attreexampletestdll </li> - <li>compoundtest </li> - <li>compoundtestdll </li> - <li>dsetexampletest </li> - <li>dsetexampletestdll </li> - <li>fileexampletest </li> - <li>fileexampletestdll </li> - <li>groupexampletest </li> - <li>groupexampletestdll </li> - <li>grpdsetexampletest </li> - <li>grpdsetexampletestdll </li> - <li>grpittest </li> - <li>grpittestdll </li> - <li>grpsexampletest </li> - <li>grpsexampletestdll </li> - <li>hyperslabtest </li> - <li>hyperslabtestdll </li> - <li>mountexampletest </li> - <li>mountexampletest </li> - <li>refobjexampletest </li> - <li>refobjexampletestdll </li> - <li>refregexampletest </li> - <li>refregexampletestdll </li> - <li>rwdsetexampletest </li> - <li>rwdsetexampletestdll </li> - <li>selecteletest </li> - <li>selecteletestdll</li> - </ul> - </li> - <li> - <p>3. Install Fortran Examples</p> - </li> - <li> - <p>Invoke a command prompt window and run the batch file - <span class="filename">Installf90Examples.bat</span> which resides in the top - level directory (<span class="filename">c:\MyHDFstuff\hdf5</span>). This file - creates 4 new directories, <span class="filename">f90examplesREL, f90examplesRELDLL, - f90examplesDBG, and f90examplesDBGDLL</span>, in the <span class="filename"> - c:\MyHDFstuff\fortran\examples</span> directory and places all the executables - in it. Both the release and debug versions of the examples should be built before - this step is done. </p> - </li> - <li> - <p>4. Test Fortran Examples</p> - </li> - <li> - <p>The batch file is not available for the time being.</p> - </li> - </ul> + </li> + <li> - <h3><a name="hlcexamples"><u>How to build and test HDF5 High Level C examples</u></a></h3> - <ul class="intable"> - <li> - <p>1. Open HL C Examples Workspace.</p> - <p>Invoke Microsoft Visual C++ 6.0, go to <span class="filename">"File"</span> - and select the <span class="filename">"Open Workspace" </span>option.</p> - <p>Then open the workspace</p> - <p class="filename">c:\MyHDFstuff\hdf5\windows\hl\hl_c_examples\hl_c_examples.dsw.</p> - </li> - <li> - <p>2. Compile/Build HL C Examples</p> - <p>Select <span class="filename">"Build"</span>, then Select - <span class="filename">"Set Active Configuration".</span></p> + <h3><a name="hlcexamples"><u>How to build +and test HDF5 High Level C examples</u></a></h3> + <ul class="intable"> + <li> - <p>To build debug versions of High Level C examples,</p> - <p>In <span class="filename">"Project configurations"</span>, select - <span class="filename">"hl_c_examples -- Win32 Debug"</span>, select - <span class="filename">"ok"</span>. Select <span class="filename">"Build" - -> "Build" or "Rebuild All"</span> to build debug version of project - <span class="filename">"hl_c_examples"</span>. </p> + <p>1. Open HL C Examples Workspace.</p> + + <p>Invoke Microsoft Visual C++ 6.0, go to <span class="filename">"File"</span> and select the <span class="filename">"Open Workspace" </span>option.</p> + + <p>Then open the workspace</p> + + <p class="filename">c:\MyHDFstuff\hdf5\windows\hl\hl_c_examples\hl_c_examples.dsw.</p> + </li> + <li> - <p>To build release versions of High Level C examples,</p> - <p>In <span class="filename">"Project configurations"</span>, select - <span class="filename">"hl_c_examples -- Win32 Release"</span>, select - <span class="filename">"ok"</span>. Select <span class="filename">"Build" - -> "Build" or "Rebuild All"</span> to build release version of project - <span class="filename">"hl_c_examples"</span>. </p> + <p>2. Compile/Build HL C Examples</p> + + <p>Select <span class="filename">"Build"</span>, +then Select <span class="filename">"Set Active +Configuration".</span></p> + + <ul class="intable"> + + <li> + <p>To build debug versions of High Level C examples,</p> + + <p>In <span class="filename">"Project +configurations"</span>, select <span class="filename">"hl_c_examples +-- Win32 Debug"</span>, select <span class="filename">"ok"</span>. +Select <span class="filename">"Build" -> "Build" +or "Rebuild All"</span> to build debug version of project <span class="filename">"hl_c_examples"</span>. </p> + + </li> + + <li> + <p>To build release versions of High Level C examples,</p> + + <p>In <span class="filename">"Project +configurations"</span>, select <span class="filename">"hl_c_examples +-- Win32 Release"</span>, select <span class="filename">"ok"</span>. +Select <span class="filename">"Build" -> "Build" +or "Rebuild All"</span> to build release version of project <span class="filename">"hl_c_examples"</span>. </p> + + </li> + + </ul> + + <p>When the debug build or release build is done, there +should be the following subdirectories in <span class="filename">c:\MyHDFstuff\hdf5\hl\hl_c_examples. + </span></p> + + <ul class="normal"> + + <li>ex_images </li> + + <li>ex_imagesdll </li> + + <li>ex_lite </li> + + <li>ex_litedll </li> + + <li>ex_table </li> + + <li>ex_tabledll</li> + + <li>ex_ds</li> + + <li>ex_dsdll</li> + + <li>ex_packet</li> + + <li>ex_packetdll</li> + + </ul> + </li> - </ul> - <p>When the debug build or release build is done, there should be the following - subdirectories in <span class="filename">c:\MyHDFstuff\hdf5\hl\hl_c_examples. - </span></p> - <ul class="normal"> - <li>ex_images </li> - <li>ex_imagesdll </li> - <li>ex_lite </li> - <li>ex_litedll </li> - <li>ex_table </li> - <li>ex_tabledll</li> - <li>ex_ds</li> - <li>ex_dsdll</li> - <li>ex_packet</li> - <li>ex_packetdll</li> - </ul> - </li> - <li> - <p>3. Install HL C examples</p> - </li> - <li> - <p>Invoke a command prompt window and run the batch file - <span class="filename">Install_hlcexamples.bat</span> which resides in the top - level directory (<span class="filename">c:\MyHDFstuff\hdf5</span>). This file - creates 4 new directories, <span class="filename">HLCexamplesRELEASE, HLCexamplesRELEASEDLL, - HLCexamplesDEBUG, and HLCexamplesDEBUGDLL</span> in the - <span class="filename">c:\MyHDFstuff\hl\hl_c_examples</span> directory and places - all the executables in it. Both the release and debug versions of the examples - should be built before this step is done. </p> - </li> - <li> - <p>4. Test HL C examples</p> - <p>We provide a batch file named <span class="filename">test_hl_cexamples.bat</span> - in <span class="filename">c:\MyHDFstuff\hdf5\hl\hl_c_examples\</span> directory - for you to test HDF5 High Level C examples. </p> - <p><span class="filename">test_hl_cexamples.bat</span> batch file has 4 options:</p> - <ul class="normal"> - <li>test_hl_cexamples release -- for release version </li> - <li>ttest_hl_cexamples release dll -- for release DLL version </li> - <li>test_hl_cexamples debug -- for debug version </li> - <li>test_hl_cexamples debug dll -- for debug DLL version</li> - </ul> - - <p>Invoke a command prompt window and run <span class="filename">test_hl_cexamples.bat</span> - with appropriate options. When you run <span class="filename">"test_hl_cexamples - release"</span>, When you run "test_hl_cexamples.bat" with each option, if you see the - following messages at the end: </p> - - <p class="insmes"> All of the HL C Examples Passed!</p> - - <p>You have built HL C examples successfully. Otherwise, HL C examples Failed to build.</p> - - - <h3><a name="hlf90examples"><u>How to build and test HDF5 High Level Fortran examples:</u></a></h3> - <ul class="intable"> - <li> - <p>1. Open HL Fortran Examples Workspace</p> - </li> - <li> - <p>Invoke Compaq Visual Fortran 6.6c, open the workspace <span class="filename">c:\MyHDFstuff\hdf5\windows\hl\fortran\examples\allhlf90examples\allhlf90examples.dsw</span> - </p> - </li> - <li> - <p>2. Compile/Build HL Fortran Examples</p> - <p>Select "Build", then Select "Set Active Configuration"</p> - <ul class="intable"> <li> - <p>To build debug versions of High Level Fortran examples,</p> - <p>In "Project configurations", select "allhlf90examples -- Win32 Debug", select "ok". Select - "Build" -> "Build" or "Rebuild All" to build debug version of project "allhlf90examples". - </p> + <p>3. Install HL C examples</p> + </li> + <li> - <p>To build release versions of Fortran examples.</p> - <p>In "Project configurations", select "allhlf90examples -- Win32 Release", select "ok". Select - "Build" -> "Build" or "Rebuild All" to build release version - of project "allhlf90examples". - </p> + <p>Invoke a command prompt window and run the batch file <span class="filename">Install_hlcexamples.bat</span> which +resides in the top level directory (<span class="filename">c:\MyHDFstuff\hdf5</span>). +This file creates 4 new directories, <span class="filename">HLCexamplesRELEASE, +HLCexamplesRELEASEDLL, HLCexamplesDEBUG, and HLCexamplesDEBUGDLL</span> +in the <span class="filename">c:\MyHDFstuff\hl\hl_c_examples</span> +directory and places all the executables in it. Both the release and +debug versions of the examples should be built before this step is +done. </p> + </li> + + <li> + <p>4. Test HL C examples</p> + + <p>We provide a batch file named <span class="filename">test_hl_cexamples.bat</span> in <span class="filename">c:\MyHDFstuff\hdf5\hl\hl_c_examples\</span> +directory for you to test HDF5 High Level C examples. </p> + + <p><span class="filename">test_hl_cexamples.bat</span> +batch file has 4 options:</p> + + <ul class="normal"> + + <li>test_hl_cexamples release -- for release version </li> + + <li>ttest_hl_cexamples release dll -- for release DLL +version </li> + + <li>test_hl_cexamples debug -- for debug version </li> + + <li>test_hl_cexamples debug dll -- for debug DLL version</li> + + </ul> + + <p>Invoke a command prompt window and run <span class="filename">test_hl_cexamples.bat</span> with +appropriate options. When you run <span class="filename">"test_hl_cexamples +release"</span>, When you run "test_hl_cexamples.bat" with each +option, if you see the following messages at the end: </p> + + <p class="insmes"> All of the HL C Examples Passed!</p> + + <p>You have built HL C examples successfully. Otherwise, +HL C examples Failed to build.</p> + + <h3><a name="hlf90examples"><u>How +to build and test HDF5 High Level Fortran examples:</u></a></h3> + + <ul class="intable"> + + <li> + <p>1. Open HL Fortran Examples Workspace</p> + + </li> + + <li> + <p>Invoke Compaq Visual Fortran 6.6c, open the +workspace <span class="filename">c:\MyHDFstuff\hdf5\windows\hl\fortran\examples\allhlf90examples\allhlf90examples.dsw</span> + </p> + + </li> + + <li> + <p>2. Compile/Build HL Fortran Examples</p> + + <p>Select "Build", then Select "Set Active +Configuration"</p> + + <ul class="intable"> + + <li> + <p>To build debug versions of High Level Fortran +examples,</p> + + <p>In "Project configurations", select +"allhlf90examples -- Win32 Debug", select "ok". Select "Build" +-> "Build" or "Rebuild All" to build debug version of project +"allhlf90examples". </p> + + </li> + + <li> + <p>To build release versions of Fortran examples.</p> + + <p>In "Project configurations", select +"allhlf90examples -- Win32 Release", select "ok". Select "Build" +-> "Build" or "Rebuild All" to build release version of project +"allhlf90examples". </p> + + </li> + + </ul> + + <p> When the debug build or release build is done, +there should be the following subdirectories in <span class="filename">c:\MyHDFstuff\hdf5\hl\fortran\examples</span></p> + + <ul class="normal"> + + <li>ex_lite</li> + + <li>ex_litedll</li> + + </ul> + + </li> + + <li> + <p>3. Install HL Fortran Examples</p> + + <p>Invoke a command prompt window and run the batch +file<span class="filename">Install_hlf90examples.bat</span> +which resides in the top level directory <span class="filename">(c:\MyHDFstuff\hdf5)</span>. +This file creates 4 new directories, <span class="filename">HLf90examplesRELEASE, +HLf90examplesRELEASEDLL, HLf90examplesDEBUG,and HLf90examplesDEBUGDLL,</span> +in the directory <span class="filename">c:\MyHDFstuff\hdf5\hl\fortran\examples + </span> and places all the executables in it. Both +the release and debug versions of the examples should be built before +this step is done.</p> + + </li> + + <li> + <p>4. Test HL Fortran Examples</p> + + <p>We provide a batch file named <span class="filename">test_hl_f90examples.bat</span> in +directory <span class="filename"> +c:\MyHDFstuff\hdf5\hl\fortran\examples </span>for you to test +HDF5 high level fortran examples.</p> + + <p><span class="filename">test_hl_f90examples.bat</span> +batch file has 4 options:</p> + + <ul class="normal"> + + <li>test_hl_f90examples release -- for release +version</li> + + <li>test_hl_f90examples release dll -- for release +DLL version</li> + + <li>test_hl_f90examples debug -- for debug version</li> + + <li>test_hl_f90examples debug dll -- for debug DLL +version</li> + + </ul> + + <p>Invoke a command prompt window and run <span class="filename">test_hl_f90examples.bat</span> with +appropriate options.</p> + + <p>When you run "test_hl_f90examples release", the +output will look like:</p> + + <ul class="normal"> + + <li>release version of High Level Fortran examples +PASSED</li> + + </ul> + + <p>Similar messages should be generated with another +three options If the high level Fortran examples are built successfully.</p> + + </li> + + </ul> + + </li> + </ul> - - <p> When the debug build or release build is done, there should be the following subdirectories in <span class="filename">c:\MyHDFstuff\hdf5\hl\fortran\examples</span></p> - <ul class="normal"> - <li>ex_lite</li> - <li>ex_litedll</li> - </ul> - </li> - <li> - <p>3. Install HL Fortran Examples</P> - <p>Invoke a command prompt window and run the batch file<span class="filename">Install_hlf90examples.bat</span> - which resides in the top level directory <span class="filename">(c:\MyHDFstuff\hdf5)</span>. This file creates 4 new directories, - <span class="filename">HLf90examplesRELEASE, HLf90examplesRELEASEDLL, HLf90examplesDEBUG,and HLf90examplesDEBUGDLL,</span> in the directory - <span class="filename">c:\MyHDFstuff\hdf5\hl\fortran\examples </span> and places all the executables in it. Both the release - and debug versions of the examples should be built before this step is done.</p> - </li> - <li> - <p>4. Test HL Fortran Examples</p> - <p>We provide a batch file named <span class="filename">test_hl_f90examples.bat</span> in directory <span class="filename"> - c:\MyHDFstuff\hdf5\hl\fortran\examples </span>for you to test HDF5 high level fortran examples.</p> - <p><span class="filename"> test_hl_f90examples.bat</span> batch file has 4 options:</p> - <ul class="normal"> - <li>test_hl_f90examples release -- for release version</li> - <li>test_hl_f90examples release dll -- for release DLL version</li> - <li>test_hl_f90examples debug -- for debug version</li> - <li>test_hl_f90examples debug dll -- for debug DLL version</li> - </ul> - - <p>Invoke a command prompt window and run <span class="filename">test_hl_f90examples.bat</span> with appropriate options.</p> - <p>When you run "test_hl_f90examples release", the output will look like:</p> - <ul class="normal"> - <li>release version of High Level Fortran examples PASSED</li> - </ul> - <p>Similar messages should be generated with another three options If the high level Fortran examples are built successfully.</p> - - </li> - </ul> -</ul> -<p class="right"><a href="#section3_examples">Go to TOP Section III</a></p> -<p class="right"><a href="#content_table">Go to Table of Contents</a></p> -<hr class="second" /> -<h2><a name="section4">Section IV: Building an application using the HDF5 library -or DLL</a></h2> -<hr class="second"> -<p class="note">Warnings:</p> -<p class="note">The instructions below will only describe how to build an application using the -release version of the HDF5 library or DLL. To use the debug version of the HDF5 -library or DLL, you need to substitute the release version of the HDF5 library or + <p class="right"><a href="#section3_examples">Go +to TOP Section III</a></p> + + <p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + + <hr class="second"> + <h2><a name="section4">Section IV: Building an +application using the HDF5 library or DLL</a></h2> + + <hr class="second"> + <p class="note">Warnings:</p> + + <p class="note">The instructions below will only +describe how to build an application using the release version of the +HDF5 library or DLL. To use the debug version of the HDF5 library or +DLL, you need to substitute the release version of the HDF5 library or DLL with the debug version. </p> -<ul class="intable"> - <li> - <h3>1. To use HDF5 static library</h3> -<ul class="intable"> - <li><p>To build an application using HDF5 Static Library, the following locations - will need to be specified for locating header files and linking with the HDF static - library, for example: </p> - <ul class="normal"> - <li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\include</span></li> - <li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\lib</span></li> - </ul> - </li> - <li><p>If you have installed HDF5 library in - <a href="#step3_section2">Section II, step 3</a>, We assume that - you will use Zlib and Szip compression with HDF5 library. </p></li> - <li><p>To specify these locations in the settings for your VC++ project, you may choose - one of the following two methods.</p> - <ul class="intable"> - <li> - <h4><u>Method One</u></h4> + <ul class="intable"> - <li> - <h4><a name="method1_header">To insert the path that specifies HDF5 and Zlib, - Szip header files:</a></h4> - <ol style="LIST-STYLE-TYPE: lower-roman"> + <li> - <p>Open your VC++ project in Microsoft Visual C++ and make sure it is the - active project. </p> + <h3>1. To use HDF5 static library</h3> + + <ul class="intable"> + + <li> + <p>To build an application using HDF5 Static Library, +the following locations will need to be specified for locating header +files and linking with the HDF static library, for example: </p> + + <ul class="normal"> + + <li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\include</span></li> + + <li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\lib</span></li> + + </ul> + + </li> + + <li> + <p>If you have installed HDF5 library in <a href="#step3_section2">Section II, step 3</a>, We +assume that you will use Zlib and Szip compression with HDF5 library. </p> + + </li> + + <li> + <p>To specify these locations in the settings for +your VC++ project, you may choose one of the following two methods.</p> + + <ul class="intable"> + + <li> + <h4><u>Method One</u></h4> + + <ul class="intable"> + + <li> + <h4><a name="method1_header">To +insert the path that specifies HDF5 and Zlib, Szip header files:</a></h4> + + <ol style="list-style-type: lower-roman;"> + + <li> + <p>Open your VC++ project in Microsoft +Visual C++ and make sure it is the active project. </p> + + </li> + + <li> + <p>Go to the <span class="filename">Project</span> +menu and chose the <span class="filename">"Settings"</span> +option.</p> + + </li> + + <li> + <p>Choose the build configuration you +would like to modify in the drop down menu labeled with <span class="filename">"Settings For:"</span></p> + + </li> + + <li> + <p>Choose the <span class="filename">C/C++</span> +tab</p> + + </li> + + <li> + <p>Choose <span class="filename">"Preprocessor</span>" +in the drop down menu labeled with <span class="filename">"Category:"</span></p> + + </li> + + <li> + <p>In a text-area labeled with +"Additional include directories:", add HDF5, Zlib, and Szip header +files directories. For example:</p> + + <ul class="normal"> + + <li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\include + </span> </li> + + <li><span class="filename">c:\zlib122\include + </span> </li> + + <li><span class="filename">c:\szip\include</span></li> + + </ul> + + <p>Then click OK.</p> + + </li> + + <li> + <p>(optional) to use HDF5 Fortran static +library, the location of Fortran module files should be specified by +following<span class="filename"> +Project->Settings->Fortran->Preprocessor</span>, +and in a test-area labeled with <span class="filename">"INCLUDE +and USE Paths:"</span>, add HDF5 Fortran module files +directories. For example: </p> + + <ul class="normal"> + + <li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\include</span></li> + + </ul> + + </li> + + </ol> + + </li> + + <li> + <h4><a name="link_hdf5">To link +the HDF5 library with your application:</a></h4> + + <ol style="list-style-type: lower-roman;"> + + <li> + <p>Open your VC++ project in Microsoft +Visual C++ and make sure it is the active project.</p> + + </li> + + <li> + <p>Go to the <span class="filename">Project</span> +menu and chose the <span class="filename">"Add to Project"</span> +option and then <span class="filename">"Files"</span> +option.</p> + + </li> + + <li> + <p>Change the <span class="filename">"Files +of type:"</span> to <span class="filename">"Library +Files (.lib)".</span></p> + + </li> + + <li> + <p>Navigate through the directories until +you find the location of the <span class="filename">hdf5.lib</span>. + </p> + + </li> + + <li> + <p>Select <span class="filename">hdf5.lib</span> +and click <span class="filename">OK</span>.</p> + + </li> + + <li> + <p>repeat step i-v, to select<span class="filename"> zdll.lib and szlibdll.lib</span>.</p> + + </li> + + <li> + <p>(optional) repeat step i-v, to select <span class="filename">hdf5_cpp.lib</span> to link with HDF5 +C++ static library.</p> + + </li> + + <li> + <p>(optional) repeat step i-v5, to select + <span class="filename">hdf5_fortran.lib</span> +to link with HDF5 Fortran static library.</p> + + </li> + + </ol> + + </li> + + </ul> + + </li> + + <li> + <h4><u>Method Two</u></h4> + + <blockquote> + <ol style="list-style-type: lower-roman;"> + + <li> + <p>Go to <span class="filename">Tools->Options->Directorie</span>s,</p> + + </li> + + <li> + <p>Insert the correct HDF5, Zlib, Szip +paths for both headers (include) and libraries. For example, </p> + + <ul class="normal"> + + <li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\include + </span> </li> + + <li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\lib + </span> </li> + + <li><span class="filename">c:\zlib122\include + </span> </li> + + <li><span class="filename">c:\zlib122\lib + </span> </li> + + <li><span class="filename">c:\szip\include + </span> </li> + + <li><span class="filename">c:\szip\dl</span>l</li> + + </ul> + + </li> + + <li> + <p>Go to the <span class="filename">Project</span> +menu and choose the <span class="filename">"Settings"</span> +option.</p> + + </li> + + <li> + <p>Find the <span class="filename">"link"</span> +option and <span class="filename">"Input"</span> +category, insert <span class="filename">"zdll.lib, +szlibdll.lib, hdf5.lib"</span>.</p> + + </li> + + <li> + <p>(Optional) repeat step iii-iv, to insert + <span class="filename">"hdf5_cpp.lib"</span> +if you want to use HDF5 C++ static library.</p> + + </li> + + <li> + <p>(Optional) repeat step iii-iv, to insert + <span class="filename">"hdf5_fortran.lib"</span> +if you want to use HDF5 Fortran static library.</p> + + </li> + + </ol> + + </blockquote> + + </li> + + </ul> + + </li> + + </ul> + </li> + <li> - <p>Go to the <span class="filename">Project</span> menu and chose the - <span class="filename">"Settings"</span> option.</p> + <h3>2. To use HDF5 Dynamic Link Library</h3> + + <blockquote> + <ol style="list-style-type: lower-roman;"> + + <li> + <p>Follow the steps for specifying the location of +the header files as shown in <a href="#method1_header">Method +One.</a></p> + + </li> + + <li> + <p>Follow the steps for linking the HDF5 library as +shown in <a href="#link_hdf5">Method One.</a> +except now link the export library that is created with the DLL. The +export library is called <span class="filename">hdf5dll.lib</span> +for HDF5 C libray, <span class="filename">hdf5_cppdll.lib</span> +for HDF5 C++ library, and <span class="filename">hdf5_fortrandll.lib</span> +for HDF5 Fortran library.</p> + + </li> + + <li> + <p>Place the DLL in a location that Windows will be +able to locate it. The searched path and order for DLL's is</p> + + <ol> + + <li> + <p>The Windows system directory. The +GetSystemDirectory function retrieves the path of this directory.</p> + + </li> + + <li> + <p>The Windows directory. The +GetWindowsDirectory function retrieves the path of this directory.</p> + + </li> + + <li> + <p>The directories listed in the PATH +environment variable.</p> + + </li> + + </ol> + + </li> + + <li> + <p>To modify your own application settings, please +DO FOLLOW the<a href="#section11_pointers"> "DLL Hints" at +Section XI "HELPFUL POINTERS".</a></p> + + </li> + + </ol> + + </blockquote> + </li> + + </ul> + + <p class="right"><a href="#section4">Go +to TOP Section IV</a></p> + + <p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + + <hr class="second"> + <h2><a name="section5">Section V: How to disable +Gzip(Zlib)/Szip compression</a></h2> + + <hr class="second"> + <p class="note">Warnings:</p> + + <p class="note">When you modify the H5pubconf.h file +as described below, DO NOT just change the values of these macros from +1 to 0. Please DO remove (or comment out) appropriate lines. </p> + + <ul class="intable"> + <li> - <p>Choose the build configuration you would like to modify in the drop down - menu labeled with <span class="filename">"Settings For:"</span></p> + <h3>1. Disable Gzip compression</h3> + + <ul class="intable"> + + <li> + <p>If you would like to remove Gzip compression from +the HDF5 library, follow the steps below.</p> + + <ul class="intable"> + + <p></p> + + <li>1.1 Open the H5pubconf.h file from the <span class="filename">c:\MyHDFstuff\hdf5\src</span> +directory and remove (or comment out) the following two lines: + <ul class="normal"> + + <li> + <p class="insmes">#define +H5_HAVE_ZLIB_H 1 </p> + + </li> + + <li> + <p class="insmes">#define +H5_HAVE_FILTER_DEFLATE 1</p> + + </li> + + </ul> + +then save the file. </li> + + <li>1.2 Delete HDF5_EXT_ZLIB environment variable +if you have set it in preconditions.</li> + + <li>1.3 Run-compile HDF5 library according to <a href="#section2">Section II.</a></li> + + </ul> + + </li> + + <li> + <p>When you disable Gzip, you may get the following +message when building HDF5 libraries:</p> + + <ul class="normal"> + + <li>The following environment variables were not +found $(HDF5_EXT_ZLIB)</li> + + </ul> + + </li> + + <li> + <p>This message can be ignored.</p> + + </li> + + </ul> + </li> + <li> - <p>Choose the <span class="filename">C/C++</span> tab</p> + <h3>2. Disable Szip compression (both encoder and decoder)</h3> + + <ul class="intable"> + + <li> + <p>If you would like to remove Szip compression from +the HDF5 library, follow the steps below.</p> + + <ul class="intable"> + + <li>2.1 Open the H5pubconf.h file from the <span class="filename">c:\MyHDFstuff\hdf5\src</span> +directory and remove (or comment out) the following two lines: + <ul class="normal"> + + <li> + <p class="insmes">#define +H5_HAVE_SZLIB_H 1 </p> + + </li> + + <li> + <p class="insmes">#define +H5_HAVE_FILTER_SZIP 1</p> + + </li> + + </ul> + + </li> + + <li>then save the file.</li> + + <li>2.2 Delete <span class="filename">HDF5_EXT_SZIP</span> +environment variable if you have set it in preconditions.</li> + + <li>2.3 Run-compile HDF5 library according to <a href="#section2">Section II.</a> </li> + + </ul> + + <p>When you disable Szip, you may get the following +message when building HDF5 libraries: </p> + + <ul class="normal"> + + <li>The following environment variables were not +found $(HDF5_EXT_SZIP)</li> + + </ul> + + <p>This message can be ignored.</p> + + <p class="note">Notes:</p> + + <p class="note">To disable Gzip and Szip at +the same time, just follow 1.1~1.3 and 2.1~2.3 and run-compile HDF5 +library according to<a href="#section2"> Section II.</a></p> + + </li> + + </ul> + </li> + <li> - <p>Choose <span class="filename">"Preprocessor</span>" in the drop down menu - labeled with <span class="filename">"Category:"</span></p> + <h3>3. Disable Szip encoder</h3> + + <p>If you would like to just disable Szip encoder from +the HDF5 library while keeping Szip decoder enabled, follow the steps +below. </p> + + <blockquote> + <ul class="intable"> + + <li>3.1 Download Szip library without encoder</li> + + <li>Szip library is different if you want to disable +Szip encoder. Download <span class="filename">szip_noencoder</span> +binaries from <a href="ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/" target="blank" ,=""> +ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/.</a> +The Szip +library and header path should also be set up accordingly (refer to <a href="#precondition6">Precondition 6.)</a> + <p></p> + + </li> + + <li>3.2 Run-compile HDF5 library according to <a href="#section2">Section II.</a></li> + + </ul> + + </blockquote> + </li> + + </ul> + + <p class="right"><a href="#section5">Go +to TOP Section V</a></p> + + <p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + + <hr class="second"> + <h2><a name="section6">Section VI: How to build +HDF5 in Microsoft Visual Studio .Net 2003</a> </h2> + + <hr class="second"> + <ul class="intable"> + <li> - <p>In a text-area labeled with "Additional include directories:", add HDF5, - Zlib, and Szip header files directories. For example:</p> - <ul class="normal"> - <li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\include </span> </li> - <li><span class="filename">c:\zlib122\include </span> </li> - <li><span class="filename">c:\szip\include</span></li> - </ul> - <p>Then click OK.</p> + <h3>1. Open the workspace </h3> + + <ul class="intable"> + + <li> + <p>Invoke Microsoft Visual C++ .Net 2003. From the +main menu, go to "File" and select "Open Solution". In the "Open +Solution" window, Change "Files of type" to "All Project Files". Choose +"all.dsw" under the directory c:\MyHDFstuff\hdf5\windows\proj\all. In +the pop up window, choose "Yes To All" to convert all project files to +Visual C++ .Net project format.</p> + + </li> + + <li> + <p class="note">Notes: If you are +not in <a href="#section10"> Section X How to build HDF5 +with Thread-Safe Feature</a>, ttsafedll.dsp should be turned off +always.</p> + + </li> + + </ul> + </li> + <li> - <p>(optional) to use HDF5 Fortran static library, the location of Fortran - module files should be specified by following<span class="filename"> Project->Settings->Fortran->Preprocessor</span>, - and in a test-area labeled with <span class="filename">"INCLUDE and USE Paths:"</span>, - add HDF5 Fortran module files directories. For example: </p> - <ul class="normal"> - <li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\include</span></li> - </ul> + <h3>2. Building HDF5 C/C++ Libraries</h3> + + <ul class="intable"> + + <li> + <p>Users can choose the desirable libraries to be +built according to the following description.</p> + + </li> + + <li> + <h5>2.1 If you don't want to build HDF5 C++ Libraries</h5> + + <p>Go to <span class="filename">"Build"</span> +and select<span class="filename"> "Configuration Manager"</span>. +Choose <span class="filename">"Release"</span> or <span class="filename">"Debug"</span> under <span class="filename">"Active Solution Configuration" </span> + </p> + + <ul class="intable"> + + <li>Disable the following projects: + <ul class="normal"> + + <li>dsets_cpp </li> + + <li>dsets_cppdll </li> + + <li>hdf5_cpp </li> + + <li>hdf5_cppdll </li> + + <li>testhdf5_cpp </li> + + <li>testhdf5_cppdll </li> + + <li>hdf5_hl_cpp</li> + + <li>hdf5_hl_cppdll </li> + + <li>hl_test_table_cpp</li> + + <li>hl_test_table_cppdll </li> + + <li>ttsafedll</li> + + </ul> + + </li> + + </ul> + + </li> + + <li> + <h5>2.2 If you don't want to build HDF5 Fortran +Libraries</h5> + + <p>Go to <span class="filename">"Build"</span> +and select <span class="filename">"Configuration Manager"</span>. +Choose <span class="filename">"Release"</span> or <span class="filename">"Debug"</span> under <span class="filename">"Active Solution Configuration" </span> + </p> + + <ul class="intable"> + + <li>Disable the following projects: + <ul class="normal"> + + <li>flush1_fortran </li> + + <li>flush1_fortrandll </li> + + <li>flush2_fortran </li> + + <li>flush2_fortrandll </li> + + <li>hdf5_f90cstub </li> + + <li>hdf5_f90cstubdll </li> + + <li>hdf5_fortran </li> + + <li>hdf5_fortrandll </li> + + <li>libtest_cstubdll </li> + + <li>libtest_fortran </li> + + <li>libtest_fortrandll </li> + + <li>testhdf5_fortran </li> + + <li>testhdf5_fortrandll </li> + + <li>hdf5_hl_fortran</li> + + <li>hdf5_hl_fortrandll</li> + + <li>hdf5_hl_f90cstubdll </li> + + <li>hl_test_image_fortran</li> + + <li>hl_test_image_fortrandll </li> + + <li>hl_test_lite_fortran</li> + + <li>hl_test_lite_fortrandll </li> + + <li>hl_test_table_fortran</li> + + <li>hl_test_table_fortrandll</li> + + <li>ttsafedll</li> + + </ul> + + </li> + + </ul> + + </li> + + <li> + <h5>2.3 If you don't want to build HDF5 High-Level +Libraries</h5> + + <p>Go to <span class="filename">"Build"</span> +and select <span class="filename">"Configuration Manager"</span>. +Choose <span class="filename">"Release"</span> or <span class="filename">"Debug"</span> under <span class="filename">"Active Solution Configuration" </span> + </p> + + <ul class="intable"> + + <li>Disable the following projects: + <ul class="normal"> + + <li>hdf5_hl </li> + + <li>hdf5_hldll</li> + + <li>hl_test_image</li> + + <li>hl_test_imagedll </li> + + <li>hl_test_lite </li> + + <li>hl_test_litedll</li> + + <li>hl_test_table </li> + + <li>hl_test_tabledll</li> + + <li>hl_test_ds </li> + + <li>hl_test_dsdll</li> + + <li>hl_test_packet</li> + + <li>hl_test_packetdll</li> + + <li>ttsafedll</li> + + </ul> + + </li> + + </ul> + + </li> + + <li> + <h5>2.4 If you want to build HDF5 C++ libarty without +High-Level C++ Libraries</h5> + + <p>Go to <span class="filename">"Build"</span> +and select <span class="filename">"Configuration Manager"</span>. +Choose <span class="filename">"Release"</span> or <span class="filename">"Debug"</span> under <span class="filename">"Active Solution Configuration" </span> + </p> + + <ul class="intable"> + + <li>Disable the following projects: + <ul class="normal"> + + <li>hdf5_hl_cpp </li> + + <li>hdf5_hl_cppdll</li> + + <li>hl_test_table_cpp</li> + + <li>hl_test_table_cppdll</li> + + <li>ttsafedll</li> + + </ul> + + </li> + + </ul> + + </li> + + <li> + <h5>2.5 If you want to build HDF5 Fortran Libraries +without High-Level Fortran Libraries</h5> + + <p>Go to <span class="filename">"Build"</span> +and select <span class="filename">"Configuration Manager"</span>. +Choose <span class="filename">"Release"</span> or <span class="filename">"Debug"</span> under <span class="filename">"Active Solution Configuration" </span> + </p> + + <ul class="intable"> + + <li>Disable the following projects: + <ul class="normal"> + + <li>hdf5_hl_fortran </li> + + <li>hdf5_hl_fortrandll</li> + + <li>hdf5_hl_f90cstubdll</li> + + <li>hl_test_image_fortran </li> + + <li>hl_test_image_fortrandll</li> + + <li>hl_test_lite_fortran </li> + + <li>hl_test_lite_fortrandll</li> + + <li>hl_test_table_fortran </li> + + <li>hl_test_table_fortrandll</li> + + <li>ttsafedll</li> + + </ul> + + </li> + + </ul> + + </li> + + </ul> + </li> - </ol> - </li> - <li> - <h4><a name="link_hdf5">To link the HDF5 library with your application:</a></h4> - <ol style="LIST-STYLE-TYPE: lower-roman"> + <li> - <p>Open your VC++ project in Microsoft Visual C++ and make sure it is the - active project.</p> + <p> </p> + </li> + <li> - <p>Go to the <span class="filename">Project</span> menu and chose the - <span class="filename">"Add to Project"</span> option and then - <span class="filename">"Files"</span> option.</p> + <p>Find <span class="filename">"Build"</span> +and go to <span class="filename">"Configuration Manager"</span>; +choose <span class="filename">"release"</span> or <span class="filename">"debug"</span>, then choose <span class="filename">"build all"</span> to build HDF5 with +desired options.</p> + </li> + + </ul> + + <p class="note">Notes:</p> + + <ul class="intable"> + <li> - <p>Change the <span class="filename">"Files of type:"</span> to - <span class="filename">"Library Files (.lib)".</span></p> + <p class="note">1. You need to specify +the <span class="filename">zlib</span> and <span class="filename">szip</span> include header files and +libraries under<span class="filename"> Tools +->Options->Projects->VC++</span> Directories +and choose Include and libraries under the category of <span class="filename">"show directories for"</span> to add +the corresponding path if you want to use compression feature inside +HDF5. </p> + </li> + <li> - <p>Navigate through the directories until you find the location of the - <span class="filename">hdf5.lib</span>. </p> + <p class="note">2. Please read <a href="#section5">Section V </a>if you do not want to +use compression feature inside HDF5.</p> + </li> + <li> - <p>Select <span class="filename">hdf5.lib</span> and click - <span class="filename">OK</span>.</p> + <p class="note">3. Since Microsoft Visual Studio +.NET will automatically enable all project files in the <span class="filename">"Configuration Manager"</span>, you +have to manually disable those project files you don't want to build. </p> + + <p class="note">4. If you want to change some +project setting, select the project and right click the button to +choose Properties; find the similar menu there as in Microsoft Visual +Studio 6.0. </p> + </li> + + </ul> + + <p class="right"><a href="#section6">Go +to TOP Section VI</a></p> + + <p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + + <hr class="second"> + <h2><a name="section7">Section VII: How to build +HDF5 with INTEL Compiler</a></h2> + + <hr class="second"> + <ul class="intable"> + <li> - <p>repeat step i-v, to select<span class="filename"> zdll.lib and szlibdll.lib</span>.</p> + <h3>1. INTEL compiler 7.1</h3> + + <ul class="intable"> + + <li> + <h4>1.1. Intel C Compiler</h4> + + <ul class="intable"> + + <li>Go to Tools-->Select Compiler</li> + + <li>Check Intel box and click OK button.</li> + + </ul> + + </li> + + <li> + <h4>1.2. Intel Fortran Compiler</h4> + + <ul class="intable"> + + <li>Go to Tools-->Select Compiler</li> + + <li>Check Intel box and click OK button.</li> + + <li>Go to Tools-->Customize-->Add-ins +and Macro Files and check Intel Fortran Compiler Build Tool</li> + + </ul> + + </li> + + </ul> + + <p class="note">Notes:</p> + + <p class="note">Szip library is different when +using Intel compiler. You should build Szip source codes with Intel +compiler or download binaries for Intel compiler from <a href="ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/" target="_blank"> +ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/.</a> +The Szip +library and header path should also be set up accordingly (refer to <a href="#precondition6">Precondition 6.) </a></p> + </li> + <li> - <p>(optional) repeat step i-v, to select <span class="filename">hdf5_cpp.lib</span> - to link with HDF5 C++ static library.</p> + <h3>2. INTEL compiler 8.1</h3> + + <ul class="intable"> + + <li> + <h4>Preconditions:</h4> + + <ul class="intable"> + + <li> + <h4>a. Setup Szip Library for Intel Compiler.</h4> + + </li> + + <li>Intel compilers use different Szip library from +other compilers. Szip source codes or binaries for Intel compiler can +be downloaded from the following address: </li> + + <li><a href="ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/" target="_blank">ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/.</a> + </li> + + <li>The Szip library and header path should also be +set up accordingly (refer to <a href="#precondition6">Precondition +6.)</a></li> + + </ul> + + </li> + + <li> + <h4>b. Set up path for external libraries and headers</h4> + + <ul class="intable"> + + <li>Skip this part if you don't want to use ANY +compression features provided by HDF5. Please do read <a href="#section5">Section V.</a></li> + + <li>You have to read this part even if you want to +only use Zlib or Szip. You also need to read <a href="#section5">Section +V.</a></li> + + <li>Invoke Microsoft Visual C++ and go to <span class="filename">"Tools"</span> and select <span class="filename">"Options"</span>, find <span class="filename">"Directories"</span>;</li> + + <li>Find the box <span class="filename">"Show +directories for"</span>, choose <span class="filename">"Include +files"</span>, if you can not find your Zlib and Szip header path +(for example, <span class="filename">c:\zlib122\include, +c:\szip\include</span>) from the directory list, add the header +path (<span class="filename">c:\zlib122\include, +c:\szip\include</span>) to the included directories. </li> + + <li>Find the box <span class="filename">"Show +directories for"</span>, choose <span class="filename">"Library +files"</span>, If you cannot find your Zlib and Szip library path +(for example, <span class="filename">c:\zlib122\lib, +c:\szip\dll</span>) from the directory list, add the library path +(<span class="filename">c:\zlib122\lib, c:\szip\dll</span>) +to the library directories. </li> + + </ul> + + </li> + + </ul> + </li> + <li> - <p>(optional) repeat step i-v5, to select <span class="filename">hdf5_fortran.lib</span> - to link with HDF5 Fortran static library.</p> + <h4><a name="2.1_section7">2.1 Intel C++ +Compiler 8.1 under MSVS C++ .Net 2003 Environment</a></h4> + + <ul class="intable"> + + <li> + <p class="note">Notes:</p> + + </li> + + <li> + <p class="note">1. This step will build ONLY +HDF5 Static and DLL C and C++ Library using Intel C++ Compiler.</p> + + </li> + + <li> + <p class="note">2. If you want to build HDF5 +Static and DLL C and C++ Library using Intel C++ 8.1 Compiler as well +as HDF5 Static Fortran Library using Intel Fortran +8.1 Compiler, Please go to <a href="#2.2_section7">2.2 </a>directly! + </p> + + </li> + + </ul> + </li> - </ol> - </li> - </ul> - </li> - <li> - <h4><u>Method Two</u></h4> - <blockquote> - <ol style="LIST-STYLE-TYPE: lower-roman"> + <li> - <p>Go to <span class="filename">Tools->Options->Directorie</span>s,</p> + <h4>2.1.1 Invoke Microsoft Visual C++ .Net 2003. </h4> + + <ul class="intable"> + + <li>From the main menu, go to<span class="filename"> +"File"</span> and select <span class="filename">"Open +Solution"</span>. In the "Open <span class="filename">Solution" </span>window, Change <span class="filename">"Files of type" </span>to<span class="filename"> "All Project Files". </span>Choose<span class="filename"> "all.dsw" </span>under the +directory <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all.</span> +In the pop up window, choose <span class="filename">"Yes +To All"</span> to convert all project files to Visual C++ .Net +project format. </li> + + </ul> + </li> + <li> - <p>Insert the correct HDF5, Zlib, Szip paths for both headers (include) and - libraries. For example, </p> - <ul class="normal"> - <li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\include </span> </li> - <li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\lib </span> </li> - <li><span class="filename">c:\zlib122\include </span> </li> - <li><span class="filename">c:\zlib122\lib </span> </li> - <li><span class="filename">c:\szip\include </span> </li> - <li><span class="filename">c:\szip\dl</span>l</li> - </ul> + <h4>2.1.2 Right click on the solution name <span class="filename">"all.sln"</span> in the <span class="filename">"Solution Explorer"</span>. </h4> + + <ul class="intable"> + + <li>From the pop-up menu select <span class="filename">"Convert to use Intel C++ Project System"</span> +to convert all .Net project files to Intel C++ project files. </li> + + </ul> + </li> + <li> - <p>Go to the <span class="filename">Project</span> menu and choose the - <span class="filename">"Settings"</span> option.</p> + <h4>2.1.3 Go to <span class="filename">Tools +> Options > Intel C++</span>,</h4> + + <ul class="intable"> + + <li>In the left pane, Click <span class="filename">"General"</span>. + </li> + + <li>In the right pane, under "Compiler selection", +choose Intel C++ 8.1. </li> + + <li>Click on <span class="filename">"Intel +C++ 8.1"</span> to set the directories and default options. In <span class="filename">"Include"</span>, Add Zlib and Szip +header path (<span class="filename">c:\zlib122\include +c:\szip\include</span>). In <span class="filename">"Library"</span>, +Add Zlib and Szip Library Path (<span class="filename">c:\zlib122\lib, +c:\szip\dll</span>).</li> + + <li>Click <span class="filename">"OK"</span>.</li> + + </ul> + </li> + <li> - <p>Find the <span class="filename">"link"</span> option and - <span class="filename">"Input"</span> category, insert - <span class="filename">"zdll.lib, szlibdll.lib, hdf5.lib"</span>.</p> + <h4>2.1.4 Select "Build", then Select "Set Active +Configuration".</h4> + + <ul class="intable"> + + <li>Select <span class="filename">"all -- +Win32 Debug" </span>or<span class="filename"> "all +-- Win32 Release"</span></li> + + <li>Disable all Fortran project files listed below and <span class="filename"> ttsafedll</span> project file:</li> + + <li>flush1_fortran </li> + + <li>flush1_fortrandll </li> + + <li>flush2_fortran </li> + + <li>flush2_fortrandll </li> + + <li>hdf5_f90cstub </li> + + <li>hdf5_f90cstubdll </li> + + <li>hdf5_fortran </li> + + <li>hdf5_fortrandll </li> + + <li>libtest_cstubdll </li> + + <li>libtest_fortran </li> + + <li>libtest_fortrandll </li> + + <li>testhdf5_fortran </li> + + <li>testhdf5_fortrandll </li> + + <li>hdf5_hl_fortran </li> + + <li>hl_test_image_fortran </li> + + <li>hl_test_lite_fortran </li> + + <li>hl_test_table_fortran</li> + + <li>ttsafedll</li> + + <li>Select <span class="filename">"ok". </span>Select<span class="filename"> "Build" -> "Build" or "Rebuild All" + </span>to build debug version of project<span class="filename"> "all".</span></li> + + </ul> + </li> + <li> - <p>(Optional) repeat step iii-iv, to insert <span class="filename">"hdf5_cpp.lib"</span> - if you want to use HDF5 C++ static library.</p> + <h4>2.1.5 Go back to <a href="#step2_section2">Section +II, continue with STEP 2(Testing HDF5 libraries and tools) to test HDF5 +C and C++ Libraries.</a></h4> + </li> + <li> - <p>(Optional) repeat step iii-iv, to insert <span class="filename">"hdf5_fortran.lib"</span> - if you want to use HDF5 Fortran static library.</p> - </li> - </ol> - </blockquote> - </li> - </ul> - </li> -</ul> - </li> - <li> - <h3>2. To use HDF5 Dynamic Link Library</h3> - <blockquote> - <ol style="LIST-STYLE-TYPE: lower-roman"> - <li> - <p>Follow the steps for specifying the location of the header files as shown - in <a href="#method1_header">Method One.</a></p> - </li> - <li> - <p>Follow the steps for linking the HDF5 library as shown in - <a href="#link_hdf5">Method One.</a> except now link the export - library that is created with the DLL. The export library is called - <span class="filename">hdf5dll.lib</span> for HDF5 C libray, - <span class="filename">hdf5_cppdll.lib</span> for HDF5 C++ library, and - <span class="filename">hdf5_fortrandll.lib</span> for HDF5 Fortran library.</p> - </li> - <li> - <p>Place the DLL in a location that Windows will be able to locate it. The searched - path and order for DLL's is</p> - <ol> - <li> - <p>The Windows system directory. The GetSystemDirectory function retrieves - the path of this directory.</p> - </li> - <li> - <p>The Windows directory. The GetWindowsDirectory function retrieves the path - of this directory.</p> - </li> - <li> - <p>The directories listed in the PATH environment variable.</p> - </li> - </ol> - </li> - <li> - <p>To modify your own application settings, please DO FOLLOW the<a href="#section11_pointers"> - "DLL Hints" at Section XI "HELPFUL POINTERS".</a></p> - </li> - </ol> - </blockquote> - </li> -</ul> -<p class="right"><a href="#section4">Go to TOP Section IV</a></p> -<p class="right"><a href="#content_table">Go to Table of Contents</a></p> -<hr class="second"> -<h2><a name="section5">Section V: How to disable Gzip(Zlib)/Szip compression</a></h2> -<hr class="second"> -<p class="note">Warnings:</p> -<p class="note">When you modify the H5pubconf.h file as described below, DO NOT just change the -values of these macros from 1 to 0. Please DO remove (or comment out) appropriate -lines. </p> -<ul class="intable"> - <li> - <h3>1. Disable Gzip compression</h3> -<ul class="intable"> - <li><p>If you would like to remove Gzip compression from the HDF5 library, follow - the steps below.<ul class="intable"></p> - <li>1.1 Open the H5pubconf.h file from the <span class="filename">c:\MyHDFstuff\hdf5\src</span> - directory and remove (or comment out) the following two lines: - <ul class="normal"> - <li><p class="insmes">#define H5_HAVE_ZLIB_H 1 </p></li> - <li><p class="insmes">#define H5_HAVE_FILTER_DEFLATE 1</p></li> - </ul> - then save the file. - </li> - <li>1.2 Delete HDF5_EXT_ZLIB environment variable if you have set it in preconditions.</li> - <li>1.3 Run-compile HDF5 library according to - <a href="#section2">Section II.</a></li> - </ul> - </li> - <li><p>When you disable Gzip, you may get the following message when building HDF5 - libraries:</p> - <ul class="normal"> - <li>The following environment variables were not found $(HDF5_EXT_ZLIB)</li> - </ul> - </li> - <li><p>This message can be ignored.</p></li> -</ul> - </li> - <li> - <h3>2. Disable Szip compression (both encoder and decoder)</h3> -<ul class="intable"> - <li><p>If you would like to remove Szip compression from the HDF5 library, follow - the steps below.</p> - <ul class="intable"> - <li>2.1 Open the H5pubconf.h file from the <span class="filename">c:\MyHDFstuff\hdf5\src</span> - directory and remove (or comment out) the following two lines: - <ul class="normal"> - <li><p class="insmes">#define H5_HAVE_SZLIB_H 1 </p></li> - <li><p class="insmes">#define H5_HAVE_FILTER_SZIP 1</p></li> - </ul> - </li> - <li>then save the file.</li> - <li>2.2 Delete <span class="filename">HDF5_EXT_SZIP</span> environment variable - if you have set it in preconditions.</li> - <li>2.3 Run-compile HDF5 library according to - <a href="#section2">Section II.</a> - </li> - </ul> - <p>When you disable Szip, you may get the following message when building HDF5 - libraries: </p> - <ul class="normal"> - <li>The following environment variables were not found $(HDF5_EXT_SZIP)</li> - </ul> - - <p>This message can be ignored.</p> + <h4><a name="2.2_section7">2.2 Intel Fortran +Compiler 8.1 under MSVS C++ .Net 2003 Environment</a></h4> - <p class="note">Notes:</p> - <p class="note">To disable Gzip and Szip at the same time, just follow 1.1~1.3 and 2.1~2.3 - and run-compile HDF5 library according to<a href="#section2"> - Section II.</a></p> - </li> -</ul> - </li> - <li> - <h3>3. Disable Szip encoder</h3> - <p>If you would like to just disable Szip encoder from the HDF5 library while - keeping Szip decoder enabled, follow the steps below. </p> - <blockquote> - <ul class="intable"> - <li>3.1 Download Szip library without encoder</li> - <li>Szip library is different if you want to disable Szip encoder. Download - <span class="filename">szip_noencoder</span> binaries from - <a href="ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows" target="blank" ,> - ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows.</a> The Szip library and header - path should also be set up accordingly (refer to - <a href="#precondition6">Precondition 6.)</a> </p> - </li> - <li>3.2 Run-compile HDF5 library according to - <a href="#section2">Section II.</a></li> - </ul> - </blockquote> - </li> -</ul> -<p class="right"><a href="#section5">Go to TOP Section V</a></p> -<p class="right"><a href="#content_table">Go to Table of Contents</a></p> -<hr class="second"> -<h2><a name="section6">Section VI: How to build HDF5 in Microsoft Visual Studio -.Net 2003</a> </h2> -<hr class="second"> -<ul class="intable"> - <li> - <h3>1. Open the workspace </h3> -<ul class="intable"> - <li><p>Invoke Microsoft Visual C++ .Net 2003. From the main menu, go to "File" and select "Open Solution". In - the "Open Solution" window, Change "Files of type" to - "All Project Files". Choose "all.dsw" under the directory - c:\MyHDFstuff\hdf5\windows\proj\all. In the pop up window, - choose "Yes To All" to convert all project files to Visual - C++ .Net project format.</p> </li> - <li><p class="note">Notes: If you are not in <a href="#section10"> - Section X How to build HDF5 with Thread-Safe Feature</a>, ttsafedll.dsp should - be turned off always.</p> </li> -</ul> - </li> - <li> - <h3>2. Building HDF5 C/C++ Libraries</h3> -<ul class="intable"> - <li><p>Users can choose the desirable libraries to be built according to the - following description.</p></li> - <li><h5>2.1 If you don't want to build HDF5 C++ Libraries</h5> - <p>Go to - <span class="filename">"Build"</span> and select<span class="filename"> "Configuration - Manager"</span>. Choose <span class="filename">"Release"</span> or - <span class="filename">"Debug"</span> under <span class="filename">"Active Solution - Configuration" </span> - <ul class="intable"> - <li>Disable the following projects:<ul class="normal"> - <li>dsets_cpp </li> - <li>dsets_cppdll </li> - <li>hdf5_cpp </li> - <li>hdf5_cppdll </li> - <li>testhdf5_cpp </li> - <li>testhdf5_cppdll </li> - <li>hdf5_hl_cpp</li> - <li>hdf5_hl_cppdll </li> - <li>hl_test_table_cpp</li> - <li>hl_test_table_cppdll </li> - <li>ttsafedll</li> - </ul> - </li> - </ul> - </li> - <li><h5>2.2 If you don't want to build HDF5 Fortran Libraries</h5> - <p>Go to - <span class="filename">"Build"</span> and select <span class="filename">"Configuration - Manager"</span>. Choose <span class="filename">"Release"</span> or - <span class="filename">"Debug"</span> under <span class="filename">"Active Solution - Configuration" </span> - <ul class="intable"> - <li>Disable the following projects:<ul class="normal"> - <li>flush1_fortran </li> - <li>flush1_fortrandll </li> - <li>flush2_fortran </li> - <li>flush2_fortrandll </li> - <li>hdf5_f90cstub </li> - <li>hdf5_f90cstubdll </li> - <li>hdf5_fortran </li> - <li>hdf5_fortrandll </li> - <li>libtest_cstubdll </li> - <li>libtest_fortran </li> - <li>libtest_fortrandll </li> - <li>testhdf5_fortran </li> - <li>testhdf5_fortrandll </li> - <li>hdf5_hl_fortran</li> - <li>hdf5_hl_fortrandll</li> - <li>hdf5_hl_f90cstubdll </li> - <li>hl_test_image_fortran</li> - <li>hl_test_image_fortrandll </li> - <li>hl_test_lite_fortran</li> - <li>hl_test_lite_fortrandll </li> - <li>hl_test_table_fortran</li> - <li>hl_test_table_fortrandll</li> - <li>ttsafedll</li> - </ul> - </li> - </ul> - </li> - <li> - <h5>2.3 If you don't want to build HDF5 High-Level Libraries</h5> - <p>Go to - <span class="filename">"Build"</span> and select <span class="filename">"Configuration - Manager"</span>. Choose <span class="filename">"Release"</span> or - <span class="filename">"Debug"</span> under <span class="filename">"Active Solution - Configuration" </span> - <ul class="intable"> - <li>Disable the following projects:<ul class="normal"> - <li>hdf5_hl </li> - <li>hdf5_hldll</li> - <li>hl_test_image</li> - <li>hl_test_imagedll </li> - <li>hl_test_lite </li> - <li>hl_test_litedll</li> - <li>hl_test_table </li> - <li>hl_test_tabledll</li> - <li>hl_test_ds </li> - <li>hl_test_dsdll</li> - <li>hl_test_packet</li> - <li>hl_test_packetdll</li> - <li>ttsafedll</li> - </ul> - </li> - </ul> - </li> - <li> - <h5>2.4 If you want to build HDF5 C++ libarty without High-Level C++ Libraries</h5> - <p>Go to <span class="filename">"Build"</span> and select - <span class="filename">"Configuration Manager"</span>. Choose - <span class="filename">"Release"</span> or <span class="filename">"Debug"</span> - under <span class="filename">"Active Solution Configuration" </span> - <ul class="intable"> - <li>Disable the following projects:<ul class="normal"> - <li>hdf5_hl_cpp </li> - <li>hdf5_hl_cppdll</li> - <li>hl_test_table_cpp</li> - <li>hl_test_table_cppdll</li> - <li>ttsafedll</li> - </ul> - </li> - </ul> - </li> - <li> - <h5>2.5 If you want to build HDF5 Fortran Libraries without High-Level Fortran - Libraries</h5> - <p>Go to <span class="filename">"Build"</span> and select - <span class="filename">"Configuration Manager"</span>. Choose - <span class="filename">"Release"</span> or <span class="filename">"Debug"</span> - under <span class="filename">"Active Solution Configuration" </span> - <ul class="intable"> - <li>Disable the following projects:<ul class="normal"> - <li>hdf5_hl_fortran </li> - <li>hdf5_hl_fortrandll</li> - <li>hdf5_hl_f90cstubdll</li> - <li>hl_test_image_fortran </li> - <li>hl_test_image_fortrandll</li> - <li>hl_test_lite_fortran </li> - <li>hl_test_lite_fortrandll</li> - <li>hl_test_table_fortran </li> - <li>hl_test_table_fortrandll</li> - <li>ttsafedll</li> - </ul> - </li> - </ul> - </li> -</ul> - </li> - <li> - <p> </p> - </li> - <li> - <p>Find <span class="filename">"Build"</span> and go to - <span class="filename">"Configuration Manager"</span>; choose - <span class="filename">"release"</span> or <span class="filename">"debug"</span>, - then choose <span class="filename">"build all"</span> to build HDF5 - with desired options.</p> - </li> -</ul> -<p class="note">Notes:</p> -<ul class="intable"> - <li> - <p class="note">1. You need to specify the <span class="filename">zlib</span> and - <span class="filename">szip</span> include header files and libraries under<span class="filename"> - Tools ->Options->Projects->VC++</span> Directories and choose Include and libraries - under the category of <span class="filename">"show directories for"</span> to - add the corresponding path if you want to use compression feature inside HDF5. </p> - </li> - <li> - <p class="note">2. Please read <a href="#section5">Section V </a>if you do - not want to use compression feature inside HDF5.</p> - </li> - <li> - <p class="note">3. Since Microsoft Visual Studio .NET will automatically enable all project - files in the <span class="filename">"Configuration Manager"</span>, you have to - manually disable those project files you don't want to build. </p> - <p class="note">4. If you want to change some project setting, select the - project and right click the button to choose Properties; find the similar menu - there as in Microsoft Visual Studio 6.0. </p> - </li> - </ul> - <p class="right"><a href="#section6">Go to TOP Section VI</a></p> - <p class="right"><a href="#content_table">Go to Table of Contents</a></p> - <hr class="second"> - <h2><a name="section7">Section VII: How to build HDF5 with INTEL Compiler</a></h2> - <hr class="second"> - - <ul class="intable"> - <li><h3>1. INTEL compiler 7.1</h3> - <ul class="intable"> - <li><h4>1.1. Intel C Compiler</h4> <ul class="intable"> - <li>Go to Tools-->Select Compiler</li> - <li>Check Intel box and click OK button.</li> + + <li> + <p class="note">Notes:</p> + + </li> + + <li> + <p class="note">1. This step will build HDF5 +Static and DLL C and C++ Library using Intel C++ 8.1 Compiler as well +as HDF5 Static and High Level Fortran Library using Intel Fortran 8.1 +Compiler. </p> + + </li> + + <li> + <p class="note">2. Users who want to build +ONLY HDF5 Static and DLL C and C++ LibraryPlease go to <a href="#2.1_section7">2.1.</a> </p> + + </li> + </ul> + </li> - - <li><h4>1.2. Intel Fortran Compiler</h4> + + <li> + <h4>2.2.1 Invoke Microsoft Visual C++ .Net 2003. </h4> + <ul class="intable"> - <li>Go to Tools-->Select Compiler</li> - <li>Check Intel box and click OK button.</li> - <li>Go to Tools-->Customize-->Add-ins and Macro Files and check Intel Fortran - Compiler Build Tool</li> - </ul> + + <li>From the main menu, go to <span class="filename">"File"</span> +and select <span class="filename">"Open Solution"</span>. +In the <span class="filename">"Open Solution"</span> +window, Change <span class="filename">"Files of type"</span> +to <span class="filename">"All Project Files"</span>. +Choose <span class="filename">"all.dsw"</span> +under the directory <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all.</span> +In the pop up window, choose <span class="filename">"Yes +To All</span>" to convert all project files to Visual C++ .Net +project format. </li> + + </ul> + </li> - </ul> - <p class="note">Notes:</p> - <p class="note">Szip library is different when using Intel compiler. You should build Szip - source codes with Intel compiler or download binaries for Intel compiler from - <a href="ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows/" target="_blank"> - ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows/.</a> The Szip library and - header path should also be set up accordingly (refer to - <a href="#precondition6">Precondition 6.) </a></p> - </li> - - <li><h3>2. INTEL compiler 8.1</h3> - <ul class="intable"> - <li><h4>Preconditions:</h4> - <ul class="intable"> - <li><h4>a. Setup Szip Library for Intel Compiler.</h4></li> - <li>Intel compilers use different Szip library from other compilers. Szip source - codes or binaries for Intel compiler can be downloaded from the following - address: </li> - <li><a href="ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows/" target="_blank"> - ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows/.</a> </li> - <li>The Szip library and header path should also be set up accordingly (refer - to <a href="#precondition6">Precondition 6.)</a></li> - </ul> - </li> - - <li> <h4>b. Set up path for external libraries and headers</h4> - <ul class="intable"> - <li>Skip this part if you don't want to use ANY compression features provided - by HDF5. Please do read <a href="#section5">Section V.</a></li> - <li>You have to read this part even if you want to only use Zlib or Szip. You - also need to read <a href="#section5">Section V.</a></li> - <li>Invoke Microsoft Visual C++ and go to <span class="filename">"Tools"</span> - and select <span class="filename">"Options"</span>, find - <span class="filename">"Directories"</span>;</li> - <li>Find the box <span class="filename">"Show directories for"</span>, choose - <span class="filename">"Include files"</span>, if you can not find your Zlib - and Szip header path (for example, <span class="filename">c:\zlib122\include, - c:\szip\include</span>) from the directory list, add the header path (<span class="filename">c:\zlib122\include, - c:\szip\include</span>) to the included directories. </li> - <li>Find the box <span class="filename">"Show directories for"</span>, choose - <span class="filename">"Library files"</span>, If you cannot find your Zlib - and Szip library path (for example, <span class="filename">c:\zlib122\lib, - c:\szip\dll</span>) from the directory list, add the library path (<span class="filename">c:\zlib122\lib, - c:\szip\dll</span>) to the library directories. </li> - </ul> - </li> - </ul> - </li> - - <li><h4><a name="2.1_section7">2.1 Intel C++ Compiler 8.1 under MSVS C++ .Net 2003 Environment</a></h4> - <ul class="intable"> - <li><p class="note">Notes:</p></li> - <li><p class="note">1. This step will build ONLY HDF5 Static and DLL C and C++ Library using - Intel C++ Compiler.</p></li> - <li><p class="note">2. If you want to build HDF5 Static and DLL C and C++ Library using Intel - C++ 8.1 Compiler as well as HDF5 Static Fortran Library using Intel - Fortran 8.1 Compiler, Please go to <a href="#2.2_section7">2.2 - </a>directly! </p></li> - </ul> - </li> - - <li><h4>2.1.1 Invoke Microsoft Visual C++ .Net 2003. </h4> - <ul class="intable"> - <li>From the main menu, go to<span class="filename"> - "File"</span> and select <span class="filename">"Open Solution"</span>. In - the "Open <span class="filename">Solution" </span>window, Change - <span class="filename">"Files of type" </span>to<span class="filename"> "All - Project Files". </span>Choose<span class="filename"> "all.dsw" </span>under - the directory <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all.</span> - In the pop up window, choose <span class="filename">"Yes To All"</span> to - convert all project files to Visual C++ .Net project format. </li> - </ul> - </li> - - - <li><h4>2.1.2 Right click on the solution name <span class="filename">"all.sln"</span> - in the <span class="filename">"Solution Explorer"</span>. </h4> - <ul class="intable"> - <li>From the pop-up - menu select <span class="filename">"Convert to use Intel C++ Project System"</span> - to convert all .Net project files to Intel C++ project files. </li> - </ul> + + <li> + <h4>2.2.2 Select project "flush1_fortran" in the Solution +Explorer window. In the Project menu, select "Extract Compaq Visual +Fortran Project". </h4> + + <ul class="intable"> + + <li>Do the same thing for the following project files:</li> + + <li>flush2_fortran </li> + + <li>hdf5_fortran </li> + + <li>testhdf5_fortran </li> + + <li>hl_test_image_fortran </li> + + <li>hl_test_lite_fortran </li> + + <li>hl_test_table_fortran</li> + + </ul> + </li> - - <li><h4>2.1.3 Go to <span class="filename">Tools > Options > Intel C++</span>,</h4> - <ul class="intable"> - <li>In the left pane, Click <span class="filename">"General"</span>. </li> - <li>In the right pane, under "Compiler selection", choose Intel C++ 8.1. </li> - <li>Click on <span class="filename">"Intel C++ 8.1"</span> to set the - directories and default options. In <span class="filename">"Include"</span>, - Add Zlib and Szip header path (<span class="filename">c:\zlib122\include - c:\szip\include</span>). In <span class="filename">"Library"</span>, Add - Zlib and Szip Library Path (<span class="filename">c:\zlib122\lib, c:\szip\dll</span>).</li> - <li>Click <span class="filename">"OK"</span>.</li> - </ul> - </li> - - <li><h4>2.1.4 Select "Build", then Select "Set Active Configuration".</h4> - <ul class="intable"> - <li>Select <span class="filename">"all -- Win32 Debug" </span>or<span class="filename"> - "all -- Win32 Release"</span></li> - <li>Disable all Fortran project files listed below and <span class="filename"> - ttsafedll</span> project file:</li> - <li>flush1_fortran </li> - <li>flush1_fortrandll </li> - <li>flush2_fortran </li> - <li>flush2_fortrandll </li> - <li>hdf5_f90cstub </li> - <li>hdf5_f90cstubdll </li> - <li>hdf5_fortran </li> - <li>hdf5_fortrandll </li> - <li>libtest_cstubdll </li> - <li>libtest_fortran </li> - <li>libtest_fortrandll </li> - <li>testhdf5_fortran </li> - <li>testhdf5_fortrandll </li> - <li>hdf5_hl_fortran </li> - <li>hl_test_image_fortran </li> - <li>hl_test_lite_fortran </li> - <li>hl_test_table_fortran</li> - <li>ttsafedll</li> - <li>Select <span class="filename">"ok". </span>Select<span class="filename"> - "Build" -> "Build" or "Rebuild All" </span>to build debug version of project<span class="filename"> - "all".</span></li> - </ul> - </li> - - <li><h4>2.1.5 Go back to <a href="#step2_section2">Section II, - continue with STEP 2(Testing HDF5 libraries and tools) to test HDF5 C and - C++ Libraries.</a></h4> - </li> - - <li> <h4><a name="2.2_section7">2.2 Intel Fortran Compiler 8.1 under MSVS C++ .Net 2003 Environment</a></h4> - <ul class="intable"> - <li><p class="note">Notes:</p></li> - <li><p class="note">1. This step will build HDF5 Static and DLL C and C++ Library using Intel - C++ 8.1 Compiler as well as HDF5 Static and High Level Fortran Library using - Intel Fortran 8.1 Compiler. </p></li> - <li><p class="note">2. Users who want to build ONLY HDF5 Static and DLL C and C++ LibraryPlease - go to <a href="#2.1_section7">2.1.</a> </p> </li> - </ul> - </li> - - <li><h4>2.2.1 Invoke Microsoft Visual C++ .Net 2003. </h4> - <ul class="intable"> - <li>From the main menu, go to - <span class="filename">"File"</span> and select <span class="filename">"Open - Solution"</span>. In the <span class="filename">"Open Solution"</span> window, - Change <span class="filename">"Files of type"</span> to - <span class="filename">"All Project Files"</span>. Choose - <span class="filename">"all.dsw"</span> under the directory - <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all.</span> In the - pop up window, choose <span class="filename">"Yes To All</span>" to convert - all project files to Visual C++ .Net project format. </li> - </ul> - </li> - - - <li><h4>2.2.2 Select project "flush1_fortran" in - the Solution Explorer window. In the Project menu, select "Extract Compaq Visual Fortran Project". - </h4> - <ul class="intable"> - <li>Do the same thing for the following project files:</li> - <li>flush2_fortran </li> - <li>hdf5_fortran </li> - <li>testhdf5_fortran </li> - <li>hl_test_image_fortran </li> - <li>hl_test_lite_fortran </li> - <li>hl_test_table_fortran</li> - </ul> - </li> - - <li><h4>2.2.3 Select project "libtest_fortran" in the Solution Explorer window. </h4> - <ul class="intable"> - <li>In the Project menu, select <span class="filename">"Extract Compaq Visual Fortran Project"</span>. Since - Project file <span class="filename">"libtest_fortran</span>" contain both - C and Fortran code, you will be asked to specify which project, either Fortran - or C/C++, will serve as the main project for this mixed language projects. - Choose <span class="filename">"The Intel Fortran project"</span> as the the - main project and click <span class="filename">"OK"</span>. - Do the same thing for "hdf5_hl_fortran".</li> - </ul> - </li> - - - <li><h4>2.2.4 Change project dependencies of "libtest_fortran" and - "hdf5_hl_fortran"</h4> - <ul class="intable"> - <li>Highlight project <span class="filename">"libtest_fortran"</span>, choose - <span class="filename">"Project"</span>-> <span class="filename">"Project - Dependencies", </span>uncheck<span class="filename"> "libtest".</span> - </li> - <li>Highlight project <span class="filename">"hdf5_hl_fortran"</span>, choose - <span class="filename">"Project"</span>-> <span class="filename">"Project - Dependencies", </span>uncheck<span class="filename"> "hdf5_hl" - and "hdf5_fortran".</span> - </li> - </ul> - </li> - - <li><h4>2.2.5 Right click on the solution name "all.sln" in the "Solution Explorer". </h4> - <ul class="intable"> - <li>From the pop-up menu select <span class="filename">"Convert to use Intel C++ Project System"</span> - to convert all .Net C++ project files to Intel C++ project formats. </li> - </ul> - </li> - - <li><h4>2.2.6 Select "Build", then Select "Set Active Configuration".</h4> - <ul class="intable"> - <li>Select<span class="filename"> "all -- Win32 Debug" </span>or<span class="filename"> - "all -- Win32 Release"</span></li> - <li>Disable all Fortran DLL project files listed below and - <span class="filename">ttsafedll</span> project file:</li> - <li>flush1_fortrandll </li> - <li>flush2_fortrandll </li> - <li>hdf5_fortrandll </li> - <li>hdf5_hl_fortrandll</li> - <li>hl_test_image_fortrandll</li> - <li>hl_test_lite_fortrandll</li> - <li>hl_test_table_fortrandll</li> - <li>libtest_fortrandll </li> - <li>testhdf5_fortrandll</li> - <li>ttsafedll</li> - <li>Select <span class="filename">"ok"</span>. Select - <span class="filename">"Build"</span> -> <span class="filename">"Build" or - "Rebuild All"</span> to build Debug or Release version of HDF5 C, C++ Static - and DLL Library using Intel C++ 8.1 Compiler and HDF5 Static and High Level - Fortran Library using Intel Fortran 8.1 compiler. </li> - </ul> - </li> - - <li><h4>2.2.7 Test HDF5 Static and High Level Fortran Library</h4> - <ul class="intable"> - <li><h4><u>Test HDF5 Static Fortran Library</u></h4> - <p>Go to directory <span class="filename">c:\myHDFstuff\hdf5\fortran\test</span>, - Run batch file <span class="filename">testhdf5_fortran.bat</span> with the - following two options to test fortran static library </p></li> - <li>testhdf5_fortran release >> "Your output file name" </li> - <li>testhdf5_fortran debug >> "Your output file name"</li> - <li><p>Check your output files, there should be no "failures" at all.</p></li> - <li><h4><u>Test HDF5 High Level Fortran Library</u></h4> - <p>Go to directory <span class="filename">c:\myHDFstuff\hdf5\hl\fortran\test</span>, - Run batch file testhdf5_fortran.bat with the following two options to test - fortran static library </p></li> - <li>test_hdf5_hl_fortran release >> "Your output file name" </li> - <li>test_hdf5_hl_fortran debug >> "Your output file name"</li> - <li><p>Check your output files, there should be no "failures" at all.</p></li> + + <li> + <h4>2.2.3 Select project "libtest_fortran" in the +Solution Explorer window. </h4> + + <ul class="intable"> + + <li>In the Project menu, select <span class="filename">"Extract Compaq Visual Fortran Project"</span>. +Since Project file <span class="filename">"libtest_fortran</span>" +contain both C and Fortran code, you will be asked to specify which +project, either Fortran or C/C++, will serve as the main project for +this mixed language projects. Choose <span class="filename">"The +Intel Fortran project"</span> as the the main project and click <span class="filename">"OK"</span>. Do the same +thing for "hdf5_hl_fortran".</li> + </ul> - </li> - </ul> - - - - - <p class="right"><a href="#section7">Go to TOP Section VII</a></p> - <p class="right"><a href="#content_table">Go to Table of Contents</a></p> - <hr class="second"> - <h2><a name="section8">Section VIII: Building and testing Multi-threaded version - of HDF5 Library </a></h2> - <hr class="second"> - <p class="note">Notes:</p> - <p class="note">Preconditions and Section I also apply to this section. Users who want - to build Multi-threaded version of HDF5 library, please read those two sections - carefully before go to the following part. </p> - <ul class="intable"> - <li> - <h4>1. Run batch file copy_hdf.bat.</h4> - <p>Go to <span class="filename">c:\MyHDFstuff\hdf5\windows</span> and run - <span class="filename">copy_hdf.bat</span>. This process will - copy all the necessary batch files, windows specific source codes and text - files saved under <span class="filename">c:\MyHDFstuff\hdf5\windows</span> directory to the corresponding - directories under <span class="filename">hdf5</span>. </p> - </li> - <li> - <h4>2. Invoke Microsoft Visual C++ compiler Invoke Microsoft</h4> - <p>Visual C++. From the main menu, go to <span class="filename">"File"</span> and select the - <span class="filename">"Open Workspace"</span> - option. Then open the <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw</span> workspace. - You should find windows project files listed as <span class="filename">"all files, big files etc."</span> - on the left. </p> - </li> - <li> - <h4>3. Please refer to Section II, Step 3(3) to set the dependencies of - project "all.dsp". </h4> - <p></p> - </li> - <li> - <h4>4. Change Project settings </h4> - <ul class ="intable"> - <li>Choose <span class="filename">"Project"->"Settings",</span><ul class ="intable"> - <li>In the left pane of the window <span class="filename">"Project Settings"</span>, from the drop down box to the right of - <span class="filename">"Setting For:"</span>, - <ul class ="intable"> - <li><u>Choose <span class="filename">"Win32 Release"</span>:</u></li> - <li>Highlight all of the static project file in the left lower pane by pressing - <span class="filename">"ctrl"</span> key while clicking the project file name.</li> - <li>In the right pane of the <span class="filename">"Project Settings"</span> window, choose - <span class="filename">"C/C++"</span>. From the drop - down box to the right of <span class="filename">"Category"</span>, choose - <span class="filename">"Code Generation", </span>under<span class="filename"> - "Use run-time library:"</span>,<span class="filename"> - "Single-Threaded" </span>should appear. If it is blank inside - this box, check if you highlight some dll project files (see - notes below). Change <span class="filename">"Single-Threaded" </span> - to <span class="filename">"Multithreaded"</span>.</li> - <li><u>Choose <span class="filename">"Win32 Debug"</span>; - </u></li> - <li>Highlight all of the static project file in the left lower pane by pressing - <span class="filename">"ctrl"</span> key while clicking the project file name.</li> - <li>In the right pane of the <span class="filename">"Project Settings"</span> window, choose - <span class="filename">"C/C++".</span> From the drop down box to the - right of <span class="filename">"Category"</span>, choose - <span class="filename">"Code Generation", </span>under<span class="filename"> "Use run-time library:"</span>,<span class="filename"> - "Debug Single-Threaded"</span> should appear. If it is blank inside this box, check - if you highlight some dll project files. Change - <span class="filename">"Debug Single-Threaded" </span>to<span class="filename"> - "Debug Multithreaded" .</span></li> + + </li> + + <li> + <h4>2.2.4 Change project dependencies of +"libtest_fortran" and "hdf5_hl_fortran"</h4> + + <ul class="intable"> + + <li>Highlight project <span class="filename">"libtest_fortran"</span>, +choose <span class="filename">"Project"</span>-> + <span class="filename">"Project Dependencies", + </span>uncheck<span class="filename"> +"libtest".</span> </li> + + <li>Highlight project <span class="filename">"hdf5_hl_fortran"</span>, +choose <span class="filename">"Project"</span>-> + <span class="filename">"Project Dependencies", + </span>uncheck<span class="filename"> +"hdf5_hl" and "hdf5_fortran".</span> </li> + </ul> - </li> + + </li> + + <li> + <h4>2.2.5 Right click on the solution name "all.sln" in +the "Solution Explorer". </h4> + + <ul class="intable"> + + <li>From the pop-up menu select <span class="filename">"Convert to use Intel C++ Project System"</span> +to convert all .Net C++ project files to Intel C++ project formats. </li> + </ul> - </li> + + </li> + + <li> + <h4>2.2.6 Select "Build", then Select "Set Active +Configuration".</h4> + + <ul class="intable"> + + <li>Select<span class="filename"> "all -- +Win32 Debug" </span>or<span class="filename"> "all +-- Win32 Release"</span></li> + + <li>Disable all Fortran DLL project files listed below +and <span class="filename">ttsafedll</span> project +file:</li> + + <li>flush1_fortrandll </li> + + <li>flush2_fortrandll </li> + + <li>hdf5_fortrandll </li> + + <li>hdf5_hl_fortrandll</li> + + <li>hl_test_image_fortrandll</li> + + <li>hl_test_lite_fortrandll</li> + + <li>hl_test_table_fortrandll</li> + + <li>libtest_fortrandll </li> + + <li>testhdf5_fortrandll</li> + + <li>ttsafedll</li> + + <li>Select <span class="filename">"ok"</span>. +Select <span class="filename">"Build"</span> +-> <span class="filename">"Build" or "Rebuild All"</span> +to build Debug or Release version of HDF5 C, C++ Static and DLL Library +using Intel C++ 8.1 Compiler and HDF5 Static and High Level Fortran +Library using Intel Fortran 8.1 compiler. </li> + </ul> - <p class="note">Notes:</p> - <p class="note">1. All of the dll project files have "dll" at the end of their file names. - <p class="note">2. Static project files don't have "dll" at the end of their file names.</li> - <li> - <h4>5. Go back to <a href="#step1_4_section2">Section II, Step 1 (4)</a>, continue to build and test HDF5 - library. </h4> - </li> - </ul> - <p class="right"><a href="#section8">Go to TOP Section VIII</a></p> - <p class="right"><a href="#content_table">Go to Table of Contents</a></p> - <hr class="second"> - <h2><a name="section9">Section IX: Building and testing HDF5 snapshot release</a></h2> - <hr class="second"> - <p class="note">Notes:</p> - <p class="note">This section is only for users who would like to build and test HDF5 snapshot - release.</p> - <h3><a name="step1_section9">Step I: Generate H5Tinit.c using Microsoft - Visual C++ 6.0</a></h3> - - <ul class="intable"> - <li> - <p>For users who would like to build and test HDF5 C and C++ library, it - is necessary to manually generate H5Tinit.c before going to section II step - 1(2). Follow the steps below to generate H5Tinit.c manually using Microsoft - Visual C++ 6.0. We don't guarantee that H5Tinit.c can be - successfully created - by other compilers. </p> - <h4>1. <a href="##step1_section2" name="prevstep_section9">Previous step: section - II, step 1(1)</a><a href="#step1_section2">.</a></h4> - <h4>2. Extra steps:</h4> + + </li> + + <li> + <h4>2.2.7 Test HDF5 Static and High Level Fortran Library</h4> + <ul class="intable"> - <li>1) Open c:\myHDFstuff\hdf5\windows\misc\typegen\typegen.dsw. </h4> + + <li> + <h4><u>Test HDF5 Static Fortran Library</u></h4> + + <p>Go to directory <span class="filename">c:\myHDFstuff\hdf5\fortran\test</span>, +Run batch file <span class="filename">testhdf5_fortran.bat</span> +with the following two options to test fortran static library </p> + </li> - <li>2) Build the project file. </h4> + + <li>testhdf5_fortran release >> "Your +output file name" </li> + + <li>testhdf5_fortran debug >> "Your +output file name"</li> + + <li> + <p>Check your output files, there should be no +"failures" at all.</p> + </li> - <li>3) Invoke command prompt and go to c:\myHDFstuff\hdf5\src. </h4> + + <li> + <h4><u>Test HDF5 High Level Fortran Library</u></h4> + + <p>Go to directory <span class="filename">c:\myHDFstuff\hdf5\hl\fortran\test</span>, +Run batch file testhdf5_fortran.bat with the following two options to +test fortran static library </p> + </li> - <li>4) type H5Tinit.exe >H5Tinit.c </h4> + + <li>test_hdf5_hl_fortran release >> "Your +output file name" </li> + + <li>test_hdf5_hl_fortran debug >> "Your +output file name"</li> + + <li> + <p>Check your output files, there should be no +"failures" at all.</p> + </li> - <li>5) Go back to section II, continue with - <a href="#step1_2_section2">step 1(2).</a></li> + </ul> - </li> + + </li> + + </ul> + + <p class="right"><a href="#section7">Go +to TOP Section VII</a></p> + + <p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + + <hr class="second"> + <h2><a name="section8">Section VIII: Building +and testing Multi-threaded version of HDF5 Library </a></h2> + + <hr class="second"> + <p class="note">Notes:</p> + + <p class="note">Preconditions and Section I also apply +to this section. Users who want to build Multi-threaded version of HDF5 +library, please read those two sections carefully before go to the +following part. </p> + + <ul class="intable"> + + <li> + <h4>1. Run batch file copy_hdf.bat.</h4> + + <p>Go to <span class="filename">c:\MyHDFstuff\hdf5\windows</span> +and run <span class="filename">copy_hdf.bat</span>. +This process will copy all the necessary batch files, windows specific +source codes and text files saved under <span class="filename">c:\MyHDFstuff\hdf5\windows</span> +directory to the corresponding directories under <span class="filename">hdf5</span>. </p> + + </li> + + <li> + <h4>2. Invoke Microsoft Visual C++ compiler Invoke +Microsoft</h4> + + <p>Visual C++. From the main menu, go to <span class="filename">"File"</span> and select the <span class="filename">"Open Workspace"</span> option. Then +open the <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw</span> +workspace. You should find windows project files listed as <span class="filename">"all files, big files etc."</span> on +the left. </p> + + </li> + + <li> + <h4>3. Please refer to Section II, Step 3(3) to set the +dependencies of project "all.dsp". </h4> + + <p></p> + + </li> + + <li> + <h4>4. Change Project settings </h4> + + <ul class="intable"> + + <li>Choose <span class="filename">"Project"->"Settings",</span> + <ul class="intable"> + + <li>In the left pane of the window <span class="filename">"Project Settings"</span>, from the +drop down box to the right of <span class="filename">"Setting +For:"</span>, + <ul class="intable"> + + <li><u>Choose <span class="filename">"Win32 +Release"</span>:</u></li> + + <li>Highlight all of the static project file in +the left lower pane by pressing <span class="filename">"ctrl"</span> +key while clicking the project file name.</li> + + <li>In the right pane of the <span class="filename">"Project Settings"</span> window, +choose <span class="filename">"C/C++"</span>. From +the drop down box to the right of <span class="filename">"Category"</span>, +choose <span class="filename">"Code Generation", </span>under<span class="filename"> "Use run-time library:"</span>,<span class="filename"> "Single-Threaded" </span>should +appear. If it is blank inside this box, check if you highlight some dll +project files (see notes below). Change <span class="filename">"Single-Threaded" + </span> to <span class="filename">"Multithreaded"</span>.</li> + + <li><u>Choose <span class="filename">"Win32 +Debug"</span>; </u></li> + + <li>Highlight all of the static project file in +the left lower pane by pressing <span class="filename">"ctrl"</span> +key while clicking the project file name.</li> + + <li>In the right pane of the <span class="filename">"Project Settings"</span> window, +choose <span class="filename">"C/C++".</span> From +the drop down box to the right of <span class="filename">"Category"</span>, +choose <span class="filename">"Code Generation", </span>under<span class="filename"> "Use run-time library:"</span>,<span class="filename"> "Debug Single-Threaded"</span> +should appear. If it is blank inside this box, check if you highlight +some dll project files. Change <span class="filename">"Debug +Single-Threaded" </span>to<span class="filename"> +"Debug Multithreaded" .</span></li> + + </ul> + + </li> + + </ul> + + </li> + </ul> - <h3><a name="step2_section9">Step II: Generate H5f90i_gen.h and H5fortran_types.f90 using Compaq - Fortran 6.6c</a></h3> <p class="note">Notes:</p> - <p class="note">The users who don't want to build fortran library can skip this step.</p> - <p class="note">For users who would like to build and test HDF5 with Fortran library. - It is necessary to manually generate H5f90i_gen.h and H5fortran_types.f90 - except H5Tinit.c before going to <a href="#section1_3.2"> - section II, step1(3.2)</a>. Follow the steps below to generate these three - files. Use Microsoft Visual C++ 6.0 to generate H5Tinit.c and Compaq Fortran - 6.6c to generate H5f90i_gen.h and H5fortran_types.f90. We don't guarantee - that these three files can be created successfully by other compilers. - </p> + + <p class="note">1. All of the dll project files +have "dll" at the end of their file names. </p> + + <p class="note">2. Static project files don't have +"dll" at the end of their file names. </p> + + </li> + + <li> + <h4>5. Go back to <a href="#step1_4_section2">Section +II, Step 1 (4)</a>, continue to build and test HDF5 library. </h4> + + </li> + + </ul> + + <p class="right"><a href="#section8">Go +to TOP Section VIII</a></p> + + <p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + + <hr class="second"> + <h2><a name="section9">Section IX: Building and +testing HDF5 snapshot release</a></h2> + + <hr class="second"> + <p class="note">Notes:</p> + + <p class="note">This section is only for users who +would like to build and test HDF5 snapshot release.</p> + + <h3><a name="step1_section9">Step I: Generate +H5Tinit.c using Microsoft Visual C++ 6.0</a></h3> + + <ul class="intable"> + + <li> + <p>For users who would like to build and test HDF5 C and +C++ library, it is necessary to manually generate H5Tinit.c before +going to section II step 1(2). Follow the steps below to generate +H5Tinit.c manually using Microsoft Visual C++ 6.0. We don't guarantee +that H5Tinit.c can be successfully created by other compilers. </p> + + <h4>1. <a href="##step1_section2" name="prevstep_section9">Previous step: section II, step 1(1)</a><a href="#step1_section2">.</a></h4> + + <h4>2. Extra steps:</h4> + <ul class="intable"> - <li> - <h4>1. Previous step: <a href="#step1_section1">section - II, step 1(1)</a></h4> - <h4>2. Extra Steps:</h4> + + <li>1) Open +c:\myHDFstuff\hdf5\windows\misc\typegen\typegen.dsw. </li> + + <li>2) Build the project file. </li> + + <li>3) Invoke command prompt and go to +c:\myHDFstuff\hdf5\src. </li> + + <li>4) type H5Tinit.exe >H5Tinit.c </li> + + <li>5) Go back to section II, continue with <a href="#step1_2_section2">step 1(2).</a></li> + + </ul> + + </li> + + </ul> + + <h3><a name="step2_section9">Step II: Generate +H5f90i_gen.h and H5fortran_types.f90 using Compaq Fortran 6.6c</a></h3> + + <p class="note">Notes:</p> + + <p class="note">The users who don't want to build +fortran library can skip this step.</p> + + <p class="note">For users who would like to build and +test HDF5 with Fortran library. It is necessary to manually generate +H5f90i_gen.h and H5fortran_types.f90 except H5Tinit.c before going to <a href="#section1_3.2"> section II, step1(3.2)</a>. +Follow the steps below to generate these three files. Use Microsoft +Visual C++ 6.0 to generate H5Tinit.c and Compaq Fortran 6.6c to +generate H5f90i_gen.h and H5fortran_types.f90. We don't guarantee that +these three files can be created successfully by other compilers. </p> + + <ul class="intable"> + + <li> + <h4>1. Previous step: <a href="#step1_section1">section +II, step 1(1)</a></h4> + + <h4>2. Extra Steps:</h4> + <ul class="intable"> - <li>1)Follow the steps in <a href="#step1_section9">Step I to generate H5Tinit.c.</a></li> - <li>2) Open <span class="filename">H5fortran_detect_gen.dsw</span> under - directory <span class="filename">c:\myHDFstuff\hdf5\windows\misc\H5fortran_detect_gen</span> - Build the project file.</li> + + <li>1)Follow the steps in <a href="#step1_section9">Step +I to generate H5Tinit.c.</a></li> + + <li>2) Open <span class="filename">H5fortran_detect_gen.dsw</span> +under directory <span class="filename">c:\myHDFstuff\hdf5\windows\misc\H5fortran_detect_gen</span> +Build the project file.</li> + <li>3) Invoke command prompt and go to <span class="filename">c:\myHDFstuff\hdf5\fortran\src</span>.</li> + <li>type</li> - <li><span class="filename">H5fortran_detect_gen.exe > - H5fortran_detect.f90</span></li> - <li>4) Open <span class="filename">c:\myHDFstuff\hdf5\windows\misc\fortrantypegen\fortrantypegen.dsw.</span> - Build the project file.</li> + + <li><span class="filename">H5fortran_detect_gen.exe +> H5fortran_detect.f90</span></li> + + <li>4) Open <span class="filename">c:\myHDFstuff\hdf5\windows\misc\fortrantypegen\fortrantypegen.dsw.</span> +Build the project file.</li> + <li>5) Invoke command prompt and go to <span class="filename">c:\myHDFstuff\hdf5\fortran\src.</span></li> + <li>type</li> - <li><span class="filename">H5fortran_detect.exe > H5fort_type_defines.h</span></li> - <li>6) Open <span class="filename">c:\myHDFstuff\hdf5\windows\misc\matchtypegen\matchtypegen.dsw</span>. - Build the project file.</li> + + <li><span class="filename">H5fortran_detect.exe +> H5fort_type_defines.h</span></li> + + <li>6) Open <span class="filename">c:\myHDFstuff\hdf5\windows\misc\matchtypegen\matchtypegen.dsw</span>. +Build the project file.</li> + <li>7) Invoke command prompt and go to <span class="filename">c:\myHDFstuff\hdf5\fortran\src.</span></li> + <li>type</li> + <li><span class="filename">H5match_types.exe</span></li> - <li>This step will generate <span class="filename">H5f90i_gen.h </span> - and<span class="filename"> H5fortran_types.f90</span> automatically.</li> - </ul> + + <li>This step will generate <span class="filename">H5f90i_gen.h + </span> and<span class="filename"> +H5fortran_types.f90</span> automatically.</li> + </ul> - <h3> Step III: Go back to <a href="#section1_3.2">section II, step1(3.2)</a></h3> - - <p class="right"><a href="#section9">Go to TOP Section IX</a></p> - <p class="right"><a href="#content_table">Go to Table of Contents</a></p> - <p class="right"> </p> - <hr class="second"> - <h2><a name="section10">Section X: How to build HDF5 with Thread-Safe Feature</a></h2> - <hr class="second"> - <h3>Preconditions:</h3> - <ul class="intable"> + + </li> + + </ul> + + <h3> Step III: Go back to <a href="#section1_3.2">section +II, step1(3.2)</a></h3> + + <p class="right"><a href="#section9">Go +to TOP Section IX</a></p> + + <p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + + <p class="right"> </p> + + <hr class="second"> + <h2><a name="section10">Section X: How to build +HDF5 with Thread-Safe Feature</a></h2> + + <hr class="second"> + <h3>Preconditions:</h3> + + <ul class="intable"> + <li> - <h5>1. All of the Preconditions in <a href="#preconditions">Preconditions</a>.</h5> + <h5>1. All of the Preconditions in <a href="#preconditions">Preconditions</a>.</h5> + </li> + <li> - <h5>2. Pthread-Win32 Installed</h5> + <h5>2. Pthread-Win32 Installed</h5> + </li> + <li> - <p class="notes">Posix Threads for Windows is a open source free software. Users can download it from - <a href="http://sources.redhat.com/pthreads-win32/">http://sources.redhat.com/pthreads-win32/</a>.</p> + <p class="notes">Posix Threads for Windows is a +open source free software. Users can download it from <a href="http://sources.redhat.com/pthreads-win32/">http://sources.redhat.com/pthreads-win32/</a>.</p> + </li> - <li>HDF5 release 1.8.0 supports Pthread-Win32 2.7.0 (2005-06-04) or - later. Since pthreadVC2.dll used by HDF5 1.8.0 is the release version - dll of pthread-win32, ONLY HDF5 1.8.0 release dll are supported and - tested on Windows XP. </li> + + <li>HDF5 release 1.8.0 supports Pthread-Win32 2.7.0 +(2005-06-04) or later. Since pthreadVC2.dll used by HDF5 1.8.0 is the +release version dll of pthread-win32, ONLY HDF5 1.8.0 release dll are +supported and tested on Windows XP. </li> + <li> - <h5>3. Set Path for Pthread-Win32 header and library</h5> - + <h5>3. Set Path for Pthread-Win32 header and library</h5> + </li> + <li>Invoke Microsoft Visual C++ 6.0, go to <span class="filename">Tools->Options->Directories</span>. - - - </li> - <li>From the drop-down box under <span class="filename">"Show directories for:"</span> - <ul class="normal"> - <li>Choose <span class="filename">"Include files"</span>, add in the path to Pthread-Win32 header file(For example: <span class="filename"> - C:\PTHREADS_WIN32\INCLUDE</span>). </li> - <li>Choose <span class="filename">"Library files"</span>, add in the path to Pthread-Winew library - (For example: <span class="filename">C:\PTHREADS_WIN32\LIB</span>). - </li> - </ul> + + <li>From the drop-down box under <span class="filename">"Show +directories for:"</span> + <ul class="normal"> + + <li>Choose <span class="filename">"Include +files"</span>, add in the path to Pthread-Win32 header file(For +example: <span class="filename"> C:\PTHREADS_WIN32\INCLUDE</span>). + </li> + + <li>Choose <span class="filename">"Library +files"</span>, add in the path to Pthread-Winew library (For +example: <span class="filename">C:\PTHREADS_WIN32\LIB</span>). + </li> + + </ul> + </li> + <li> </li> + <li> - - <h5>4. Enable HDF5 Thread-safe Feature on Windows</h5> - + <h5>4. Enable HDF5 Thread-safe Feature on Windows</h5> + </li> - <li>Go to directory <span class="filename">c:\MYHDFstuff\hdf5\windows\src</span>, open <span class="filename"> - H5pubconf.h</span> and - find the following messages and remove those comment signs referred to by - those two arrows and save <span class="filename">H5pubconf.h.</span></li> + + <li>Go to directory <span class="filename">c:\MYHDFstuff\hdf5\windows\src</span>, +open <span class="filename"> H5pubconf.h</span> and +find the following messages and remove those comment signs referred to +by those two arrows and save <span class="filename">H5pubconf.h.</span></li> + <li> - - <p class="insmes">/*Users want to build and test hdf5 library with thread safe enabled,<br> - Make the following block active</br> - */</p> - + <p class="insmes">/*Users want to build and test +hdf5 library with thread safe enabled,<br> + +Make the following block active<br> + +*/</p> + </li> + <li> - - <p class="insmes">/* <---- </p> + <p class="insmes">/* <---- </p> + </li> + <li> - <p class="insmes">#if defined _DLL</p> + <p class="insmes">#if defined _DLL</p> + </li> + <li> - <p class="insmes">#define H5_HAVE_THREADSAFE 1</p> + <p class="insmes">#define H5_HAVE_THREADSAFE 1</p> + </li> + <li> - <p class="insmes">#define H5_HAVE_SYSTEM_SCOPE_THREADS 1</p> + <p class="insmes">#define +H5_HAVE_SYSTEM_SCOPE_THREADS 1</p> + </li> + <li> - <p class="insmes">#if defined TTSAFE_H</p> + <p class="insmes">#if defined TTSAFE_H</p> + </li> + <li> - <p class="insmes">#define sleep Sleep</p> + <p class="insmes">#define sleep Sleep</p> + </li> + <li> - <p class="insmes">#endif</p> + <p class="insmes">#endif</p> + </li> + <li> - <p class="insmes">#endif </p> + <p class="insmes">#endif </p> + </li> + <li> - <p class="insmes">*/ <----</p> + <p class="insmes">*/ <----</p> </li> + <li> + <h5>5. Define Environment Variable(HDF5_EXT_PTHREAD) for +PthreadVC2.lib </h5> - <h5>5. Define Environment Variable(HDF5_EXT_PTHREAD) for PthreadVC2.lib - </h5> - - </li> - <li>To define this environment variable: <span class="filename">Click - "Start" -> "Control Panel" -> - "System" -> "Advanced" -> "Environment Variables"</span>.</li> - <li> If you are logged on as administrator to the local computer AND - want to let all other users use these two environment variables, click <span class="filename"> - "New"</span> under <span class="filename">"System Variables" </span>box; - otherwise, click <span class="filename">"New"</span> under <span class="filename"> - "User Variables"</span> box. In the New Variable window, set </li> - <li> <span class="filename">"Variable name"</span> as <span class="filename"> - HDF5_EXT_PTHREAD</span> </li> - <li> <span class="filename">"Variable value"</span> as <span class="filename"> - pthreadVC2.lib</span></li> + + <li>To define this environment variable: <span class="filename">Click "Start" -> "Control Panel" +-> "System" -> "Advanced" -> "Environment +Variables"</span>.</li> + + <li> If you are logged on as administrator to the +local computer AND want to let all other users use these two +environment variables, click <span class="filename"> "New"</span> +under <span class="filename">"System Variables" </span>box; +otherwise, click <span class="filename">"New"</span> +under <span class="filename"> "User Variables"</span> +box. In the New Variable window, set </li> + + <li> <span class="filename">"Variable name"</span> +as <span class="filename"> HDF5_EXT_PTHREAD</span> </li> + + <li> <span class="filename">"Variable +value"</span> as <span class="filename"> +pthreadVC2.lib</span></li> + <li>click OK. </li> + <li> - <h5>6. Copy pthreadVC2.dll to System Directory</h5> - + <h5>6. Copy pthreadVC2.dll to System Directory</h5> + </li> - <li> <span class="filename">pthreadVC2.dll</span> should be copied into the location that - applications can find. One suggestion is to use the - <span class="filename">c:\WINDOWS\system</span>. + + <li> <span class="filename">pthreadVC2.dll</span> +should be copied into the location that applications can find. One +suggestion is to use the <span class="filename">c:\WINDOWS\system</span>. </li> + </ul> - </p> - - <h3>1. Build HDF5 Release DLL with Thread-safe Feature</h3> - + + <p></p> + + <h3>1. Build HDF5 Release DLL with Thread-safe Feature</h3> + <ul class="intable"> + <li> - - <h5>1.1 Run batch file copy_hdf.bat</h5> - </li> - <li> Go to <span class="filename">c:\MyHDFstuff\hdf5\windows</span> - and run <span class="filename">copy_hdf.bat</span>. This process will copy all the necessary batch - files,windows specific source codes and text files saved under <span class="filename">c:\MyHDFstuff\hdf5\windows</span> - directory to the corresponding directories under <span class="filename">hdf5</span>. + <h5>1.1 Run batch file copy_hdf.bat</h5> + </li> + + <li> Go to <span class="filename">c:\MyHDFstuff\hdf5\windows</span> +and run <span class="filename">copy_hdf.bat</span>. +This process will copy all the necessary batch files,windows specific +source codes and text files saved under <span class="filename">c:\MyHDFstuff\hdf5\windows</span> +directory to the corresponding directories under <span class="filename">hdf5</span>. </li> + <li> - <h5>1.2 Open workspace all.dsw</h5> - </li> - <li>Invoke Microsoft Visual C++ compiler Invoke Microsoft Visual C++. + <h5>1.2 Open workspace all.dsw</h5> + </li> - <li>From the main menu, go to <span class="filename">"File" -> "Open Workspace", </span> - browse and open the <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw</span> - workspace. </li> + + <li>Invoke Microsoft Visual C++ compiler Invoke Microsoft +Visual C++. </li> + + <li>From the main menu, go to <span class="filename">"File" +-> "Open Workspace", </span> browse and open the <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw</span> +workspace. </li> + <li> - <h5>1.3 Add in Thread-safe Source Code for HDF5 Library.</h5> + <h5>1.3 Add in Thread-safe Source Code for HDF5 Library.</h5> + </li> - <li>Expand project<span class="filename"> "hdf5dll"</span>, right click on <span class="filename">"source" - -> "Add Files - to Folder..."</span>, browse to add in file <span class="filename">"c:\MYHDFSTUFF\hdf5\src</a>\H5TS.c" </span> + + <li>Expand project<span class="filename"> +"hdf5dll"</span>, right click on <span class="filename">"source" +-> "Add Files to Folder..."</span>, browse to add in file <span class="filename">"c:\MYHDFSTUFF\hdf5\src\H5TS.c" </span> </li> + <li> - <h5>1.4 Add Link to pthreadVC2.lib </h5> - </li> - <li>Right click on project <span class="filename">"hdf5dll"</span>, choose "<span class="filename">Set - as Active Project</span>". - </li> - <li>Go to <span class="filename">"Project" -> "Setting</span>",</li> - <li>On the left pane, choose <span class="filename">"Win32 Release"</span> - to the right of <span class="filename">"Settings For:" </span> + <h5>1.4 Add Link to pthreadVC2.lib </h5> + </li> - <li>On the right pane, choose <span class="filename">"Link"</span>, choose <span class="filename"> - "Input" </span>from the drop-down box to the right of <span class="filename"> - "Category:"</span> Under <span class="filename">"Object/library modules:"</span>, - add in "<span class="filename">$(HDF5_EXT_PTHREAD)</span>" (No quotation - marks). + + <li>Right click on project <span class="filename">"hdf5dll"</span>, +choose "<span class="filename">Set as Active Project</span>". </li> - <li>Click on <span class="filename">"OK"</span>. + + <li>Go to <span class="filename">"Project" +-> "Setting</span>",</li> + + <li>On the left pane, choose <span class="filename">"Win32 +Release"</span> to the right of <span class="filename">"Settings +For:" </span> </li> + + <li>On the right pane, choose <span class="filename">"Link"</span>, +choose <span class="filename"> "Input" </span>from +the drop-down box to the right of <span class="filename"> +"Category:"</span> Under <span class="filename">"Object/library +modules:"</span>, add in "<span class="filename">$(HDF5_EXT_PTHREAD)</span>" +(No quotation marks). </li> + + <li>Click on <span class="filename">"OK"</span>. </li> + <li> - <h5>1.5 Set Project Active Configurations</h5> + <h5>1.5 Set Project Active Configurations</h5> + </li> - <li>Go to <span class="filename">"Build" -> "Set Active Configuration"</span>, choose <span class="filename">"hdf5dll-Win32 Release"</span> - under <span class="filename">"Project configurations:"</span>, Click <span class="filename">"OK".</span> </li> + + <li>Go to <span class="filename">"Build" +-> "Set Active Configuration"</span>, choose <span class="filename">"hdf5dll-Win32 Release"</span> under <span class="filename">"Project configurations:"</span>, +Click <span class="filename">"OK".</span> </li> + <li> - <h5>1.6 Build HDF5 Release DLL with Thread-safe Feature</h5> - + <h5>1.6 Build HDF5 Release DLL with Thread-safe Feature</h5> + </li> - <li>Go to <span class="filename">"Build" -> "Build hdf5dll.dll"</span> to build HDF5 Release DLL with - thread-safe feature. Warning messages can be ignored. But there should be - no failures at all. </li> + + <li>Go to <span class="filename">"Build" +-> "Build hdf5dll.dll"</span> to build HDF5 Release DLL +with thread-safe feature. Warning messages can be ignored. But there +should be no failures at all. </li> + </ul> - - <h3>2. Test Thread-safe Feature of HDF5 Release DLL</h3> - + + <h3>2. Test Thread-safe Feature of HDF5 Release DLL</h3> + <ul class="intable"> + <li> - - <h5>2.1 Build Release Version of Project libtestD</h5> + <h5>2.1 Build Release Version of Project libtestD</h5> + </li> - <li>Go to <span class="filename">"Build" -> "Set Active Configuration"</span>, choose - - <span class="filename">"libtestD-Win32 Release"</span> under <span class="filename">"Project configurations:"</span>, Click <span class="filename">"OK"</span>. - + + <li>Go to <span class="filename">"Build" +-> "Set Active Configuration"</span>, choose <span class="filename">"libtestD-Win32 Release"</span> under + <span class="filename">"Project configurations:"</span>, +Click <span class="filename">"OK"</span>. </li> + + <li>Go to <span class="filename">"Build" +-> "Build libtestD.dll"</span> to build release +version of Project <span class="filename">libtestD</span>. </li> - <li>Go to <span class="filename">"Build" -> "Build libtestD.dll"</span> to build release version of Project - - <span class="filename">libtestD</span>. </li> + <li> - - - - <h5>2.2 Build Release Version of Project ttsafedll</h5> - - - + <h5>2.2 Build Release Version of Project ttsafedll</h5> + </li> - <li>Go to <span class="filename">"Build" -> "Set Active Configuration"</span>,, choose - - <span class="filename">"ttsafedll-Win32 Release"</span> under <span class="filename">"Project configurations:"</span>, Click <span class="filename">"OK"</span>. - + + <li>Go to <span class="filename">"Build" +-> "Set Active Configuration"</span>,, choose <span class="filename">"ttsafedll-Win32 Release"</span> +under <span class="filename">"Project configurations:"</span>, +Click <span class="filename">"OK"</span>. </li> + + <li>Go to <span class="filename">"Build" +-> "Build ttsafedll.exe"</span> to build release version +of Project <span class="filename">ttsafedll.exe</span>. </li> - <li>Go to <span class="filename">"Build" -> "Build ttsafedll.exe"</span> to build release version of Project - - <span class="filename">ttsafedll.exe</span>. </li> + <li> - <h5>2.3 Install hdf5dll.dll</h5> + <h5>2.3 Install hdf5dll.dll</h5> + </li> - <li>Invoke a comand prompt, change directory to <span class="filename">c:\MYHDFSTUFF\hdf5</span>, run - batch file <span class="filename">install_dll.bat </span>to copy - - <span class="filename">c:\MYHDFSTUFF\hdf5\proj\hdf5dll\release\hdf5dll.dll</span> into system - directory. </li> + + <li>Invoke a comand prompt, change directory to <span class="filename">c:\MYHDFSTUFF\hdf5</span>, run batch +file <span class="filename">install_dll.bat </span>to +copy <span class="filename">c:\MYHDFSTUFF\hdf5\proj\hdf5dll\release\hdf5dll.dll</span> +into system directory. </li> + <li> - <h5>2.4 Test Thread-safe Feature of HDF5 Release DLL</h5> - + <h5>2.4 Test Thread-safe Feature of HDF5 Release DLL</h5> + </li> - <li>Set project file <span class="filename">ttsafedll.dsp</span> as the active project file if it is - not. Go to <span class="filename">"Build" -> "Execute ttsafedll.exe"</span>, the following is the - test messages users should get: - - </li> - <li><p class="insmes">For help use: ttsafedll.exe -help</p> + + <li>Set project file <span class="filename">ttsafedll.dsp</span> +as the active project file if it is not. Go to <span class="filename">"Build" -> "Execute ttsafedll.exe"</span>, +the following is the test messages users should get: </li> + + <li> + <p class="insmes">For help use: ttsafedll.exe -help</p> + </li> + <li> - <p class="insmes">Linked with hdf5 version 1.7 release 51 + <p class="insmes">Linked with hdf5 version 1.7 +release 51 </p> + </li> + <li> - <p class="insmes">Testing -- multi-dataset creation (dcreate) + <p class="insmes">Testing -- multi-dataset +creation (dcreate) </p> + </li> + <li> - <p class="insmes">Testing -- per-thread error stacks (error) + <p class="insmes">Testing -- per-thread error +stacks (error) </p> + </li> + <li> - <p class="insmes">Testing -- thread cancellation safety test (cancel) + <p class="insmes">Testing -- thread cancellation +safety test (cancel) </p> + </li> + <li> - <p class="insmes">Testing -- multi-attribute creation (acreate) </li> + <p class="insmes">Testing -- multi-attribute +creation (acreate) </p> + + </li> + <li> - <p class="insmes">All tests were successful. </li> + <p class="insmes">All tests were successful. </p> + + </li> + <li> - <p class="insmes">Cleaning Up temp files... </li> - <li>Users who got the similar messages as above have successfully built the - release version of hdf5dll.dll. </li> + <p class="insmes">Cleaning Up temp files... </p> + + </li> + + <li>Users who got the similar messages as above have +successfully built the release version of hdf5dll.dll. </li> + </ul> - - <h3>3. Build, Test and Install HDF5 Library and Tools</h3> - + + <h3>3. Build, Test and Install HDF5 Library and Tools</h3> + <ul class="intable"> - <li>Go back to <a href="#step1_2_section2">Section II, Step I(2)</a> to Build, test and install HDF5 libary and tools. + + <li>Go back to <a href="#step1_2_section2">Section +II, Step I(2)</a> to Build, test and install HDF5 libary and +tools. </li> + </ul> - <p class="right"><a href="#section10">Go to TOP Section X</a></p> - <p class="right"><a href="#content_table">Go to Table of Contents</a></p> - <p class="right"> </p> - <hr class="second"> - <h2><a name="section11">Section XI: Misc.</a></h2> - <hr class="second"> - <h3>1. drivers we support</h3> + <p class="right"><a href="#section10">Go +to TOP Section X</a></p> + + <p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + + <p class="right"> </p> + + <hr class="second"> + <h2><a name="section11">Section XI: How to build +HDF5 in Visual studio 2005 on windows 32-bit and 64-bit platform</a></h2> + + <hr class="second"> + <p class="note">Notes:</p> + + <p class="note">The building procedure is almost the +same as +building HDF5 on .Net 2003. </p> + + <p class="note">For 64-bit, currently we only support +HDF5 as an 32-bit application and +you may need to pay attention to the following reminders: </p> + <ul class="intable"> - <li><p>The default driver on windows we support is sec2 driver. However, stdio - driver is also supported. If you want to use stdio driver in your application, - you may set environment variable <span class="filename">HDF5_DRIVER</span> - to <span class="filename">"stdio"</span>.</p></li> - <li><p>On windows XP, the following steps should be followed to set the environment - variable.</p> - <ul class="intable"> - <li>a) Go to Control panel and find <span class="filename">"system"</span>, - </li> - <li>b) Click <span class="filename">"system"</span> and choose - <span class="filename">"advanced"</span>, - </li> - <li>c) Choose <span class="filename">Environment Variables</span></li> - <li>d) Add new variable <span class="filename">"HDF5_DRIVER"</span></li> - <li>e) set the <span class="filename">"HDF5_DRIVER"</span> to - <span class="filename">"stdio"</span></li> - </ul> - - </li> - <li> - <p class="note">Reminder:</p> - </li> - <li> - <p class="note">If you don't want to use stdio driver, please remember to delete the environment - variable "HDF5_DRIVER" or change the variable value to "sec2". </p> + + <li> + <p>1. To use zlib or szlib compression packages:</p> + + <ul class="intable"> + + <li> + <p>Use zlib 1.2.2 DLL provided at <a href="ftp://ftp.hdfgroup.org/lib-external/zlib/1.2/bin/zlib122-windows.tar.gz">ftp://ftp.hdfgroup.org/lib-external/zlib/1.2/bin/zlib122-windows.tar.gz</a></p> + + </li> + + <li> + <p>Use szlib 2.0 DLL provided at <a href="ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/xp-net">ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/xp-net</a></p> + + </li> + + </ul> + + </li> + + <li> + <p>2. Make sure that WIN32 macro is set at visual studio +2005. </p> + + </li> + + <li> + <p>3. You may use _CRT_SECURE_NO_DEPRECATE to disable the +warnings. </p> + + </li> + + </ul> + + <h4> + <p>Please refer to <a href="#section6">Section +VI: How to build HDF5 in Visual +Studio .Net 2003</a>.</p> + + <p>Please also note that the example workspace may not work +properly. You +may need to reset hdf5 library path.</p> + + </h4> + + <p class="right"><a href="#section11">Go +to TOP Section XI</a></p> + + <p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + + <p class="right"> </p> + + <hr class="second"> + <h2><a name="section12">Section XII: Misc.</a></h2> + + <hr class="second"> + <h3>1. Drivers We Support</h3> + + <ul class="intable"> + + <li> + <p>The default driver on windows we support is sec2 +driver. However, stdio driver is also supported. If you want to use +stdio driver in your application, you may set environment variable <span class="filename">HDF5_DRIVER</span> to <span class="filename">"stdio"</span>.</p> + + </li> + + <li> + <p>On windows XP, the following steps should be followed +to set the environment variable.</p> + + <ul class="intable"> + + <li>a) Go to Control panel and find <span class="filename">"system"</span>, </li> + + <li>b) Click <span class="filename">"system"</span> +and choose <span class="filename">"advanced"</span>, + </li> + + <li>c) Choose <span class="filename">Environment +Variables</span></li> + + <li>d) Add new variable <span class="filename">"HDF5_DRIVER"</span></li> + + <li>e) set the <span class="filename">"HDF5_DRIVER"</span> +to <span class="filename">"stdio"</span></li> + + </ul> + + </li> + + <li> + <p class="note">Reminder:</p> + </li> + + <li> + <p class="note">If you don't want to use stdio +driver, please remember to delete the environment variable +"HDF5_DRIVER" or change the variable value to "sec2". </p> + + </li> + </ul> - <h3>2. <a name="section11_pointers"> Helpful Pointers</a></h3> + + <h3>2. <a name="section11_pointers"> Helpful +Pointers</a></h3> + <ul class="intable"> - <li><p>Here are some notes that may be of help if you are not familiar with using the -Visual C++ Development Environment.</p></li> - <li><h3>2.1 Project name and location issues: </h3> - </li> - <li>If you must install <span class="filename">all.dsw</span> and -<span class="filename">all.dsp</span> in another directory, relative to -<span class="filename">hdf5</span> directory, you will be asked to locate the sub-project -files, when you open the project <span class="filename">all.dsw.</span> </li> - <li>If you want to rename all (the entire project), you will need to modify two files -<span class="filename">all.dsw</span> and <span class="filename">all.dsp</span> -as text (contrary to the explicit warnings in the files). </li> - <li>You can also modify <span class="filename">all.dsw</span> and -<span class="filename">all.dsp</span> as text, to allow these two files to be installed -in another directory. </li> - <li> -<h3>2.2 Settings... details:</h3> - </li> - <li>If you create your own project, the necessary settings can be read from the -<span class="filename">all.dsp</span> file(as text), or from the Project Settings -in the Developer Studio project settings dialog. </li> + + <li> + <p>Here are some notes that may be of help if you are not +familiar with using the Visual C++ Development Environment.</p> + + </li> + + <li> + <h3>2.1 Project name and location issues: </h3> + + </li> + + <li>If you must install <span class="filename">all.dsw</span> +and <span class="filename">all.dsp</span> in +another directory, relative to <span class="filename">hdf5</span> +directory, you will be asked to locate the sub-project files, when you +open the project <span class="filename">all.dsw.</span> + </li> + + <li>If you want to rename all (the entire project), you +will need to modify two files <span class="filename">all.dsw</span> +and <span class="filename">all.dsp</span> as text +(contrary to +the explicit warnings in the files). </li> + + <li>You can also modify <span class="filename">all.dsw</span> +and <span class="filename">all.dsp</span> as +text, to allow these two files to be installed in another directory. </li> + + <li> + <h3>2.2 Settings... details:</h3> + + </li> + + <li>If you create your own project, the necessary settings +can be read from the <span class="filename">all.dsp</span> +file(as text), or from the Project Settings in the Developer Studio +project settings dialog. </li> + <li>Project</li> + <li> Settings</li> - <li> C/C++</li> - <li> Category</li> - <li> + + <li> +C/C++</li> + + <li> +Category</li> + + <li> Code Generation</li> - <li> + + <li> Use run-time Library</li> + <li>These are all set to use Single-Threaded</li> + <li> -<h3>2.3 <a name="dll_hints_section4">DLL... hints:</a></h3> + <h3>2.3 <a name="dll_hints_section4">DLL... +hints:</a></h3> + </li> - <li>If you want to use DLL versions of HDF5 library in your application, you should<ol> - <li> - <p>Put HDF5 DLL into windows system directory</p> - </li> - <li> - <p>Add HDF5 DLL export library into your project</p> - </li> - <li> - <p>Follow <span class="filename">"Settings... details"</span> into the last line: - change <span class="filename">Single-Threaded </span>into - <span class="filename">Multithreaded DLL</span> or <span class="filename">Debug - Multithreaded DLL</span></p> - </li> - <li> - <p>Follow <span class="filename">"Settings.. details</span>" into PreProcessor:</p> - <p></p> - <p>Project</p> - <p> Settings</p> - <p> C/C++</p> - <p> Category</p> - <p> - PreProcessor</p> - <p>Find <span class="filename">PreProcessor definations</span> and - <span class="filename">Add _HDF5USEDLL_</span> at the end of the PreProcessor - definitions to use HDF5 C DLL.</p> + + <li>If you want to use DLL versions of HDF5 library in your +application, you should + <ol> + + <li> + <p>Put HDF5 DLL into windows system directory</p> + + </li> + + <li> + <p>Add HDF5 DLL export library into your project</p> + + </li> + + <li> + <p>Follow <span class="filename">"Settings... +details"</span> into the last line: change <span class="filename">Single-Threaded </span>into <span class="filename">Multithreaded DLL</span> or <span class="filename">Debug Multithreaded DLL</span></p> + + </li> + + <li> + <p>Follow <span class="filename">"Settings.. +details</span>" into PreProcessor:</p> + + <p></p> + + <p>Project</p> + + <p> Settings</p> + + <p> +C/C++</p> + + <p> +Category</p> + + <p> +PreProcessor</p> + + <p>Find <span class="filename">PreProcessor +definations</span> and <span class="filename">Add +_HDF5USEDLL_</span> at the end of the PreProcessor definitions to +use HDF5 C DLL.</p> + + </li> + + <li> + <p>(optional) Repeat 4), add <span class="filename">HDF5CPP_USEDLL</span> at the end of +the PreProcessor definitions to use HDF5 C++ DLL.</p> + + </li> + + <li> + <p>(optional) Follow +Project->Settings->Fortran->Category->General->Predefined +Preprocess or Symbols, and add <span class="filename">"HDF5F90_WINDOWS"</span> +to use HDF5 Fortran DLL.</p> + + </li> + + </ol> + + </li> + + </ul> + </li> + +</ul> + +<h3>3. Backward compatibility with 1.6</h3> + +<ul class="intable"> + <li> - <p>(optional) Repeat 4), add <span class="filename">HDF5CPP_USEDLL</span> at the - end of the PreProcessor definitions to use HDF5 C++ DLL.</p> + <p>If you are going to use 1.6 APIs with 1.8 branch, you may +do the following two things:</p> + + <ul class="intable"> + + <li> + <h4>3.1 Uncomment out /*#define H5_WANT_H5_V1_6_COMPAT +1*/ +inside h5pubconf.h under windows\src.</h4> + + </li> + + <li> + <h4>3.2 Set up an environment variable +H5_WANT_H5_V1_6_COMPAT to 1, this will be used to test compatibility +of error APIs.</h4> + + </li> + + </ul> + </li> + <li> - <p>(optional) Follow Project->Settings->Fortran->Category->General->Predefined - Preprocess or Symbols, and add <span class="filename">"HDF5F90_WINDOWS"</span> - to use HDF5 Fortran DLL.</p> - </li> -</ol> - - - </li> - </ul> - </li> - </ul> - <p class="right"><a href="#section10">Go to TOP Section XI</a></p> - <p class="right"><a href="#content_table">Go to Table of Contents</a></p> - <hr class="first"> - <h4>Need further assistance? email to <a href="mailto:hdfhelp@ncsa.uiuc.edu">hdfhelp@ncsa.uiuc.edu</a> or go to - <a href="http://hdf.ncsa.uiuc.edu/windows/">http://hdf.ncsa.uiuc.edu/windows/questions</a> to get help on windows</h4> - <h4 style="background-color:green;color:white;text-align:center;letter-spacing:5;">Thank you for using Hierarchical Data Format (HDF)</h4> - <p> </p> - <p> </p> - </li> - </ul> - <h3></h3> + <p>Remember to undo 1 and 2 after you test if you are not +going to use 1.6 backward compatibility option.</p> + </li> + </ul> + +<p class="right"><a href="#section12">Go to +TOP Section XII</a></p> + +<p class="right"><a href="#content_table">Go +to Table of Contents</a></p> + +<hr class="first"> +<h4>Need further assistance? email to <a href="mailto:help@hdfgroup.org">help@hdfgroup.org</a> +or go to <a href="http://hdfgroup.org/windows/">http://hdfgroup.org/windows/questions</a> +to get help on Windows</h4> + +<h4 style="background-color: green; color: white; text-align: center; letter-spacing: 5px;">Thank +you for using Hierarchical +Data Format (HDF)</h4> + +<p> </p> + +<p> </p> + +<h3></h3> + <h4></h4> + <h4></h4> </body> - -</html>
\ No newline at end of file +</html> |