io_redirect_dsf(1M)io_redirect_dsf(1M)NAMEio_redirect_dsf - redirect the persistent device special files from one
device to a different device within the same class
SYNOPSIS
old_hw_path new_hw_path
old_dsf new_dsf
DESCRIPTION
The command reassigns persistent device special files (DSF) from the
current device (associated with old_hw_path or old_dsf) to a new device
(associated with new_hw_path or new_dsf), with both devices required to
belong to the same class (see intro(7)). This command is typically
intended for replacing a bad device by retaining the device special
files associated with it (a bad device is specified with either
old_hw_path or old_dsf).
In the first form, the command accepts as input the LUN hardware paths
of the current device and of the new device (see intro(7)). In the
second form, the command accepts as input the persistent DSFs of the
current device and of the new device.
Both devices must have persistent DSFs configured prior to executing
the command. Persistent DSFs may be configured using either or (see
insf(1M) or mksf(1M)).
The user should ensure that the new device is accessible before running
the command (for example, by checking that reports the new device state
as and its health state as The redirection can happen only if the num‐
ber of persistent DSFs of the current device and new device are equal.
There is an exception in the case of stale nodes. The stale nodes are
the nodes which have an entry in the system I/O configuration files but
the corresponding device is not found (see ioconfig(4)) and
ioscan(1M)).
Warnings
· Both devices will be inaccessible while the redirection is
taking place.
· After successful completion of the operation, the DSFs of the
new device will be deleted since the new device will now use
the DSFs formerly mapped to the current device.
Options
recognizes the following options:
Specify the hardware path of the current device.
returns an error if old_hw_path is not a LUN
hardware path.
Specify the hardware path of the new device.
returns an error if new_hw_path is not a LUN
hardware path.
Specify the device special file of the current device.
returns an error if old_dsf is not a persistent
DSF.
Specify the device special file of the new device.
returns an error if new_dsf is not a persistent
DSF.
RETURN VALUE
Exit values are:
Successful completion.
An error condition occurred.
EXAMPLES
Redirect the DSF with the hardware path at to point to the hardware
path at Both disks belong to the class.
Redirect the DSF to point to the device with DSF Both DSFs represent
devices that belong to the class .
WARNINGS
You must be superuser to execute the command.
SEE ALSOinsf(1M), mksf(1M), ioscan(1M), intro(7).
io_redirect_dsf(1M)