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.

iobind -H 64000/0xfa00/0xc -M esdisk -f

WARNINGS

The ioscan and iobind commands should not be run at the same time because both commands attempt to bind drivers. In particular, there may be a short window while iobind will leave a hardware path unbound. If ioscan runs during that window, it may bind a different driver to that hardware path. If this happens, iobind must be executed again to bind the desired driver.

iobind may be executed only by the superuser.

iobind(1M)

Technical documentation

» Table of Contents

» Index