usb_handle_remote_wakeup(9F)				   Kernel Functions for Drivers 			      usb_handle_remote_wakeup(9F)

NAME

       usb_handle_remote_wakeup - Enable or disable remote wakeup on USB devices

SYNOPSIS

       #include <sys/usb/usba.h>

       int usb_handle_remote_wakeup(dev_info_t *dip, int cmd);

INTERFACE LEVEL

       Solaris DDI specific (Solaris DDI)

PARAMETERS

       dip    Pointer to the device's dev_info structure.

       cmd    Command. Either USB_REMOTE_WAKEUP_ENABLE or USB_REMOTE_WAKEUP_DISABLE.

DESCRIPTION

       The usb_handle_remote_wakeup() function enables or disables remote wakeup on a USB device. This call can block.

RETURN VALUES

       USB_SUCCESS    Remote wakeup is successfully enabled or disabled.

       USB_FAILURE    Remote wakeup is not supported by the device. An internal error occurred.

CONTEXT

       May be called from user or kernel context.

EXAMPLES

	     uint_t *pwrstates;

	     /* Hook into device's power management.  Enable remote wakeup. */
	     if (usb_create_pm_components(dip, pwrstates) == USB_SUCCESS) {
		     usb_handle_remote_wakeup(dip, USB_REMOTE_WAKEUP_ENABLE);
	     }

ATTRIBUTES

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

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

SEE ALSO

       attributes(5),	pm_busy_component(9F),	 pm_idle_component(9F),   pm_lower_power(9F),  pm_raise_power(9F),  usb_clr_feature(9F),  usb_cre-
       ate_pm_components(9F), usb_get_cfg(9F), usb_get_dev_data(9F), usb_register_hotplug_cbs(9F), usb_cfg_descr(9S)

SunOS 5.11							    5 Feb 2004					      usb_handle_remote_wakeup(9F)