Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 51400f1d authored by David Brownell's avatar David Brownell Committed by Greg Kroah-Hartman
Browse files

[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: default avatarDavid Brownell <dbrownell@users.sourceforge.net>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@suse.de>
parent 68dcc688

drivers/usb/net/rndis_host.c

+21 −7
Original line number Diff line number Diff line
@@ -39,6 +39,20 @@ 
 * 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

 * 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).

 */



/*