# README file for low-level Ethernet tramsport layer for Open MPI (btl eth)

License
-------
 
 * see file LICENSE 

Installing
----------

 * kernel part: 
  - cd kernel && make && insmod ./af_enet.ko
 
 * Open MPI part: 
  - get Open MPI (release 1.0 tested, newer releases might work too)
  - create new btl_eth directory (mca/btl/eth)
  - re-run autogen.sh in Open MPI root (probably needs svn version)
  - ./configure && make


Running
-------

 * run Open MPI with mpirun -mac btl eth ...


Code hints
----------

 * the code is unmaintained since 2007 and prvided without any
   guarantees or support (use at your own risk)

Citation 
--------
Any published work which uses this software should include the following
citation:
----------------------------------------------------------------------
T. Hoefler, M. Reinhardt, F. Mietke, T. Mehlan, and W. Rehm: "Low
Overhead Ethernet Communication for Open MPI on Linux Clusters"
Chemnitzer Informatik Berichte CSR-06, Jul. 2006, ISSN 0947-5125
----------------------------------------------------------------------

More to read
------------
The following Diploma Theses have dealt with this topic:
http://archiv.tu-chemnitz.de/pub/2006/0025/data/index.html
http://archiv.tu-chemnitz.de/pub/2007/0162/index.html
