Fibre Channel SNIA HBA API Programmer's Guide

hbaapilib.c - Implements the common HBA API library as of FC HBA API Specifications

Version 1.0 from the SNIA.

This code has been modified and enhanced for HP-UX from original open source code obtained

from http://www.snia.org. Author Benjamin F. Kuo, Troika Networks, Inc. Code contributors:

Tuan Lam, QLogic Corp.; Dan Willie, Emulex Corp.; Hari Hara Kumar M., Hewlett-Packard Co.

Hewlett-Packard Co., hereby grants a non-exclusive license under Hewlett-Packard Co.'s copyright

to copy, modify and distribute this software for any purpose and without fee, provided that the

above copyright notice and the following paragraphs appear on all copies. Hewlett-Packard Co.,

makes no representation that this source code is correct or is an accurate representation of any

standard.

In no event shall Hewlett-Packard have any liability for any direct, indirect, or speculative

damages, (including, without limiting the forgoing, consequential, incidental and special damages)

including, but not limited to infringement, loss of use, business interruptions, and loss of profits,

respective of whether Hewlett-Packard has advance notice of the possibility of any such damages.

Hewlett-Packard Co. specifically disclaims any warranties including, but not limited to, the

implied warranties of merchantability, fitness for a particular purpose, and non-infringement.

The software provided hereunder is on an "as is" basis and Hewlett-Packard Co. has no obligation

to provide maintenance, support, updates, enhancements, or modifications.

Terms and Acronyms in this Guide

The following is a list of important terms in this guide:

• vendor library - refers to the library that interacts with drivers to get information requested

by the user. Multiple vendor libraries (each talking to different drivers) can be attached to

one common library.

• common library - library that implements the SNIA API for applications. The library is

common for all Fibre Channel adapters regardless of whether different drivers are managing

adapters. Vendor libraries for drivers must conform to specifications in this guide to be

attached to the common library.

• adapter - refers to the physical communications hardware.

• port - designates the physical connection point for communication.

The following table lists the acronyms used in this guide:

Table 1-1 Acronyms in this Guide

DefinitionAcronym

Application Programming InterfaceAPI

Extended Link ServiceELS

Fibre ChannelFC

Fibre Channel ProtocolFCP

Host Bus AdapterHBA

Logical UnitLUN

Online Addition and ReplacementOLAR

Remote Node Identification DataRNID

Storage Area NetworkSAN

Storage Networking Industry AssociationSNIA

World Wide NameWWN

8 FC SNIA HBA API Overview