initializeDevice

Re-initializes a device. Use this command with extreme caution because it destroys all data on the device. It also destroys all NSS storage pools and volumes that occupy any portion of the device that is being initialized. If a pool spans multiple partitions, including one on the device that is being initialized, the entire pool is destroyed. Note that when NSS storage pools and volumes are deleted by initializeDevice, their corresponding eDirectory objects are not deleted from the directory. For cleanup, it is best to first delete all pool and volumes that occupy a device before initializing the device itself.

Request

<initializeDevice>
   <deviceID/>
   <deviceInitFlag/>
</initializeDevice>

Reply

<initializeDevice> 
   <result value=" ">
      <description/>
   </result>
</initializeDevice>

Elements

deviceID

On NetWare, specifies the device ID assigned by Media Manager. On Linux, specifies the device object name.

(Optional) deviceInitFlag

Initializes the device.

If the value is set to TRUE the devices are forcefully initialized and if the value is set to FALSE, the device that contains a system volume (such as /boot, swap, and /(root)) is not initialized.

result

Specifies an error value or 0 (for no error).

description

Specifies a text description of the result.

Example

A nssRequest packet to initialize a device is as follows:

<nssRequest>
   <device>
      <initializeDevice>
         <deviceID>3</deviceID>
         <deviceInitFlag>deviceInitFlag</deviceInitFlag>
      </initializeDevice>
   </device>
</nssRequest>

A nssReply packet to the initialize device command follows:

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

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