Filter
Top Products
You can use the open or the openx subroutine call to open the SSA adapter device
driver. If you use the openx subroutine call, set the ext parameter to 0, because the call
does not use it.
Summary of SSA Error Conditions
If an open or ioctl subroutine that has been issued to an SSA adapter fails, the
subroutine returns -1, and the global variable errno is set to a value from the file
/usr/include/sys/errno.h.
Possible errno values for the SSA adapter device driver are:
EINVAL
An unknown ioctl was attempted or the parameters supplied were not valid.
EIO An I/O error occurred.
ENOMEM
The command could not be completed because not enough real memory or
paging space was available.
ENXIO The requested device does not exist.
Managing Dumps
The SSA adapter device driver is a target for the system dump facility.
The DUMPQUERY option returns a minimum transfer size of 0 bytes and a maximum
transfer size that is appropriate for the SSA adapter.
To be processed, calls to the SSA adapter device driver DUMPWRITE option should
use the arg parameter as a pointer to the SSA_Ioreq_t structure, which is defined in
/usr/include/sys/ssa.h. Using this interface, commands for which the adapter provides
support can be run on a previously started (opened) target device. The SSA adapter
device driver ignores the uiop parameter.
Note: Only the SsaMCB.MCB_Result field of the SSA_Ioreq_t structure is set at
completion of the DUMPWRITE. During the dump, no support is provided for
error logging.
If the dddump entry point completes successfully, it returns a 0. If the entry point does
not complete successfully, it returns one of the following:
EINVAL
A request that is not valid was sent to the adapter device driver; for example, a
request for the DUMPSTART option was sent before a DUMPINIT option had
been run successfully.
EIO The adapter device driver was unable to complete the command because the
required resources were not available, or because an I/O error had occurred.
ETIMEDOUT
The adapter did not respond with status before the passed command time-out
value expired.
Chapter 13. Using the Programming Interface 259