User Manual

Open SCSI for Fibre Channel Controller Integrator’s Manual for HP Integrity NonStop NS-Series Servers—
3-1
3
Interfacing With the Open SCSI I/O
Process (IOP)
This section discusses software topics associated with writing device drivers to
interface with the Open SCSI I/O process (IOP), T8995. These methods include
Common Access Method (CAM) control blocks (CCBs), CAM operations, and IOP
status values. This section describes:
•
Guardian Procedure Calls on page 3-1
•
Using the FILE_OPEN_ Procedure on page 3-1
•
Using the WRITEREAD[X] Procedures on page 3-3
•
Structure of the WRITEREAD Buffer on page 3-5
•
SIM Queue Operations on page 3-14
•
IOP Status Values on page 3-15
Guardian Procedure Calls
The Open SCSI IOP provides support for these Guardian procedure calls:
•
FILE_OPEN_
•
WRITEREAD[X]
•
AWAITIO[X]
•
CANCELREQ
•
DEVICE_GETINFOBYLDEV_
•
DEVICE_GETINFOBYNAME_
•
FILE_CLOSE_
•
FILE_GETINFO_
•
FILE_GETINFOBYNAME_
•
FILE_GETINFOLIST_
•
FILE_GETINFOLISTBYNAME_
The remainder of this subsection discusses only the aspects of these Guardian
procedure calls that apply to the Open SCSI interface.
Using the FILE_OPEN_ Procedure
The Guardian FILE_OPEN_ procedure establishes a communications path between an
application process and a file. When FILE_OPEN_ successfully finishes, it returns a
file number to the caller. The file number identifies this communications path in
Note. For a complete description of the purpose, use, syntax, parameters, and limitations of
the Guardian procedure calls, refer to the Guardian Procedure Calls Reference Manual.