DAPL-GM 
===========================================================================
Compilation Linux
-----------------

To compile DAPL-GM, the current Makefile in
TOPDIR/dapl/udapl/Makefile assumes a GM installation
in /opt/gm. If you have installed GM in a different
directory, you have to update the Makefile.

The compilation is invoked by calling
    make VERBS=gm

This will, by default, compile a single threaded implementation. Please
have a look at dapl/udapl/Makefile how to enable a multi
threaded version.

Compilation Windows 
-------------------

The distribution for Windows contains binary files
dat.dll and udapl.dll for GM-2. 
If you like to compile DAPL-GM yourself, you need a Microsoft
compiler and a make utility (e.g. make from cygwin).
Then use the Makefile.cygwin scripts which wil invoke the
Microsoft compiler.


Installation Linux
------------------

DAPL relies on the concept of shared libraries.
In order for an automatic discovery of necessary files
you may want to add the following lines to your ld.so.conf file
in /etc

/opt/gm/lib
/absolut/path/dapl_beta2.06/dapl/udapl/Target
/absolut/path/dapl_beta2.06/dat/udat/Target/i686

and run ldconfig afterwards.

Another required file  is  /etc/dat.conf

Applications will need to specify the provider to use (see examples).

An entry to an empty /etc/dat.conf will look like

gm0c u1.1 nonthreadsafe default /absolut/path/dapl_beta2.06/dapl/udapl/Target/libdapl.so gmdapl.1.1 "gm0c 0" "1"

Installation Windows
--------------------

Make sure you have the dat.dll in your path. 
Use the environment variable DAT_OVERRIDE to point to the
dat.conf file (e.g. set DAT_OVERRIDE=c:\dat.conf)

An entry to a valid dat.conf will look like

gm0c u1.1 nonthreadsafe default c:/absolut/path/dapl_beta2.06/dapl/udapl/Target/dapl.dll gmdapl.1.1 "gm0c 0" "1"

Examples
--------

The DAPL reference implementation provides a set of examples.

In the top directory you can run

server node:
./test/udapl/dapltest/dapltest -T S -D gm0c 

./test/udapl/dapltest/dapltest -T T -D gm0c -s "server-node"-i 10000 server SR 4096 2 client SR 4096 2
 

The example above will use provider gm0c which has been specified in the dat.conf.


Tested platforms
----------------

1 Currently Linux 2.4 and Linux 2.6 on ia32 systems has been tested.
2 Linux 2.4 and x86_64 has been slightly tested.
3 Windows Server 2003 on ia32 has been tested.

Known Issues
------------

For improved performance on E Cards, GM 2.1.9 or later is required.