From tom@tomjudge.com  Thu Jan  6 18:13:31 2011
Return-Path: <tom@tomjudge.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 69F6D1065672
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  6 Jan 2011 18:13:31 +0000 (UTC)
	(envelope-from tom@tomjudge.com)
Received: from tomjudge.vm.bytemark.co.uk (tomjudge.vm.bytemark.co.uk [80.68.91.100])
	by mx1.freebsd.org (Postfix) with ESMTP id 159FE8FC0A
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  6 Jan 2011 18:13:30 +0000 (UTC)
Received: from localhost (localhost.localdomain [127.0.0.1])
	by tomjudge.vm.bytemark.co.uk (Postfix) with ESMTP id C232511C03A;
	Thu,  6 Jan 2011 18:13:29 +0000 (GMT)
Received: from tomjudge.vm.bytemark.co.uk ([127.0.0.1])
	by localhost (tomjudge.vm.bytemark.co.uk [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id Fr1VzJKduqaO; Thu,  6 Jan 2011 18:13:27 +0000 (GMT)
Received: from tinderbox.home.tomjudge.com (unknown [192.168.200.5])
	by tomjudge.vm.bytemark.co.uk (Postfix) with SMTP id B58A448C6B;
	Thu,  6 Jan 2011 18:13:25 +0000 (GMT)
Received: by tinderbox.home.tomjudge.com (sSMTP sendmail emulation); Thu, 06 Jan 2011 18:17:50 +0000
Message-Id: <20110106181325.B58A448C6B@tomjudge.vm.bytemark.co.uk>
Date: Thu, 06 Jan 2011 18:17:50 +0000
From: "Tom Judge" <tom@tomjudge.com>
Reply-To: Tom Judge <tom@tomjudge.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc: jfv@freebsd.org,gjb@freebsd.org
Subject: [patch] Docuement requirement to alter some sysctls when using igb(4) with jumbo frames.
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         153738
>Category:       docs
>Synopsis:       [patch] Docuement requirement to alter some sysctls when using igb(4) with jumbo frames.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gjb
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jan 06 18:20:05 UTC 2011
>Closed-Date:    Fri Jun 15 17:21:14 UTC 2012
>Last-Modified:  Fri Jun 15 17:21:14 UTC 2012
>Originator:     Tom Judge
>Release:        FreeBSD 8.1-STABLE amd64
>Organization:
>Environment:
System: FreeBSD tinderbox.home.tomjudge.com 8.1-STABLE FreeBSD 8.1-STABLE #0 r213720: Tue Oct 12 14:02:02 UTC 2010 tj@tinderbox.home.tomjudge.com:/usr/obj/usr/src/sys/GENERIC amd64

>Description:

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

>How-To-Repeat:
>Fix:

--- igb.4.txt begins here ---
Index: igb.4
===================================================================
--- igb.4	(revision 216409)
+++ igb.4	(working copy)
@@ -161,6 +161,18 @@
 If set to 1, enable Adaptive Interrupt Moderation.
 The default is to enable Adaptive Interrupt Moderation.
 .El
+.Pp
+If using jumbo frames with this driver, it is worth
+configuring the following sysctls, as the default settings
+for the card will require more resources than the default.
+.Bl -tag -width indent
+.It Va kern.ipc.nmbclusters
+The maximum number of mbuf clusters allowed.
+.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 should allow for an mtu of 8192.
+.El
 .Sh DIAGNOSTICS
 .Bl -diag
 .It "igb%d: Unable to allocate bus resource: memory"
--- igb.4.txt ends here ---


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->gjb 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Thu Jan 6 18:40:27 UTC 2011 
Responsible-Changed-Why:  
Grab this, while waiting for feedback from jfv. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=153738 
Responsible-Changed-From-To: gjb->freebsd-doc 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Thu Feb 10 00:36:36 UTC 2011 
Responsible-Changed-Why:  
Back to the pool for now. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=153738 
State-Changed-From-To: open->patched 
State-Changed-By: gjb 
State-Changed-When: Sat May 12 18:11:20 UTC 2012 
State-Changed-Why:  
Committed the most recent patch received, thanks! 



Responsible-Changed-From-To: freebsd-doc->gjb 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Sat May 12 18:11:20 UTC 2012 
Responsible-Changed-Why:  
Take. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=153738 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/153738: commit references a PR
Date: Sat, 12 May 2012 18:10:42 +0000 (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"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/153738: commit references a PR
Date: Fri, 18 May 2012 02:06:29 +0000 (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"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/153738: commit references a PR
Date: Fri, 18 May 2012 02:06:42 +0000 (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"
 
State-Changed-From-To: patched->closed 
State-Changed-By: gjb 
State-Changed-When: Fri Jun 15 17:20:32 UTC 2012 
State-Changed-Why:  
Closed, MFC done back in May. 

[Thanks issyl0 for the reminder. :) ] 


http://www.freebsd.org/cgi/query-pr.cgi?pr=153738 
>Unformatted:
