aboutsummaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
authorOliver Neukum <oliver@neukum.org>2008-04-10 09:15:37 -0400
committerGreg Kroah-Hartman <gregkh@suse.de>2008-04-25 00:16:50 -0400
commit7ef4f0600df3dc2beff838b3f03652677ed28311 (patch)
treee7c1d49a8eb9ab42809aecfc2d8c65cb721910d1 /include
parent51c159e7a8310f7272154fdd096315ae86bd36c2 (diff)
USB: update comments about usb driver's header
Comments here are so outdated that they are plain wrong. We cannot expect people to write correct drivers if the headers have incorrect comments. Signed-off-by: Oliver Neukum <oneukum@suse.de> Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
Diffstat (limited to 'include')
-rw-r--r--include/linux/usb.h10
1 files changed, 4 insertions, 6 deletions
diff --git a/include/linux/usb.h b/include/linux/usb.h
index 52c449e4bdcd..4a91181629d9 100644
--- a/include/linux/usb.h
+++ b/include/linux/usb.h
@@ -938,10 +938,11 @@ struct usbdrv_wrap {
938 * and should normally be the same as the module name. 938 * and should normally be the same as the module name.
939 * @probe: Called to see if the driver is willing to manage a particular 939 * @probe: Called to see if the driver is willing to manage a particular
940 * interface on a device. If it is, probe returns zero and uses 940 * interface on a device. If it is, probe returns zero and uses
941 * dev_set_drvdata() to associate driver-specific data with the 941 * usb_set_intfdata() to associate driver-specific data with the
942 * interface. It may also use usb_set_interface() to specify the 942 * interface. It may also use usb_set_interface() to specify the
943 * appropriate altsetting. If unwilling to manage the interface, 943 * appropriate altsetting. If unwilling to manage the interface,
944 * return a negative errno value. 944 * return -ENODEV, if genuine IO errors occured, an appropriate
945 * negative errno value.
945 * @disconnect: Called when the interface is no longer accessible, usually 946 * @disconnect: Called when the interface is no longer accessible, usually
946 * because its device has been (or is being) disconnected or the 947 * because its device has been (or is being) disconnected or the
947 * driver module is being unloaded. 948 * driver module is being unloaded.
@@ -956,10 +957,7 @@ struct usbdrv_wrap {
956 * @pre_reset: Called by usb_reset_composite_device() when the device 957 * @pre_reset: Called by usb_reset_composite_device() when the device
957 * is about to be reset. 958 * is about to be reset.
958 * @post_reset: Called by usb_reset_composite_device() after the device 959 * @post_reset: Called by usb_reset_composite_device() after the device
959 * has been reset, or in lieu of @resume following a reset-resume 960 * has been reset
960 * (i.e., the device is reset instead of being resumed, as might
961 * happen if power was lost). The second argument tells which is
962 * the reason.
963 * @id_table: USB drivers use ID table to support hotplugging. 961 * @id_table: USB drivers use ID table to support hotplugging.
964 * Export this with MODULE_DEVICE_TABLE(usb,...). This must be set 962 * Export this with MODULE_DEVICE_TABLE(usb,...). This must be set
965 * or your driver's probe function will never get called. 963 * or your driver's probe function will never get called.