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

Page: 301 / 531

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