Ssa adapter device driver direct call entry point, Purpose, Description – Compex Systems Advanced SerialRAID Adapters SA33-3285-02 User Manual

Page 285: Return values

Advertising
background image

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

Advertising