getDeviceInfo3 (Linux)

Returns information about the object ID, which can be a physical device or a RAID device (RAID 0, RAID 1, and RAID 5).

Request

<getDeviceInfo3 value =" "/>
   <objectID/> 
</getDeviceInfo3>

NOTE:The current implementation of this command is capable of returning the details for only 32 devices at a time. If you specify more than 32 devices in the "LIST" option or use "ALL" when there are more than 32 devices, the command returns an error.

Reply

<getDeviceInfo3>  
   <deviceInfo>
      <name/>        
      <objectID/>    
      <type/>       
      <size/>        
      <freeSize/>  
      <majorVersion/>
      <minorVersion/> 
      <partitions>
         <partition>
            <partitionID/>
            <partitionType/>
            <mountPoint/>
            <hasSYS/>
            <bootable/>
         </partition>
        </partitions>
      <multiPath/>
      <shared/>
      <deviceRAID>
         <raidType/>
         <elementSize/>
         <elementCount/>
         <stripeSize/>
         <restripeFlag/>
         <restripeEnabled/>
         <segmentInfo>
            <numSegments/>
            <segment>
               <mirrorPercent/>
               <deviceName/>
               <segmentName/>
               <deviceID/>
               <segmentID/>
            </segment>
         </segmentInfo>
      </deviceRAID>
      <mirrored/>
      <deviceMirror>
         <mirrorGroupStatus/>
         <mirrorGroupPercent/>
         <numMirrors/>
         <remirrorEnabled/>
         <mirrorInfo>
            <segment>
               <mirrorPercent/>
               <deviceName/>
               <segmentName/>
               <deviceID/>
               <segmentID/>
            </segment>
         </mirrorInfo>
      </deviceMirror>
      <result value=” “>
         <description/>
      </result>
   </deviceInfo>
</getDeviceInfo3>

Elements

objectID

Specifies the device object name.

device info

Specifies the information of the device.

name

Specifies the name of the device assigned by Media Manager.

type

(Optional) Specifies the RAID type of the device assigned by Media Manager.

size

Specifies the total size of the object in bytes.

freeSize

Specifies the object's available size in bytes.

majorVersion

Specifies the major number of the device.

minorVersion

Specifies the minor number of the device.

partition

Repeats for each partition on the device.

partitionID

Specifies the partition object name.

partitionType

(Required) Specifies the following type of the partition:

  • 0x00 freespace
  • 0x82 Linux Swap
  • 0x83 general Linux
mountPoint

Specifies the partition's mount point.

hasSYS

(Optional) Specifies that the partition contains the SYS pool.

bootable

Specifies that the partition contains the boot partition.

multiPath

(Optional) Specifies that the device has multipath.

shared

(Optional) Specifies that the device is shared.

raidType

Specifies the RAID type: 0, 1, or 5.

elementSize

Specifies the size in bytes.

elementCount

(Required) If deviceRAID is used, specifies the number of segments that are present. If raidType is 5 and elementCount equals the numSegments, one segment can be deleted.

stripeSize

Specifies the size in bytes.

restripeEnabled

Specifies if the restripe is enabled.

numSegments

Specifies the number of segments in the RAID. If raidType is 1 (mirroring) and numSegments is greater than one, segments can be deleted (down to one remaining segment).

segment

Repeats for each segment (partition) that makes up the RAID device.

deviceID

Specifies the segment's (or mirror segment's) device name. If there's a missing segment in a mirror device, no information is returned for deviceName and deviceID.

deviceRAID

(Optional) If exists, specifies the device is a RAID device.

mirrored

(Optional) For RAID 1 devices only.

deviceMirror

(Optional) For RAID 1 devices only. If there's a missing segment in a mirror device, the missing segment name is returned as missing_raid1_1.

remirrorEnabled

Specifies if re-mirroring is enabled.

mirrorActive

Specifies if the mirror segment is active:

  • 1 in synchronization
  • 0 not in synchronization
mirrorStatus

Specifies the status of the mirror segment:

  • 1 in synchronization
  • 0 not in synchronization
result

Specifies the result value only if the data for the device is not retrieved. It also shows the complete error information along with the result value.

Specifies the information of all the queried object IDs in the sequential order.

Attribute

value

Specify “ALL” or “LIST” based on your requirement. If you give “ALL”, you get the information of all the object IDs, maximum up to 32 object IDs only at a time. If you give “LIST”, you get the information of the specified object IDs. You can select maximum up to 32 object IDs at a time.

Example

An example for the LIST option is as follows:

Request

<nssRequest>
   <device>
      <getDeviceInfo3 value="LIST">
         <objectID>sdb</objectID>
         <objectID>sdc</objectID>
      </getDeviceInfo3>
   </device>
</nssRequest>

Reply

<nssReply>
   <device>
      <getDeviceInfo3>
        <deviceInfo>
              <name>sdb</name>
              <objectID>sdb</objectID>
              <majorVersion>8</majorVersion>
              <minorVersion>16</minorVersion>
              <type>0</type>
              <size>5368709120</size>
              <freeSize>4850696192</freeSize>
           <partitions>
              <partition>
                 <partitionID>sdb1.1</partitionID>
                 <partitionType>105</partitionType>
                 <mountPoint>/opt/novell/nss/mnt/.pools/AC</mountPoint>
              </partition>
              <partition>
                 <partitionID>sdb1.2</partitionID>
                 <partitionType>105</partitionType>
                 <mountPoint>/opt/novell/nss/mnt/.pools/AB</mountPoint>
              </partition>
           </partitions>
         </deviceInfo>
         <deviceInfo>
              <name>sdc</name>
              <objectID>sdc</objectID>
              <majorVersion>8</majorVersion>
              <minorVersion>32</minorVersion>
              <type>0</type>
              <size>1073741824</size>
              <freeSize>1073725440</freeSize>
           <partitions>
              <partition>
                 <partitionID>sdc_freespace1</partitionID>
                 <partitionType>0</partitionType> 
              </partition>
           </partitions>
         </deviceInfo>
       </getDeviceInfo3>
     </device>
   <result value="0"><description>zOK</description></result>
</nssReply>