README
                      Linux* HBAAPI Vendor Library
                      ============================

Introduction
------------

HBAAPI stands for Host Bus Adapter API (Applications Programming Interface).
It is a C-level shared library to manage Fibre Channel Host Bus Adapters.
The HBAAPI library source code may be downloaded from http://sourceforge.net/.
For a detailed description of HBAAPI please see the FC-HBA working draft in
http://www.t11.org/index.html. The HBAAPI shared library will also be built
when the vendor library is built, and will be named as libHBAAPI.so.

The HBAAPI vendor library is a shared library with functions that support
the API routines in the HBAAPI library. The HBAAPI vendor library will be
named as libhbalinux.so and is loaded by the HBAAPI library as a dynamic
library when the HBAAPI library is initialized. The vendor library invokes
the /sys file system for information of FCoE network adapters, local ports,
remote ports and discovered LUNs. It also gets adapter information with
the assistance from libpciaccess while the information are not available in
/sys. The ioctl calls are only used for SG_IO to issue SCSI commands to
generic scsi block devices. No ioctl are called to the libfc.ko or fcoe.ko
modules.

When applications are developed to link with libHBAAPI.so, they may
indirectly invoke libhbalinux.so behind the libHBAAPI.so. For instructions
of how to build and install the libraries, please see the file INSTALL.


In This Release
---------------

This release of the vendor library is implemented in association with the
version 2.2 (August 2002) of HBAAPI code from Source Forge.

The supported API's in this release are:

    HBA_GetVersion
    HBA_LoadLibrary
    HBA_FreeLibrary
    HBA_RegisterLibrary
    HBA_GetNumberOfAdapters
    HBA_GetAdapterName
    HBA_OpenAdapter
    HBA_CloseAdapter
    HBA_GetAdapterAttributes
    HBA_GetAdapterPortAttributes
    HBA_GetPortStatistics
    HBA_GetFC4Statistics
    HBA_GetFcpTargetMapping
    HBA_GetFcpTargetMappingV2
    HBA_SendScsiInquiry
    HBA_SendReportLUNs
    HBA_SendReadCapacity
    HBA_ScsiInquiryV2
    HBA_ScsiReportLUNsV2
    HBA_ScsiReadCapacityV2

Libhbalinux is maintained at www.Open-FCoE.org and the latest version can
be obtained there. Questions, comments and contributions should take place
on the development mailing list at www.Open-FCoE.org as well.