Purpose, Description – Compex Systems Advanced SerialRAID Adapters SA33-3285-02 User Manual

Page 282

Advertising
background image

SSA_TRANSACTION SSA Adapter Device Driver ioctl Operation

Purpose

To send an SSA transaction to an SSA adapter.

Description

The SSA_TRANSACTION operation allows the caller to issue an IPN (Independent
Packet Network) transaction to a selected SSA adapter. IPN is the language that is
used to communicate with the SSA adapter. The caller must be root, or have an
effective user ID of root, to issue this operation.

IPN is described in theTechnical Reference for the adapter.

The arg parameter for the SSA_TRANSACTION operation specifies the address of a
SSA_TransactionParms_t structure. This structure is defined in the
/usr/include/sys/ssa.h file.

The SSA_TRANSACTION operation uses the following fields of the
SSA_TransactionParms_t structure:

DestinationNode

Contains the target node for the transaction.

DestinationService

Contains the target service on that node.

MajorNumber

Major number of the transaction.

MinorNumber

Minor number of the transaction.

DirectiveStatusByte

Contains the directive status byte for the transaction. This contains a value that
is defined in the /usr/include/ipn/ipndef.h file. A non-zero value indicates an
error.

TransactionResult

Contains the IPN result word that is returned by IPN for the transaction. This
contains values that are defined in the /usr/include/ipn/ipntra.h file. A
non-zero value indicates an error.

ParameterDDR

Set by the caller to indicate the buffer for parameter data.

TransmitDDR

Set by the caller to indicate the buffer for transmit data.

ReceiveDDR

Set by the caller to indicate the buffer for received data.

StatusDDR

Set by the caller to indicate the buffer for status data.

262

User’s Guide and Maintenance Information

Advertising