Subject: kern/35795: bge(4) doesn't describe the sysctl it uses
To: None <kern-bug-people@netbsd.org, gnats-admin@netbsd.org,>
From: Greg A. Woods <woods@planix.com>
List: netbsd-bugs
Date: 02/22/2007 22:30:00
>Number:         35795
>Category:       kern
>Synopsis:       bge(4) doesn't describe the sysctl it uses
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Feb 22 22:30:00 +0000 2007
>Originator:     Greg A. Woods
>Release:        netbsd-4
>Organization:
Planix, Inc.; Toronto, Ontario; Canada
>Environment:
System: NetBSD-4.0_STABLE2
>Description:

	it seems bge(4) does not describe the sysctl it uses

>How-To-Repeat:

>Fix:

The description is taken from a posting by Jonathan Stone.

Index: share/man/man4/bge.4
===================================================================
RCS file: /cvs/master/m-NetBSD/main/src/share/man/man4/bge.4,v
retrieving revision 1.8
diff -u -r1.8 bge.4
--- share/man/man4/bge.4	23 Jun 2005 12:47:38 -0000	1.8
+++ share/man/man4/bge.4	22 Feb 2007 22:19:46 -0000
@@ -75,6 +75,17 @@
 See
 .Xr ifconfig 8
 for information on how to enable this feature.
+.Pp
+The level of interrupt mitigation for received packets can be mitigated
+with the following
+.Xr sysctl 8
+control:
+.Li hw.bge.rx_lvl .
+A value of 1 yields an bge interrrupt for every two full-sized Ethernet
+frames.
+Each increment of the value will, roughly, halve receive interrupt rate,
+up to a maximum of 5, which interrupts about every 30 to 40 full-sized
+TCP segments.
 .Sh SEE ALSO
 .Xr arp 4 ,
 .Xr bce 4 ,