linux/drivers/usb/misc
Marcin Slusarz 6def755320 usbtest: comment on why this code "expects" negative and positive errnos
On Mon, May 12, 2008 at 01:02:22AM -0700, David Brownell wrote:
> On Sunday 11 May 2008, Marcin Slusarz wrote:
> > 
> > test_ctrl_queue expects (?) positive and negative errnos.
> > what is going on here?
> 
> The sign is just a way to flag something:
> 
>                 /* some faults are allowed, not required */
> 
> The negative ones are required.  Positive codes are optional,
> in the sense that, depending on how the peripheral happens
> to be implemented, they won't necessarily be triggered.
> 
> For example, the test to fetch a device qualifier desriptor
> must succeed if the device is running at high speed.  So that
> test is marked as negative.  But when it's full speed, it
> could legitimately fail; marked as positive.  And so on for
> other tests.
> 
> Look at how the codes are *interpreted* to see it work.

Lets document it.

Based on comment from David Brownell <david-b@pacbell.net>.

Signed-off-by: Marcin Slusarz <marcin.slusarz@gmail.com>
Cc: David Brownell <david-b@pacbell.net>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
2008-05-14 10:00:29 -07:00
..
sisusbvga USB: Spelling fixes 2008-02-01 14:34:57 -08:00
adutux.c USB: replace remaining __FUNCTION__ occurrences 2008-04-24 21:16:55 -07:00
appledisplay.c USB: replace remaining __FUNCTION__ occurrences 2008-04-24 21:16:55 -07:00
auerswald.c USB: remove unnecessary type casting of urb->context 2008-04-24 21:16:55 -07:00
berry_charge.c
cypress_cy7c63.c USB: cypress_cy7c63: updated contact/usage information 2008-02-01 14:34:50 -08:00
cytherm.c
emi26.c USB: replace remaining __FUNCTION__ occurrences 2008-04-24 21:16:55 -07:00
emi26_fw.h
emi62.c USB: replace remaining __FUNCTION__ occurrences 2008-04-24 21:16:55 -07:00
emi62_fw_m.h
emi62_fw_s.h
ftdi-elan.c USB: remove unnecessary type casting of urb->context 2008-04-24 21:16:55 -07:00
idmouse.c
iowarrior.c USB: remove unnecessary type casting of urb->context 2008-04-24 21:16:55 -07:00
Kconfig USB: Remove EXPERIMENTAL designation from USB misc/ Kconfig entries 2008-04-24 21:16:43 -07:00
ldusb.c USB: remove PICDEM FS USB demo (04d8:000c) device from ldusb 2008-05-14 10:00:29 -07:00
legousbtower.c USB: remove unnecessary type casting of urb->context 2008-04-24 21:16:55 -07:00
Makefile
phidget.c
phidget.h
phidgetkit.c USB: replace remaining __FUNCTION__ occurrences 2008-04-24 21:16:55 -07:00
phidgetmotorcontrol.c USB: replace remaining __FUNCTION__ occurrences 2008-04-24 21:16:55 -07:00
phidgetservo.c USB: replace remaining __FUNCTION__ occurrences 2008-04-24 21:16:55 -07:00
rio500.c
rio500_usb.h
trancevibrator.c USB: fix error handling in trancevibrator 2008-02-21 15:38:51 -08:00
usb_u132.h
usblcd.c USB: remove unnecessary type casting of urb->context 2008-04-24 21:16:55 -07:00
usbled.c USB: fix usbled disconnect read race #2 2007-11-28 13:58:33 -08:00
usbtest.c usbtest: comment on why this code "expects" negative and positive errnos 2008-05-14 10:00:29 -07:00
uss720.c