USB_REGISTER_HOTPLUG_CBS(9F) Kernel Functions for Drivers

NAME


usb_register_hotplug_cbs, usb_unregister_hotplug_cbs -
Register/unregister for notification of device hotplug events

SYNOPSIS


#include <sys/usb/usba.h>


int usb_register_hotplug_cbs(dev_info_t *dip,
int (*disconnection_event_handler)(dev_info_t *dip,
int (*reconnection_event_handler)(dev_info_t *dip);


void usb_unregister_hotplug_cbs(dev_info_t *dip);


INTERFACE LEVEL


illumos DDI specific (illumos DDI)

PARAMETERS


For usb_register_hotplug_cbs()

dip

Pointer to the device's dev_info structure.


disconnection_event_handler

Called when device is disconnected. This handler takes a dev_info_t
as an argument (representing the device being disconnected) and
always returns USB_SUCCESS.


reconnection_event_handler

Called when device is reconnected. This handler takes a dev_info_t as
an argument (representing the device being reconnected) and always
returns USB_SUCCESS.


For usb_unregister_hotplug_cbs():

dip
Pointer to the device's dev_info structure.


DESCRIPTION


The usb_register_hotplug_cbs() function registers callbacks to be
executed when the USB device represented by dip is hotplugged or removed.


The usb_unregister_hotplug_cbs() function unregisters or disengages
callbacks from executing when the USB device represented by dip is
hotplugged or removed.

RETURN VALUES


For usb_register_hotplug_cbs():

USB_SUCCESS
Callbacks were successfully registered.


USB_FAILURE
One or more arguments were NULL.

Callbacks could not be successfully registered.


For usb_unregister_hotplug_cbs(): None

CONTEXT


The usb_register_hotplug_cbs() function may be called only from
attach(9E).


The usb_unregister_hotplug_cbs() function may be called only from
detach(9E).


Registered callback handlers requiring the use of any DDI (section 9F)
function (except ddi_taskq_* functions), should launch a separate thread
using ddi_taskq_* routines for processing their event, to avoid
deadlocks. The new thread can then safely call any DDI function it needs
to handle the event.


The registered callback handlers execute in kernel context.

EXAMPLES



int remove_device(dev_info_t *)
{
...
...
return (USB_SUCCESS);
}

int accommodate_device(dev_info_t *)
{
...
...
return (USB_SUCCESS);
}

if (usb_register_hotplug_cbs(
dip, remove_device, accommodate_device) == USB_FAILURE) {
cmn_err (CE_WARN,
"%s%d: Could not register hotplug handlers.",
ddi_driver_name(dip), ddi_get_instance(dip));
}


ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


+--------------------+-------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------+
|Architecture | PCI-based systems |
+--------------------+-------------------+
|Interface stability | Committed |
+--------------------+-------------------+

SEE ALSO


attributes(7), attach(9E), detach(9E), usb_get_status(9F)

illumos August 17, 2004 USB_REGISTER_HOTPLUG_CBS(9F)