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

Page 301

Advertising
background image

SSADISK_ISALMgr_CMD (ISAL Manager Command) SSA Disk Device Driver ioctl
Operation

Purpose

To provide a method of sending Independent Network Storage Access Language (ISAL)
Manager commands to an SSA physical or logical disk drive. ISAL consists of a set of
commands that allow a program to control and access a storage device.

The ISAL command set is described in the Technical Reference for the adapter.

Description

The SSADISK_ISALMgr_CMD operation allows the caller to issue an ISAL command
to a selected logical or physical disk. The caller must be root, or have an effective user
ID of root, to issue this ioctl.

The following ISAL commands (minor function codes) that are defined in the
/usr/include/ipn/ipnsal.h file can be issued:

FN_ISALMgr_Inquiry

FN_ISALMgr_HardwareInquiry

FN_ISALMgr_GetPhysicalResourceIDs

FN_ISALMgrVPDInquiry

FN_ISALMgr_Characteristics

FN_ISALMgr_Statistics

FN_ISALMgr_FlashIndicator

The arg parameter for the SSADISK_ISALMgr_CMD ioctl is the address of an
ssadisk_ioctl_parms structure. This structure is defined in the
/usr/include/sys/ssadisk.h file.

The SSADISK_ISALMgr_CMD ioctl uses the following fields of the
ssadisk_ioctl_parms structure:

dsb

Contains the directive status byte that is returned for the command. The byte
contains a value from the /usr/include/ipn/ipndef.h file. A non-zero value
indicates an error.

result

Contains the IPN result word that is returned by IPN for the command. The
word contains values from the /usr/include/ipn/ipntra.h file. A non-zero value
indicates an error.

u0.isal.parameter_descriptor

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

u0.isal.transmit_descriptor

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

u0.isal.receive_descriptor

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

Chapter 13. Using the Programming Interface

281

Advertising