listDevices

Obtains a detailed list of all devices on the server.

Request

<listDevices/>

Reply

<listDevices>
   <deviceInfo>
      <deviceName/>
      <deviceID/>
      <deviceType/>
      <unitSize/>
      <sectors/>
      <capacity/>
      <alignment/>
      <deviceShared/>
      <removable/>
      <deviceRAID>
         <raidType/>
         <elementSize/>
         <stripeSize/>
         <restripeFlag/>
      </deviceRAID>
      <result value=" ">
         <descriptionn>
      </result>
   </deviceInfo>
   <result value=" ">
      <description/>
   </result>
</listDevices>

Elements

deviceInfo: Repeats for each device being listed. Specifies information for each device.
deviceName: Specifies the name of the device as assigned by Media Manager and by the disk driver.
deviceID: Specifies the ID of the device as assigned by Media Manager.
deviceType: Specifies the type of the device (see Section 11.1, Device Types).
unitSize: Specifies the size (in bytes) of the sector.
sectors: Specifies the number of sectors on a track. Because NetWare 6 partitions do not need to be aligned on cylinder boundaries, this number is not very useful.
capacity: Specifies the capacity (in sectors) of the drive.
alignment: Specifies the number of sectors on a cylinder. Because NetWare 6 partitions do not need to be aligned on cylinder boundaries, this number is not very useful.
deviceShared: Specifies that the device is flagged as a shared device.
removable: Specifies that the device is removable.
deviceRAID: Specifies the device is a software RAID device and contains information about the RAID configuration.
raidType: Specifies the type of the RAID device, such as RAID 0.
elementSize: Specifies the size (in bytes) of the segments in the device. Each segment is a partition of type Virtual Device Partition Type. All segments must be identical in size.
stripeSize: Specifies the stripe size of the device
restripeFlag: Specifies the restripe status of the device. A nonzero value indicates that the device is in the process of restriping.
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.

Example

A nssRequest packet to list the devices is as follows:

<nssRequest>
   <device>
      <listDevices>
   </device>
</nssRequest>

The following nssReply response shows two devices. The first device is a physical device while the second is a software RAID device.

<nssReply>
   <device>
      <deviceInfo>
         <deviceName>
             [V312-A0-D0:0] WDIGTL WDE4360-1807A3 rev:1.80
         </deviceName>
         <deviceID>1</deviceID>
         <deviceType>0</deviceType>
         <unitSize>512</unitSize>
         <sectors>63</sectors>
         <capacity>8385930</capacity>
         <alignment>16065</alignment>
         <result value="0">
            <description/>success</description>
         </result>
      </deviceInfo>

      <deviceInfo>
         <deviceName>
             [V043-A99-D0:0] RAID 0 Device 0
         </deviceName>
         <deviceID>16</deviceID>
         <deviceType>0</deviceType>
         <unitSize>512</unitSize>
         <sectors>32</sectors>
         <capacity>204800</capacity>
         <alignment>32</alignment>
         <deviceRAID>
            <raidType>0</raidType>
            <elementSize>104857600</elementSize>
            <stripeSize>65536</stripeSize>
            <restripeFlag>0</restripeFlag>
         </deviceRAID>
         <result value="0">
            <description/>success</description>
         </result>
      </deviceInfo>

      <result value="0">
         <description/>success</description>
      </result>
   </device>

   <result value="0">
      <description/>zOK</description>
   </result>
</nssReply>