General Information:
--------------------

What is Sockets-GM WSD ?

Sockets-GM WSD is a proxy driver which plugs into the Winsock
Direct Switch Architecture which is available on a limited
set of Windows Operating systems.

When installing Sockets-GM WSD for Windows, the switch
will be able to map standard Microsoft Winsock Applications
to the Myrinet System Area Network.

Winsock Applications which use the stream protocol for a
connection oriented data exchange will benefit from the
faster SAN transport than using TCP/IP over slower media.

The Winsock Direct switch will not map applications using UDP
to the Myrinet.

This distribution of Sockets-GM WSD is

                        Winsock 1.1 compliant and
                        Winsock 2 compliant.


Sockets-GM WSD Functionality
---------------------------------

-handling of multiple connections for the same hosts.
-Dispatching incoming messages
-Mixing Winsock1/2 calls.
-Addressing Overlapped I/O and Event Objects
-setsockopt operations and implications
-handling of segv , control-c etc

It is important to know that Winsock Direct Path is
a Windows build in feature.
This means, that no additional software is required to build a
high performance cluster with Microsoft Operating systems.

The supported Operating systems are
Windows 2003 Server, Windows 2000 Advanced Server Sp2 or higher,
and Windows 2000 Datacenter Server

1) run the examples as tcp/ip programs
2) install the WSD:
   Applications will use Sockets-GM_WSD who have the wsd-gm.dll in their
   path. This can be done by copying the dll into the applications
   directory.
   - call inst_wsd.exe -install        for installing,
          inst_wsd.exe -remove         for removing the
                                       Winsock Direct Proxy

3) now run the examples again which will use Myrinet as a transport

4) For Windows 2000 Advanced server you need to copy the wsd-nogm.dll
   to the system32 directory and name it wsd-gm.dll

Configuration:

There is no configuration required. Sockets-GM_WSD will detect
and probe the network to determine candidates for Sockets-GM_WSD.

Testing Platforms:
Sockets-GM_WSD has been tested on x86/ia32 machines running
Windows 2000 Advanced Server with Service Pack 4

Sockets-GM_WSD has also been tested on x86/ia32 machines
running Windows 2003 Server

Two performing DLL's 

1) Have a wsd-gm.dll which is polling (default)
2) Have a wsd-gm-blocking-receive.dll which needs to
be named wsd-gm.dll to take effect.

The blocking receive will lower CPU overhead while providing 
less performance when running micro benchmarks.
The overall performance on applications should be better.

Limitations:

WSADuplicateHandle is currently not supported.