Open Fabrics InfiniBand Diagnostic Utilities 
                     --------------------------------------------

*******************************************************************************
RELEASE: OFED 1.4
DATE:    Dec 2008

===============================================================================
Table of Contents
===============================================================================
1. Overview
2. New features
3. Major Bugs Fixed 
4. Known Issues

===============================================================================
1. Overview
===============================================================================

The ibutils package provides a set of diagnostic tools that check the health
of an InfiniBand fabric.
Package components:
ibis:     IB interface - A TCL shell that provides interface for sending various
          MADs on the IB fabric. This is the component that actually accesses
          the IB Hardware.

ibdm:     IB Data Model - A library that provides IB fabric analysis.

ibmgtsim: An IB fabric simulator. Useful for developing IB tools.

ibdiag:   This package provides 3 tools which provide the user interface
          to activate the above functionality:
            - ibdiagnet:  Performs various quality and health checks on the IB
                          fabric.
            - ibdiagpath: Performs various fabric quality and health checks on
                          the given links and nodes in a specific path.
            - ibdiagui:   A GUI wrapper for the above tools. 

===============================================================================
2. New Features
===============================================================================


* Mellanox InfiniScaleIV support:
  - Support switches with port count > 32
  - Added ibnl (IB network) files for MTS3600 and MTS3610 InfiniScaleIV based switch systems.

* IBDM QoS Credit Loop check: 
  This check now considers SL/VL when looking for credit loops. 
  This check can be activated by running "ibdiagnet -r"

* ibdiagnet: Added -csv flag, which generated a set of Comma Separated Values
             files, which contains data about the fabric. Generated files:
               inv_csv   - Lists the ports found in the fabric
               links_csv - Lists the ports connections in the fabric
               pm_csv    - Lists port counters in csv format 
               err_csv   - Lists errors found during the run

* ibmgtsim: Add basic M_Key mechanism simulation

===============================================================================
3. Major Bugs Fixed 
===============================================================================

* ibdm: Support 2 port switches in a loaded LST file.

* ibis: fix some buffer overrun bugs with long node description.

* Installation: Ibdiagui requires tcl/tk 8.4 or 8.5 (was only 8.4). This allows
                installation on Fedora Core 9.

* ibdiagnet: Fixed -pm flag caused a crash on back to back (no switch) setup.

* ibdiagnet: Do not query port counters when local port is in INIT state.

===============================================================================
4. Known Issues
===============================================================================

- Ibdiagnet "-wt" option may generate a bad topology file when running on a
  cluster that contains complex switch systems.

- When a subnet manager is not running, ibdiagnet IPoIB check may take a long 
  time to complete.