USB_REGISTER_HOTPLUG_CBS(9F) | Kernel Functions for Drivers | USB_REGISTER_HOTPLUG_CBS(9F) |
usb_register_hotplug_cbs, usb_unregister_hotplug_cbs - Register/unregister for notification of device hotplug events
#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);
illumos DDI specific (illumos DDI)
For usb_register_hotplug_cbs()
dip
disconnection_event_handler
reconnection_event_handler
For usb_unregister_hotplug_cbs():
dip
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.
For usb_register_hotplug_cbs():
USB_SUCCESS
USB_FAILURE
Callbacks could not be successfully registered.
For usb_unregister_hotplug_cbs(): None
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.
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));
}
See attributes(7) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
Architecture | PCI-based systems |
Interface stability | Committed |
August 17, 2004 | OmniOS |