Fibre Channel SNIA HBA API Programmer's Guide

A Call Order Sequence
Appendix A explains the call order sequence for FC SNIA HBA API functions.
Call Order Sequence
The following are pictorial representations of the call sequence order that should be followed
by applications using HP's implementation of the FC SNIA HBA API. Before a call is made to
any of the functions, a call to all the previous functions above it must be made at least once for
the corresponding library, adapter, port, discovered-port functions.
NOTE: The correct return value, listed below each function in the figures, must be received
before the next function is called.
Reading HP's Vendor Library Call Order (Figure A-2)
In Figure A-2, the call order sequence for functions outlined by the dotted-box is enforced only
by HP's vendor library implementation. Other vendor libraries may enforce this call order
sequence differently. The vendor call order sequence enclosed in this box is valid between the
first HBA_OpenAdapter() and the last HBA_CloseAdapter() for the same adapter.
When a card is available, then becomes unavailable, and then becomes available again, the vendor
call order sequence enclosed in the dotted-box should be repeated from
HBA_GetAdapterAtributes() to recognize new configurations.
NOTE: HBA_GetAdapterAttributes() must be called after a disk is added or replaced to
recognize new configurations.
Common Library Call Order
Call Order Sequence 39