rendev Command

Purpose

Renames a device.

Syntax

rendev -l Name  -n NewName [-u]

Description

The rendev command enables devices to be renamed. The device to be renamed, is specified with the -l flag, and the new wanted name is specified with the -n flag.

The new wanted name must not exceed 15 characters in length. Acceptable characters for the new name include alphanumeric characters and underscore (_). If the name is already used or is present in the /dev directory, the operation fails. If the name formed by appending the new name after the character r is already used as a device name, or appears in the /dev directory, the operation fails.

If the device is in the Available state, the rendev command must unconfigure the device before renaming it. This operation is similar to the operation performed by the rmdev –l Name command. If the unconfigure operation fails, the renaming also fails. If the unconfigure operation succeeds, the rendev command will configure the device, after renaming it, to restore it to the Available state. The –u flag might be used to prevent the device from being configured again after it is renamed.

Note: Disk drive devices that are members of the root volume group, or that becomes members of the root volume group (by using LVM or install procedures), must not be renamed. Renaming such disk drives might interfere with the ability to recover from certain scenarios, including boot failures.

Some devices might have special requirements on their names for other devices or applications to use them. Using the rendev command to rename such a device might result in the device being unusable.

Note: To protect the configuration database, the rendev command cannot be interrupted once it is started. Trying to stop this command before completion, might result in a corrupted database.

Flags

Item	Description
-l `Name`	Specifies the device, indicated by the `Name` parameter, to be renamed in the customized devices object.
-n `NewName`	Specifies the new name, indicated by the `NewName` parameter, to be assigned to the device.
-u	This flag is optional. It indicates that the device is not to be configured after it is renamed.

Examples

To rename disk hdisk5 to hdisk2, enter the following command:
```
rendev -l hdisk5 -n hdisk2
```
To rename disk hdisk3 to ootvg, enter the following command:
```
rendev -l hdisk3 -n ootvg
```

The second command fails because ootvg appended to r results in the name rootvg, which conflicts with the rootvg volume group name.