Greg:
This patch corrects some misconceptions that have persisted in the USB
error-code documentation for quite some time.
Alan Stern
Signed-off-by: Alan Stern <[EMAIL PROTECTED]>
===== Documentation/usb/error-codes.txt 1.13 vs edited =====
--- 1.13/Documentation/usb/error-codes.txt 2004-11-01 13:59:16 -05:00
+++ edited/Documentation/usb/error-codes.txt 2005-01-12 17:10:28 -05:00
@@ -83,7 +83,18 @@
prescribed bus turn-around time
c) unknown USB error
--EILSEQ (*, **) CRC mismatch
+-EILSEQ (*, **) a) CRC mismatch
+ b) no response packet received within the
+ prescribed bus turn-around time
+ c) unknown USB error
+
+ In cases b) and c) either -EPROTO or -EILSEQ
+ may be returned. Note that often the controller
+ hardware does not distinguish among cases a),
+ b), and c), so a driver cannot tell whether
+ there was a protocol error, a failure to respond
+ (often caused by device disconnect), or some
+ other fault.
-EPIPE (**) Endpoint stalled. For non-control endpoints,
reset this status with usb_clear_halt().
@@ -104,8 +115,6 @@
specified buffer, and URB_SHORT_NOT_OK was set in
urb->transfer_flags.
--ETIMEDOUT (**) transfer timed out, NAK
-
-ENODEV Device was removed. Often preceded by a burst
of
other errors, since the hub driver does't detect
device removal events immediately.
@@ -143,4 +152,4 @@
usb_get_*/usb_set_*():
usb_control_msg():
usb_bulk_msg():
- All USB errors (submit/status) can occur
+-ETIMEDOUT timeout expired before the transfer completed
-------------------------------------------------------
The SF.Net email is sponsored by: Beat the post-holiday blues
Get a FREE limited edition SourceForge.net t-shirt from ThinkGeek.
It's fun and FREE -- well, almost....http://www.thinkgeek.com/sfshirt
_______________________________________________
linux-usb-devel@lists.sourceforge.net
To unsubscribe, use the last form field at:
https://lists.sourceforge.net/lists/listinfo/linux-usb-devel
