ethtool: Note common alternate exit condition for interrupt coalescing
authorBen Hutchings <bhutchings@solarflare.com>
Mon, 15 Aug 2011 14:09:22 +0000 (14:09 +0000)
committerDavid S. Miller <davem@davemloft.net>
Tue, 16 Aug 2011 23:36:15 +0000 (16:36 -0700)
Many implementations ignore the value of max_frames and do not
treat usecs == 0 as special.  Document this as deprecated.

Signed-off-by: Ben Hutchings <bhutchings@solarflare.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
include/linux/ethtool.h

index 42378b34ae8f6f0fa9525e89a7873848f1184bdf..3829712ccc054e129b9bc389b029367c28a17475 100644 (file)
@@ -173,6 +173,12 @@ struct ethtool_eeprom {
  * would cause interrupts to never be generated.  To disable
  * coalescing, set usecs = 0 and max_frames = 1.
  *
+ * Some implementations ignore the value of max_frames and use the
+ * condition:
+ *     time_since_first_completion >= usecs
+ * This is deprecated.  Drivers for hardware that does not support
+ * counting completions should validate that max_frames == !rx_usecs.
+ *
  * Adaptive RX/TX coalescing is an algorithm implemented by some
  * drivers to improve latency under low packet rates and improve
  * throughput under high packet rates.  Some drivers only implement