Provides a means to send Independent Network Storage Access Language (ISAL) commands to an SSA physical or logical disk drive. ISAL comprises a set of commands which allow a program to control and access a storage device. The ISAL Command set is described in the SSA Adapter Technical Reference.
The SSADISK_ISAL_CMD operation allows the caller to issue an ISAL command to a selected logical or physical disk drive. The caller must be root or have an effective user ID of root to issue this ioctl.
The following ISAL commands (minor function codes), defined in /usr/include/ipn/ipnsal.h may be issued:
FN_ISAL_ReadNotes:
- Some of these commands are not valid for one or other of SSA hdisks or SSA pdisks. This is not checked by the device driver but by the adapter card. If the caller attempts to send a command to a device for which it is not valid, the result returned by the adapter will be non-zero. The exception to this is that the device driver will reject with EINVAL any attempt to send a FN_ISAL_Fence command to a SSA physical disk.
- The FN_ISAL_SCSI command is rejected by the adapter with a non-zero result if it is sent to a device that has not been opened with the SSADISK_SCSIMODE extension parameter.
The arg parameter for the SSADISK_ISAL_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_ISAL_CMD ioctl uses the following fields of the ssadisk_ioctl_parms structure:
Note: Structures are provided in /usr/include/ipn/ipnsal.h that can be used to format the contents of the parameter buffer for the various commands. In all cases, the handle which is located in the first four bytes of the parameter buffer will be overwritten by the device driver with the correct handle for the device.
If the command was successfully sent to the adapter card this operation returns a value of 0. Otherwise, a value of -1 is returned and the errno global variable set to one of the following values:
If the return code is 0, the result field of the ssadisk_ioctl_parms structure is valid. This indicates whether the adapter was able to process the command successfully.
The SSA Adapter Device Driver, ssadisk SSA Disk Device Driver, SSA Subsystem Overview.