Note: This code was built on WIndows XP using libdap 3.7.10 in Feb 2008 with
only minor modifications to the VCPP/Makefile.
James Gallagher
22 Feb 2008
--------------------------
These are the instructions that accompany each Windows release of the OPeNDAP
Core Library known as "libdap".
Introduction
------------
This is the 3.7.3 release of libdap for MS Windows XP (or later) on 32-bit
machines. It was built using Visual C++ 8.x. Both static and dynamic
versions of the Core libraries are provided.
You must have the prerequisites for this distribution installed before
installing this distribution. The prerequisites are contained in the
libdap-prerequisites3.7.3.zip file available from http://opendap.org.
Purposes of this Distribution
-----------------------------
This distribution serves three purposes:
1) The Dynamic-link libraries necessary for running executables based
upon this version of libdap are provided.
2) The export libraries and the associated headers that are required
to OPeNDAP enable 3rd-party applications that are to be based upon this
specific version of libdap are provided. Dynamic-link libraries necessary
to run such applications are also provided. These are the tools that
experienced developers require to OPeNDAP-enable their applications.
The documentation that specifies the interface to the OPeNDAP Core Library
is not provided with this release. With this distriubution, an experienced
developer should be able to link their software with libdap to OPeNDAP-enable
it.
See the 'sample' subdirectory for a makefile that details how to compile and
link. Sample code is also provided.
3) Provides instructions for rebuilding this version of libdap from source
code.
Contents
--------
bin/ - Contains a basic OPeNDAP client "getdap"
dll/ - Provides the run-time dynamic link libraries
etc/ - Contains the 'deflate' program
include/ - Contains the headers necessary to compile
lib/ - Contains the libraries needed to link. Both a static and
dynamic version of the OPeNDAP Core library (libdapMT.lib
and libdapMD.lib respectively) are provided.
sample/ - Contains sample code and a sample makefile
readme.txt - This readme file
Installation Instruction
------------------------
1) Install the prerequisites outlined above
2) Drag-n-drop the 'bin', 'dll', 'include', 'lib', 'etc' and 'sample' directories
found in this distriubution to C:\opendap. If prompted to over write the
existing directory structure, choose 'Yes to all'.
3) Place C:\opendap\bin and C:\opendap\dll on your execution path.
Test the Install:
1) Open a DOS window
2) Issue the following command
C:\> getdap --help
If the install is successful, you should see the usage message for the getdap
utility.
Rebuilding from source code
---------------------------
To Rebuild libdap 3.7.3 from source code using MS Visual C++ 8.x,
the subversion command-line utility and the installed prerequisite package
outlined above:
1) Add BISON_HAIRY environment var and set to C:\opendap\include\bison.hairy
2) Add BISON_SIMPLE and set to C:\opendap\include\bison.simple
3) Add INCLUDE environment variable if necessary and add following to it:
C:\opendap\include
C:\opendap\include\pthreads
C:\opendap\include\libxml
C:\opendap\include\curl
4) Add LIB environment variable if necessary and add the following to it:
C:\opendap\lib
Note: Microsoft provides a means of opening a command prompt where compiler
command-line tools can be conveniently executed. Under Visual Studio,
this is available via the "Visual Studio 2005 Command Prompt" located
underneath the start->programs menu. In Visual C++ 8.x an identical
mechanism is provided. When we refer to a "command-line" window in the below
instructions, we are referring to this Microsoft-provided compiler command
prompt. We are not referring to a simple DOS Command Prompt.
Open a command-line window and:
C:\> cd C:\opendap
C:\> svn co http://scm.opendap.org:8090/svn/tags/libdap/3.7.3 libdap3.7.3
C:\> cd libdap3.7.3\VCPP
C:\> nmake grammarclean
C:\> nmake all
December 10, 2006
Robert O. Morris