Compex Systems SA33-3285-02 Network Card User Manual


 
The SSADISK_ISAL_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 Independent Packet Network (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.
u0.isal.status_descriptor
Set by the caller to indicate the buffer for status data.
u0.isal.minor_function
Set by the caller to one of the ISAL commands that is defined in the
/usr/include/ipn/ipnsal.h file and listed at the start of the description of this
operation.
Note: Structures that are provided in the /usr/include/ipn/ipnsal.h file can be used to
format the contents of the parameter buffer for the various commands. The
device driver always overwrites, with the correct handle, the handle that is
located in the first four bytes of the parameter buffer.
Return Values
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:
EIO An unrecoverable I/O error has occurred.
EINVAL
Either the caller has specified an ISAL command that is not in the list of
supported ISAL commands, or the caller has attempted to send an
FN_ISAL_FENCE command to an SSA physical disk.
EPERM
The caller did not have an effective user ID (EUID) of 0.
ENOMEM
The device driver was unable to allocate or pin enough memory to complete
the operation.
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.
Chapter 13. Using the Programming Interface 279