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

Page 298

Advertising
background image

SSADISK_ISAL_CMD (ISAL Command) SSA Disk Device Driver ioctl Operation

Purpose

To provide a method of sending Independent Network Storage Access Language (ISAL)
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_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) that are defined in the
/usr/include/ipn/ipnsal.h file can be issued:

FN_ISAL_Read

FN_ISALWrite

FN_ISAL_Format

FN_ISAL_Progress

FN_ISAL_Lock

FN_ISAL_Unlock

FN_ISAL_Test

FN_ISAL_SCSI

FN_ISAL_Download

FN_ISAL_Fence

Notes:

1. Some of these commands are not valid for SSA hdisks, but are valid for SSA

pdisks; others are valid for SSA hdisks, but are not valid for SSA pdisks. The
adapter card (not the device driver) checks whether the commands are valid. If the
caller attempts to send a command to a device for which that command is not valid,
the adapter returns a non-zero result. The exception to this procedure occurs when
any attempt is made to send a FN_ISAL_Fence command to a SSA physical disk.
The device driver rejects any such attempt with EINVAL.

2. The adapter rejects the FN_ISAL_SCSI command with a non-zero result if that

command 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.

278

User’s Guide and Maintenance Information

Advertising