summaryrefslogtreecommitdiff
path: root/include/linux
diff options
context:
space:
mode:
authorOliver Neukum <oliver@neukum.org>2008-04-10 15:15:37 +0200
committerGreg Kroah-Hartman <gregkh@suse.de>2008-04-24 21:16:50 -0700
commit7ef4f0600df3dc2beff838b3f03652677ed28311 (patch)
treee7c1d49a8eb9ab42809aecfc2d8c65cb721910d1 /include/linux
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/linux')
-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 {
* and should normally be the same as the module name.
* @probe: Called to see if the driver is willing to manage a particular
* interface on a device. If it is, probe returns zero and uses
- * dev_set_drvdata() to associate driver-specific data with the
+ * usb_set_intfdata() to associate driver-specific data with the
* interface. It may also use usb_set_interface() to specify the
* appropriate altsetting. If unwilling to manage the interface,
- * return a negative errno value.
+ * return -ENODEV, if genuine IO errors occured, an appropriate
+ * negative errno value.
* @disconnect: Called when the interface is no longer accessible, usually
* because its device has been (or is being) disconnected or the
* driver module is being unloaded.
@@ -956,10 +957,7 @@ struct usbdrv_wrap {
* @pre_reset: Called by usb_reset_composite_device() when the device
* is about to be reset.
* @post_reset: Called by usb_reset_composite_device() after the device
- * has been reset, or in lieu of @resume following a reset-resume
- * (i.e., the device is reset instead of being resumed, as might
- * happen if power was lost). The second argument tells which is
- * the reason.
+ * has been reset
* @id_table: USB drivers use ID table to support hotplugging.
* Export this with MODULE_DEVICE_TABLE(usb,...). This must be set
* or your driver's probe function will never get called.