INSTALLATION

Compilers:

64/32Bit, GNU (64Bit support is available with gcc3.1)

The Sockets-GM has been tested using GNU compilers and ld for
64/32Bit Mode.
The corresponding Makefile is in Sockets-GM_SHRD_LIBRARY/Makefile.solaris

64Bit, Sun Workshop:

For 64Bit code, the Sun compiler is required. 
The corresponding Makefile is in Sockets-GM_SHRD_LIBRARY/Makefile.solaris-cc


Enabling Sockets-GM:

There are two choices of establishing Sockets-GM functionality.

First is using the LD_PRELOAD mechanism.
  - This can be established using setenv (e.g: setenv LD_PRELOAD /absolute/path/libgmsocks.1.0
  - Another option is to edit /etc/ld.so.preload
    This will map *all* applications running on your cluster completey to Sockets-GM.
    This is important if you want to rsh/ssh to your cluster and start up an application which
    should be mapped to Sockets-GM/Myrinet.

Second is the Sockets-GM library.
  Add this to your linking procedure and your socket calls will automatically be mapped to 
  Myrinet



COMPILING

FLAGS

0) Edit the Makefile.in to locate GM, specify which board to use (typically 0)
1) cd to Sockets-GM_SHRD_LIBRARY
3) call make -f Makefile.extension

EXAMPLES

The examples directory contains small examples to get familiar with Sockets-GM.
There are additional Readme files which help.

Currently fork() is not supported under Solaris.
It is supported for Linux.

DEBUGGING
(to be specified in Makefile.in)

- GMSOCKS_ENABLE_DEBUG_HANDLER:
  This aids for debugging purposes. It catches a signal and will invoke the debugger
  automatically.
  When enabling, please modify the source code to use an appropriate debugger.
  If enabled, a waring message will appear.

- In addition you can set DEBUG which will give more debuggin information (printf)