rmdev command

Purpose

Removes a device from the system.

Syntax

rmdev { -dev | -pdev } Name [ -recursive ] [ [ -ucfg ]

Description

The rmdev command unconfigures and undefines the device specified with the device logical name. If you specify the -recursive flag, the rmdev command acts on any children of the device as well. By specifying the -ucfg flag the device will be unconfigured but not undefined.

Use the -pdev flag along with the parent device's logical name to delete all of the children devices. The children are deleted in the same recursive fashion as described above for the -recursive flag. The only difference is that the specified device itself is not deleted. Thus, the -recursive flag is redundant and need not be specified with the -pdev flag.

Attention: To protect the Configuration database, the rmdev command cannot be interrupted. Stopping this command before execution is complete could result in a corrupted database.

Note: The device specified or the children of the device specified cannot be a physical or logical volume that is assigned to a shared memory pool (to be used as a paging space device by a shared memory partition).

Flags

-dev Name	Specifies the logical device, indicated by the Name parameter. This flag may not be used with the -pdev flag.
-pdev Name	Specifies the parent logical device (indicated by the Name parameter whose children need to be removed. This flag may not be used with the -dev flag.
-recursive	Unconfigures the device and its children.
-ucfg	Unconfigures, but does not undefine, the specified device. The device's state will be moved from `Available` to `Defined`. To move the device back to `Available` state run `cfgdev -dev Name`

Exit Status

See Exit status for Virtual I/O Server commands.

Examples

To unconfigure the cd0 CD-ROM device, type:
```
rmdev  -dev cd0
```
To unconfigure the SCSI adapter scsi1 and all of its children, type:
```
 rmdev  -recursive -dev scsi1
```
To unconfigure just the children of the SCSI adapter scsi1, but not the adapter itself, type:
```
rmdev  -pdev scsi1
```
To unconfigure the children of PCI bus pci1 and all other devices under them, type:
```
rmdev  -pdev pci1
```

Related Information

The cfgdev command, the chdev command, the lsdev command, the mkvdev command, and the rmdev command.