beautypg.com

Purpose, Description – Compex Systems Advanced SerialRAID Adapters SA33-3285-02 User Manual

Page 305

background image

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

|