IBM Advanced SerialRAID Adapters SA33-3285-02, User Manual

Page: 285 / 531

SSA Adapter Device Driver Direct Call Entry Point
Purpose
To allow another kernel extension to send transactions to the SSA adapter device
driver. This function is not valid for a user process. When the function completes its run,
an off-level interrupt notifies the caller. See SSA_GET_ENTRY_POINT SSA adapter
ioctl operation.
Description
The entry point address is the address that is returned in EntryPoint by the
SSA_GET_ENTRY_POINT ioctl operation. The function takes a single parameter of
type SSA_Ioreq_t, which is defined in the /usr/include/sys/ssa.h file.
The fields of the SSA_Ioreq_t structure are used as follows:
SsaDPB
An array of size SSA_DPB_SIZE, which is used by the SSA adapter device
driver, and should be initialized to all NULLs.
SsaNotify
The address of the function in the SSA head device driver that the SSA
adapter device driver calls when the directive has completed.
u0
The transaction to be executed. Valid transactions are described in the
Technical Reference for the adapter.
Return Values
This function does not return errors. You can determine success or failure of the
directive by examining the directive status byte and transaction result fields, which are
set up in the SSA MCB. For details, see the Technical Reference for the adapter.
Chapter 13. Using the Programming Interface
265