iobind.1m (2010 09)

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
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1