IBM Advanced SerialRAID Adapters SA33-3285-02, User Manual

Page: 305 / 531

SSADISK_LIST_PDISKS SSA Disk Device Driver ioctl Operation
Purpose
To provide a method of determining which SSA physical disk drives make up a SSA
logical disk drive.
Description
The SSADISK_LIST_PDISKS operation can be issued by any user to an SSA logical
disk (hdisk). The operation returns a list of the SSA physical disks (pdisks) that make
up the specified logical disk drive.
The arg parameter for the SSADISK_LIST_PDISKS operation is the address of an
ssadisk_ioctl_parms structure. This structure is defined in the
/usr/include/sys/ssadisk.h file.
The SSADISK_LIST_PDISKS operation uses the following fields of the
ssadisk_ioctl_parms structure:
u0.list_pdisks.name_array
Pointer to the array of ssadisk_name_desc_t structures that is in the caller
memory. On return from the ioctl, this array is filled with the names of the
hdisks.
u0.list_pdisks.name_array_elements
Set by the caller to indicate the number of elements that are in the array at
which the
u0.list_pdisks.name_array
parameter is pointing.
u0.list_pdisks.name_count
On return from the ioctl, this field indicates the number of names that are in
the name array at which the
u0.list_pdisks.name_array
parameter is pointing.
u0.list_pdisks.resource_count
On return from the ioctl, this field indicates the number of physical disk drives
that make up the logical disk drive. This number might be less than
u0.list_pdisks.name_count
if, in the user memory, not enough elements were
allocated in the named array to hold all the pdisk names, or if one or more
physical disk drives that make up the logical disk have not been configured as
physical disk drives.
Chapter 13. Using the Programming Interface
285
|