Manual Pages for UNIX Operating System command usage for man usb_unregister_hotplug_cbs

Kernel Functions for Drivers         usb_register_hotplug_cbs(9F)



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

SYNOPSIS
     #include 

     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
     Solaris DDI specific (Solaris 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.




SunOS 5.11          Last change: 17 Aug 2004                    1






Kernel Functions for Drivers         usb_register_hotplug_cbs(9F)



     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 pro-
     cessing  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);



SunOS 5.11          Last change: 17 Aug 2004                    2






Kernel Functions for Drivers         usb_register_hotplug_cbs(9F)



           }

           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(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Architecture                | PCI-based systems           |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | Availability                | driver/usb                  |
    |_____________________________|_____________________________|


SEE ALSO
     attributes(5), attach(9E), detach(9E), usb_get_status(9F)

























SunOS 5.11          Last change: 17 Aug 2004                    3