Return values – Compex Systems Advanced SerialRAID Adapters SA33-3285-02 User Manual

Page 299

Advertising
background image

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

Advertising