mirror of
https://github.com/HDFGroup/hdf5.git
synced 2024-11-27 02:10:55 +08:00
7f22651492
Description: Previously, we needed to force symbol definition "gethostname@8" for compatibility with old versions of Visual Studio. It appears that Visual Studio no longer requires this, so we remove it. This makes the build process on 64-bit much smoother. Also minor updates to main documentation, command-line documentation, and removed codewarrior and INTEL docs. Tested: VS.NET VS2005 chkmanifest
139 lines
5.1 KiB
Plaintext
Executable File
139 lines
5.1 KiB
Plaintext
Executable File
************************************************************************
|
|
* Instructions for Building and Testing HDF5 on Windows XP *
|
|
* (From Command Line) *
|
|
************************************************************************
|
|
Note: This instruction is written for users who would like to build HDF5
|
|
libraries and tools from the HDF5 source code package on command
|
|
line.
|
|
|
|
Currently, we support
|
|
|
|
1. Building and testing HDF5 on command line with Microsoft Visual
|
|
Studio .NET
|
|
|
|
|
|
For all other Windows development tools, HDF5 should be built in
|
|
the development environment. Please refer to INSTALL_Windows.txt
|
|
for detailed HDF5 building and installation information, or
|
|
INSTALL_Windows_short.txt for quick HDF5 building and installation
|
|
instructions.
|
|
|
|
WARNINGS:
|
|
|
|
Please read CAREFULLY about HDF5 build and install preconditions and
|
|
notes in INSTALL_Windows.txt before starting below procedures.
|
|
|
|
|
|
========================================================================
|
|
Section I: Building and testing HDF5 on command line with Microsoft
|
|
Visual Studio .NET
|
|
========================================================================
|
|
|
|
1. Preconditions:
|
|
|
|
1.1 Verify environment for Visual Studio .NET
|
|
|
|
Building from the command line requires environment variables for Visual
|
|
Studio. These are generally setup when Visual Studio is installed, but you
|
|
can verify by running the command:
|
|
|
|
echo %vs71comntools%
|
|
|
|
This should output a path similar to:
|
|
|
|
C:\Program Files\Microsoft Visual Studio .NET 2003\Common7\Tools\
|
|
|
|
1.2 Run batch file copy_hdf.bat.
|
|
|
|
Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat.
|
|
|
|
2. Building and testing HDF5 libraries and tools
|
|
|
|
We provide 2 options for users to build and test HDF5 libraries
|
|
and tools.
|
|
|
|
2.1 Options A: Build and test in one step
|
|
|
|
A batch file named hdf5bt.bat in c:\MyHDFstuff\hdf5 directory is
|
|
provided for users to build and test HDF5 library and tools together
|
|
from command line.
|
|
|
|
hdf5bt.bat currently takes no parameters:
|
|
|
|
hdf5bt build and test C/C++ library and tools
|
|
|
|
Invoke a command prompt window and run hdf5bt. Test results are saved
|
|
in two files:
|
|
|
|
c:\MyHDFstuff\hdf5\check_results.txt
|
|
|
|
c:\MyHDFstuff\hdf5\tests_results.txt.
|
|
|
|
In general, you only need to check tests_results.txt. If all the tests
|
|
passed, then you do not have to check check_results.txt. If some tests
|
|
failed, check check_results.txt can help you figure out what was wrong.
|
|
|
|
2.2 Options B: Build and test in two steps
|
|
|
|
We also provide users with the option to build and test HDF5 libraries
|
|
and tools seperately.
|
|
|
|
Step 1) Build HDF5 Libraries and Tools
|
|
|
|
A batch file named hdf5build.bat in c:\MyHDFstuff\hdf5
|
|
directory is provided for users to build HDF5 library and
|
|
tools from command line.
|
|
|
|
hdf5build.bat currently takes no parameters:
|
|
|
|
hdf5build build HDF5 C/C++ library and tools
|
|
|
|
Invoke a command prompt window and run hdf5build. Compiling outputs
|
|
are saved in c:\MyHDFstuff\hdf5\build_results.txt. You can check
|
|
the file to find out whether there are any compilation errors.
|
|
|
|
Step 2) Test HDF5 Libraries and Tools
|
|
|
|
A batch file named hdf5check.bat in c:\MyHDFstuff\hdf5
|
|
directory is provided for users to test HDF5 library
|
|
and tools from command line.
|
|
|
|
hdf5check.bat has four options:
|
|
|
|
hdf5check Test HDF5 C Libraries and Tools
|
|
|
|
hdf5check enablecpp Test HDF5 C/C++ Libraries and Tools
|
|
|
|
hdf5check enablefortran Test HDF5 C/Fortran Libraries
|
|
and Tools
|
|
|
|
hdf5check enableall Test HDF5 C/C++/Fortran Libraries
|
|
and Tools
|
|
|
|
Invoke a command prompt window and run hdf5check with apropriate
|
|
options.
|
|
|
|
Test results are saved in two files:
|
|
|
|
c:\MyHDFstuff\hdf5\tests_results.txt
|
|
|
|
c:\MyHDFstuff\hdf5\check_results.txt.
|
|
|
|
In general, you only need to check tests_results.txt. If all the
|
|
tests passed, then you do not have to check check_results.txt. If
|
|
some tests failed, check check_results.txt can help you figure out
|
|
what was wrong.
|
|
|
|
3. Installing HDF5 Libraries
|
|
|
|
Run the batch file c:\MyHDFstuff\hdf5\installhdf5lib.bat to install all
|
|
HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib directory.
|
|
|
|
For further information, please refer to INSTALL_WINDOWS.txt.
|
|
|
|
|
|
***********************************************************************
|
|
For further information, please refer to INSTALL_WINDOWS.txt.
|
|
|
|
Please send email to help@hdfgroup.org for further assistance.
|