[PATCH] USB: rndis_host whitespace/comment updates
This adds a "avoid proprietary protocols" warnoff, identifying several of the known deficiencies in Microsoft's excuse-for-specification, and fixes some whitespace bugs. Signed-off-by: David Brownell <dbrownell@users.sourceforge.net> Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
This commit is contained in:
committed by
Greg Kroah-Hartman
parent
68dcc688d1
commit
51400f1d6e
@@ -39,6 +39,20 @@
|
|||||||
* RNDIS is NDIS remoted over USB. It's a MSFT variant of CDC ACM ... of
|
* RNDIS is NDIS remoted over USB. It's a MSFT variant of CDC ACM ... of
|
||||||
* course ACM was intended for modems, not Ethernet links! USB's standard
|
* course ACM was intended for modems, not Ethernet links! USB's standard
|
||||||
* for Ethernet links is "CDC Ethernet", which is significantly simpler.
|
* for Ethernet links is "CDC Ethernet", which is significantly simpler.
|
||||||
|
*
|
||||||
|
* NOTE that Microsoft's "RNDIS 1.0" specification is incomplete. Issues
|
||||||
|
* include:
|
||||||
|
* - Power management in particular relies on information that's scattered
|
||||||
|
* through other documentation, and which is incomplete or incorrect even
|
||||||
|
* there.
|
||||||
|
* - There are various undocumented protocol requirements, such as the
|
||||||
|
* need to send unused garbage in control-OUT messages.
|
||||||
|
* - In some cases, MS-Windows will emit undocumented requests; this
|
||||||
|
* matters more to peripheral implementations than host ones.
|
||||||
|
*
|
||||||
|
* For these reasons and others, ** USE OF RNDIS IS STRONGLY DISCOURAGED ** in
|
||||||
|
* favor of such non-proprietary alternatives as CDC Ethernet or the newer (and
|
||||||
|
* currently rare) "Ethernet Emulation Model" (EEM).
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/*
|
/*
|
||||||
|
Reference in New Issue
Block a user