[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Technical Reference: Kernel and Subsystems, Volume 2
SSADISK_LIST_PDISKS SSA Disk Device Driver ioctl Operation
Purpose
Provides a means to determine which SSA physical
disk drives make up a SSA logical disk drive.
Description
The SSADISK_LIST_PDISKS operation
may be issued by any user to a SSA logical disk (hdisk). It returns a list
of the SSA physical disks (pdisks) which 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:
Field |
Description |
u0.list_pdisks.name_array |
Pointer to array of ssadisk_name_desc_t structures
in the caller's memory. It is this array which is filled in with the names
of the hdisks on return from the ioctl. |
u0.list_pdisks.name_array_elements |
Set by the caller to indicate the number of elements in the array
pointed at by the u0.list_pdisks.name_array parameter. |
u0.list_pdisks.name_count |
On return from the ioctl, this indicates the number of names in the
name array pointed at by u0.list_pdisks.name_array. |
u0.list_pdisks.resource_count |
On return from the ioctl this indicates the number of physical disk
drives which make up the logical disk drive. This may be less than u0.list_pdisks.name_count if not enough elements were allocated in the
name array in the user's memory to hold all the pdisk names, or one or more
of the physical disks which make up the logical disk have not been configured
as operating system physical disk drives. |
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:
Value |
Description |
EIO |
Indicates an unrecoverable I/O error. |
ENOMEM |
Indicates that the device driver was unable to allocate or pin enough
memory to complete the operation. |
Files
/dev/pdisk0, /dev/pdisk1,..., /dev/pdiskn |
Provide an interface to allow SSA device drivers to access SSA physical
disks. |
/dev/hdisk0, /dev/hdisk1,...,
/dev/hdiskn |
Provide an interface to allow SSA device drivers to access SSA logical
disks. |
Related Information
The SSA Adapter Device Driver, ssadisk SSA Disk
Device Driver, SSA Subsystem Overview.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]