NAME
io_redirect_dsf — redirect the persistent device special file from one device to a different device
SYNOPSIS
/usr/sbin/io_redirect_dsf
-H
old_hw_path
-N
new_hw_path
/usr/sbin/io_redirect_dsf
-d
old_dsf
-n
new_dsf
DESCRIPTION
The
io_redirect_dsf
command reassigns a persistent device special file (DSF)
to a new device when both devices belong to the same class.
If the new device does not already exist, before reassigning it
you must create the DSF by running either
insf
or
mskf
(see
insf(1M)
and
mksf(1M)).
In the first form, the command accepts as input the lun hardware paths
of the device to be replaced and the new device.
In the second form, the command accepts as input the persistent DSFs
of the device to be replaced and the new device.
Note:
The device is inaccessible while the redirection is taking place.
Options
io_redirect_dsf
recognizes the following options:
- -H old_hw_path
Specify the hardware path of the device that is being replaced.
io_redirect_dsf
returns an error if
old_hw_path
is not a lun hardware path.
- -N new_hw_path
Specify the hardware path of the new device.
io_redirect_dsf
returns an error if
new_hw_path
is not a lun hardware path.
- -d old_dsf
Specify the device special file of the device that is being replaced.
io_redirect_dsf
returns an error if
old_dsf
is not a persistent DSF.
- -n new_dsf
Specify the device special file of the new device.
io_redirect_dsf
returns an error if
new_dsf
is not a persistent DSF.
RETURN VALUE
Exit values are:
- 0
Successful completion.
- >0
An error condition occurred.
EXAMPLES
Redirect the DSF
/dev/disk/disk15
with the hardware path at
64000/0xfa00/0x2
to point to the hardware path at
64000/0xfa00/0x3.
Both disks belong to the
disk
class.
io_redirect_dsf -H 64000/0xfa00/0x2 -N 64000/0xfa00/0x3
Redirect the DSF
/dev/disk/disk23
to point to the device with DSF
/dev/disk/dsk26.
Both DSFs represent devices that belong to the class
disk.
io_redirect_dsf -d /dev/disk/disk23 -n /dev/disk/disk26
WARNINGS
You must be superuser to execute the
io_redirect_dsf
command.
Printable version
