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 is not interruptible. Stopping this command before execution
is complete could result in a corrupted database.
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 Virtual I/O Server command exit status.
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.