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

What is Sockets-GM LSP ?

Sockets-GM LSP is a Layered Service Provider which
maps 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.

In addition, applications using UDP will be mapped to Myrinet as
well.


This distribution of Sockets-GM LSP is

                        Winsock 1.1 compliant and
                        Winsock 2 compliant.


Different Winsock Versions:


With Winsock1.1 the following routines have been interfaced:
===============================================================
accept, bind, closesocket, socket, send, recv, select, shutdown, ...


With Winsock2 the following function have been interfaced:
===============================================================
WSAAccept, WSAAcceptEx, WSAConnect, WSADuplicateSocket,
WSAGetOverlappedResult, WSAIoctl, WSARecv, WSARecvEx, WSARecvDisconnect,
WSASend, WSASocket, TransmitFile, ...


Sockets-GM LSP 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


Installation/ Requirements:

Sockets-GM

It is important to know that LSPs are a WIN32 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 NT 4.0 and higher,
Windows 2000 Professional , Windows 2000 Server, Windows 2000
Advanced Server and Windows 2000 Datacenter Server

1) The release of Sockets-GM_LSP is in binary format
2) run the examples as tcp/ip programs to get familiar

3) install the LSP
   The inst_lsp.exe program will automatically install/remove the
   Layered Service Provider.
   First copy the plain_lsp.dll to the %SYSTEMROOT%\system32 directory.
   When copying rename the file to lsp.dll
   copy plain_lsp.dll %SYSTEMROOT%\system32\lsp.dll
   Now you can call inst_lsp.exe

   For any application you want to run using GM, copy the lsp.dll into
   the applications directory.

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


GM Configuration:

Set the GM hostname to the hosts IP address.
E.g: gm_set_name --host-name=192.168.1.111


Limitations:

- There are 16 ports available with GM-2, 8 ports with GM-1
  This limits the numbers of processes per host. Since all applications
  would otherwise try to use Sockets-GM_LSP, the plain_lsp.dll is a fall
  through lsp and will not use GM.
- Sockets-GM does not currently handle WSADuplicateSocket