hdf5/release_docs/INSTALL_codewarrior.txt
Pedro Vicente Nunes f1031738ef [svn-r8175] Purpose:
same changes that were done for 1.6 regarding CW install

Description:

Solution:

Platforms tested:

Misc. update:
2004-02-10 13:18:10 -05:00

75 lines
3.1 KiB
Plaintext

Instructions for Building the HDF5 Library, Tests, and Tools
with the Metrowerks Code Warrior Compiler
---------------------------------------------------------------------------
The HDF5 library is supported under the Metrowerks Code Warrior version 8.0 compiler.
The Code Warrior port of the HDF5 library has been tested only on the
Windows NT platform.
The following instructions assume we will be using the path D:\hdf5 for installing the library.
------------------------------------------------------------------------
Pre conditions:
-------------------------------------------------------------------------
Both the ZLIB and SZIP libraries are needed to link with HDF5.
The Code Warrior project file settings assumes ZLIB is intalled in D:\zlib\zlib.lib
and SZIP is installed in D:\szip\codewarrior\szip.lib
These precompiled libraries can be obtained from the HDF web site,
please see hdf.ncsa.uiuc.edu for downloading instructions.
If you do not have these libraries installed on these locations, you must change
the path in the Project Settings (menu Edit->Settings->Target->Access Paths)
-------------------------------------------------------------------------
Setup
--------------------------------------------------------------------------
1. This setup assumes that you installed the distribution zip file as
explained in INSTALL_windows.txt file. The steps are
a) making a folder called <my install>/hdf5/ as your base hdf5 folder
b) unpack the file all.zip located in d:\hdf5\windows to d:\.
This file contains the Windows specific files of HDF5.
To build the HDF5 library with Code Warrior:
1. Open the project file hdf5.mcp (located in d:\hdf5\proj\codewarrior\).
2. To build the library:
Select the 'hdf5' target and build (menu Projects-> Make or F7 key).
3. To build all the targets (HDF5 library, test, and tools):
Select the 'all' target and build.
4. To run the tests in a command line window:
In the command line window, change directory to d:\hdf5\test\.
Type
Hdf5test debug
or, to redirect the output to a file called myfile.txt,
Hdf5test debug > myfile.txt
The test and tools files are generated in the same directory as
those compiled with the Microsoft Visual Studio compiler.
---------------------------------------------------------------------------
Known problems
---------------------------------------------------------------------------
The test "testhdf5" fails on a open file call. This is caused by a CodeWarrior v8.0
bug in the "open" function
Metrowerks provides a patch for this error
1) Edit the file file_io.win32.c, located on <MY_INSTALL\MSL\MSL_C\MSL_Win32\Src\>
2) Change the following symbol to 1 instead of 0
#define _MSL_ALLOW_SHARED_WRITING 0
/* Set this value to 1 for file opening with shared writing */
3) Add this source code to your project and relink it with your application.
A source code in a project overrides the library source.
---------------------------------------------------------------------------
The HDF Group would like to thank Ron Liechty of Metrowerks technical
support for all the help provided during the development of this project.