HP-UX Reference (11i v3 07/02) - 1M System Administration Commands A-M (vol 3)

i
iobind(1M) iobind(1M)
NAME
iobind - bind a driver to a device
SYNOPSIS
/usr/sbin/iobind -H
hw_path -M driver_name [-I instance][
-f]
DESCRIPTION
The
iobind command may be used to perform online unbinding of a device LUN hardware path from its
current driver and binding a new driver to it. As part of the binding operation, the specified driver will be
bound to the LUN hardware path and also to its corresponding legacy hardware paths.
The hardware path specified as the argument to the
-H option must be of the form 64000/0x/0x. The driver
name specified with the
-M
option will be bound to the LUN and legacy hardware paths. The optional -I
option specifies an instance number to be assigned to the device associated with the hardware path. If this
option is not used, the device will be assigned a new instance number in the new driver’s class. The
optional
-f forces the binding to occur at the next reboot if it cannot be done online.
The device must not be in use while the unbind operation is performed. The driver must support online
unbinding and binding. If either of these requirements is false and the -f option is not given, the user will
be asked if the binding can take effect at the next reboot. The user is given the option to proceed or not.
If a driver supports online unbinding and binding, then after iobind completes, a device will have one of
the following software states as shown by the ioscan command:
CLAIMED The specified driver was successfully bound to the hardware path.
DIFF_HW The specified driver cannot be used to claim the hardware at the specified hardware path.
ERROR The device at the address is responding, but it is in an error state.
NO_HW The device at the specified hardware path is no longer responding.
SCAN The specified hardware path is locked. Try again later.
UNCLAIMED
The driver failed.
Options
iobind recognizes the following options:
-f Force the binding even though a driver does not support online unbinding and binding or
the device is in use. In this case, the binding will take effect at the next reboot.
-H hw_path
The LUN hardware path of a device must be of the form 64000/0x/0x.
-I instance
The instance number to be assigned to the device.
-M driver_name
The name of the driver that the LUN and legacy hardware paths are to be bound to.
RETURN VALUE
Exit values are:
0 Successful completion.
>0 An error condition occurred.
EXAMPLES
Unbind the driver bound to the device at hardware path 64000/0xfa00/0xa and bind the device to
esdisk. Use the default instance number of the driver’s class.
iobind -H 64000/0xfa00/0xa -M esdisk
Unbind the driver bound to the device at hardware path 64000/0xfa00/0xb and bind the device to
esdisk. Assign it the instance number 50.
iobind -H 64000/0xfa00/0xb -M esdisk -I 50
Do a forced binding. If the driver does not support online binding or the device is busy, the binding will be
deferred till next reboot.
364 Hewlett-Packard Company − 1 − HP-UX 11i Version 3: February 2007