Bug 153738

Summary: [patch] Docuement requirement to alter some sysctls when using igb(4) with jumbo frames.
Product: Documentation Reporter: Tom Judge <tom>
Component: Books & ArticlesAssignee: Glen Barber <gjb>
Status: Closed FIXED    
Severity: Affects Only Me CC: jfv
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
igb.4.txt none

Description Tom Judge 2011-01-06 18:20:05 UTC
The attach patch (against current) documents the requirement to tune nmbcluster releated tuneables when using jumbo frames.

This tuning requirement is not obvious from error messages reported by the driver or the output of netstat -m.

Reviewed by: gjb@

Tom
Comment 1 Glen Barber freebsd_committer freebsd_triage 2011-01-06 18:40:27 UTC
Responsible Changed
From-To: freebsd-doc->gjb

Grab this, while waiting for feedback from jfv.
Comment 2 Glen Barber freebsd_committer freebsd_triage 2011-02-10 00:36:36 UTC
Responsible Changed
From-To: gjb->freebsd-doc

Back to the pool for now.
Comment 3 dfilter service freebsd_committer freebsd_triage 2012-05-12 19:10:42 UTC
Author: gjb (doc committer)
Date: Sat May 12 18:10:27 2012
New Revision: 235347
URL: http://svn.freebsd.org/changeset/base/235347

Log:
  Docuement requirement to alter some sysctls when using igb(4) with
  jumbo frames.
  
  PR:		153738
  Submitted by:	Tom Judge (tom!tomjudge.com)
  Discussed with:	jfv (in part, a long time ago...)
  MFC after:	1 week

Modified:
  head/share/man/man4/igb.4

Modified: head/share/man/man4/igb.4
==============================================================================
--- head/share/man/man4/igb.4	Sat May 12 17:42:22 2012	(r235346)
+++ head/share/man/man4/igb.4	Sat May 12 18:10:27 2012	(r235347)
@@ -31,7 +31,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd October 11, 2011
+.Dd May 12, 2012
 .Dt IGB 4
 .Os
 .Sh NAME
@@ -160,6 +160,14 @@ The minimum is 80, and the maximum is 40
 .It Va hw.igb.enable_aim
 If set to 1, enable Adaptive Interrupt Moderation.
 The default is to enable Adaptive Interrupt Moderation.
+.It Va kern.ipc.nmbclusters
+The maximum number of mbuf clusters allowed.
+If the system has more than one igb card or jumbo frames are
+enabled, this value will need to be increased.
+.It Va kern.ipc.nmbjumbo9k
+The maximum number of mbuf 9k jumbo clusters allowed.
+Increasing this to allow for at least 8192 extra clusters
+per interface can allow for an mtu of 8192.
 .El
 .Sh FILES
 .Bl -tag -width /dev/led/igb*
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 4 Glen Barber freebsd_committer freebsd_triage 2012-05-12 19:11:20 UTC
State Changed
From-To: open->patched

Committed the most recent patch received, thanks! 



Comment 5 Glen Barber freebsd_committer freebsd_triage 2012-05-12 19:11:20 UTC
Responsible Changed
From-To: freebsd-doc->gjb

Take.
Comment 6 dfilter service freebsd_committer freebsd_triage 2012-05-18 03:06:29 UTC
Author: gjb (doc committer)
Date: Fri May 18 02:06:10 2012
New Revision: 235589
URL: http://svn.freebsd.org/changeset/base/235589

Log:
  Document requirement to alter some sysctls when using igb(4) with
  jumbo frames.
  
  PR:		153738

Modified:
  stable/9/share/man/man4/igb.4
Directory Properties:
  stable/9/share/man/man4/   (props changed)

Modified: stable/9/share/man/man4/igb.4
==============================================================================
--- stable/9/share/man/man4/igb.4	Fri May 18 02:00:41 2012	(r235588)
+++ stable/9/share/man/man4/igb.4	Fri May 18 02:06:10 2012	(r235589)
@@ -31,7 +31,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 14, 2010
+.Dd May 12, 2012
 .Dt IGB 4
 .Os
 .Sh NAME
@@ -160,6 +160,14 @@ The minimum is 80, and the maximum is 40
 .It Va hw.igb.enable_aim
 If set to 1, enable Adaptive Interrupt Moderation.
 The default is to enable Adaptive Interrupt Moderation.
+.It Va kern.ipc.nmbclusters
+The maximum number of mbuf clusters allowed.
+If the system has more than one igb card or jumbo frames are
+enabled, this value will need to be increased.
+.It Va kern.ipc.nmbjumbo9k
+The maximum number of mbuf 9k jumbo clusters allowed.
+Increasing this to allow for at least 8192 extra clusters
+per interface can allow for an mtu of 8192.
 .El
 .Sh FILES
 .Bl -tag -width /dev/led/igb*
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 7 dfilter service freebsd_committer freebsd_triage 2012-05-18 03:06:42 UTC
Author: gjb (doc committer)
Date: Fri May 18 02:06:34 2012
New Revision: 235590
URL: http://svn.freebsd.org/changeset/base/235590

Log:
  Document requirement to alter some sysctls when using igb(4) with
  jumbo frames.
  
  PR:		153738

Modified:
  stable/8/share/man/man4/igb.4
Directory Properties:
  stable/8/share/man/man4/   (props changed)

Modified: stable/8/share/man/man4/igb.4
==============================================================================
--- stable/8/share/man/man4/igb.4	Fri May 18 02:06:10 2012	(r235589)
+++ stable/8/share/man/man4/igb.4	Fri May 18 02:06:34 2012	(r235590)
@@ -31,7 +31,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 14, 2010
+.Dd May 12, 2012
 .Dt IGB 4
 .Os
 .Sh NAME
@@ -160,6 +160,14 @@ The minimum is 80, and the maximum is 40
 .It Va hw.igb.enable_aim
 If set to 1, enable Adaptive Interrupt Moderation.
 The default is to enable Adaptive Interrupt Moderation.
+.It Va kern.ipc.nmbclusters
+The maximum number of mbuf clusters allowed.
+If the system has more than one igb card or jumbo frames are
+enabled, this value will need to be increased.
+.It Va kern.ipc.nmbjumbo9k
+The maximum number of mbuf 9k jumbo clusters allowed.
+Increasing this to allow for at least 8192 extra clusters
+per interface can allow for an mtu of 8192.
 .El
 .Sh DIAGNOSTICS
 .Bl -diag
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 8 Glen Barber freebsd_committer freebsd_triage 2012-06-15 18:20:32 UTC
State Changed
From-To: patched->closed

Closed, MFC done back in May. 

[Thanks issyl0 for the reminder. :) ]