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
Summary of Contents for Advanced SerialRAID Adapters SA33-3285-02
Page 1: ...Advanced SerialRAID Adapters User s Guide and Maintenance Information SA33 3285 02 ...
Page 2: ......
Page 3: ...Advanced SerialRAID Adapters User s Guide and Maintenance Information SA33 3285 02 ...
Page 16: ...xiv User s Guide and Maintenance Information ...
Page 18: ...xvi User s Guide and Maintenance Information ...
Page 21: ...Part 1 User Information 1 ...
Page 22: ...2 User s Guide and Maintenance Information ...
Page 48: ...28 User s Guide and Maintenance Information ...
Page 64: ...44 User s Guide and Maintenance Information ...
Page 76: ...56 User s Guide and Maintenance Information ...
Page 212: ...192 User s Guide and Maintenance Information ...
Page 228: ...208 User s Guide and Maintenance Information ...
Page 230: ...210 User s Guide and Maintenance Information ...
Page 254: ...234 User s Guide and Maintenance Information ...
Page 274: ...254 User s Guide and Maintenance Information ...
Page 330: ...310 User s Guide and Maintenance Information ...
Page 331: ...Part 2 Maintenance Information 311 ...
Page 332: ...312 User s Guide and Maintenance Information ...
Page 338: ...318 User s Guide and Maintenance Information ...
Page 430: ...410 User s Guide and Maintenance Information ...
Page 503: ...Part 3 Appendixes 483 ...
Page 504: ...484 User s Guide and Maintenance Information ...
Page 508: ...488 User s Guide and Maintenance Information ...
Page 529: ......
Page 530: ...Part Number 27H0678 Printed in the U S A SA33 3285 02 1P P N 27H0678 ...
Page 531: ...Spine information Advanced SerialRAID Adapters User s Guide and Maintenance Information ...