From nobody@FreeBSD.org  Thu Dec 22 10:54:17 2011
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 1220C1065673
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 22 Dec 2011 10:54:17 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id EAF1F8FC0A
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 22 Dec 2011 10:54:16 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id pBMAsGGB041189
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 22 Dec 2011 10:54:16 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id pBMAsG1E041180;
	Thu, 22 Dec 2011 10:54:16 GMT
	(envelope-from nobody)
Message-Id: <201112221054.pBMAsG1E041180@red.freebsd.org>
Date: Thu, 22 Dec 2011 10:54:16 GMT
From: Garrett Cooper <yaneurabeya@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] Update tuning(7) a bit
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         163527
>Category:       docs
>Synopsis:       [patch] Update tuning(7) a bit
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Dec 22 11:00:25 UTC 2011
>Closed-Date:    Fri Dec 23 22:59:07 UTC 2011
>Last-Modified:  Sun Feb 03 22:29:53 UTC 2013
>Originator:     Garrett Cooper
>Release:        9.0-RC2
>Organization:
n/a
>Environment:
FreeBSD bayonetta.local 9.0-RC2 FreeBSD 9.0-RC2 #0: Sun Nov 13 21:17:31 PST 2011     gcooper@bayonetta.local:/usr/obj/store/freebsd/stable/9/sys/BAYONETTA  amd64
>Description:
- Some of the defaults in tuning(7) haven't been updated following the changes made to the networking stack and UFS in 9.x .
- The manpage still references sysinstall.
- The manpage is lacking a suggestion to increase kern.ipc.nmbclusters, and in fact the recommended defaults are way too low for cxgb(4), igb(4), and a handful of other network cards (the default today on 8.x/9.x is 25600).

The attached patch improves upon those items.
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

Index: share/man/man7/tuning.7
===================================================================
--- share/man/man7/tuning.7	(revision 228662)
+++ share/man/man7/tuning.7	(working copy)
@@ -101,7 +101,9 @@
 depends on the kind of temporary file usage you think you will need.
 128M is
 the minimum we recommend.
-Also note that sysinstall will create a
+Also note that
+.Xr bsdinstall 8
+will create a
 .Pa /tmp
 directory.
 Dedicating a partition for temporary file storage is important for
@@ -219,7 +221,7 @@
 .Pp
 .Fx
 performs best when using 8K or 16K file system block sizes.
-The default file system block size is 16K,
+The default file system block size is 32K,
 which provides best performance for most applications,
 with the exception of those that perform random access on large files
 (such as database server software).
@@ -286,7 +288,7 @@
 option to
 .Xr newfs 8 ,
 and
-.Xr sysinstall 8
+.Xr bsdinstall 8
 will typically enable softupdates automatically for non-root file systems).
 Softupdates drastically improves meta-data performance, mainly file
 creation and deletion.
@@ -525,8 +527,8 @@
 to pre-read if the heuristics algorithm decides that the reads are
 issued sequentially.
 It is used by the UFS, ext2fs and msdosfs file systems.
-With the default UFS block size of 16 KiB, a setting of 32 will allow
-speculatively reading up to 512 KiB.
+With the default UFS block size of 32 KiB, a setting of 32 will allow
+speculatively reading up to 1 MiB.
 This setting may be increased to get around disk I/O latencies, especially
 where these latencies are large such as in virtual machine emulated
 environments.
@@ -566,8 +568,8 @@
 applications.
 They control the amount of send and receive buffer space
 allowed for any given TCP connection.
-The default sending buffer is 32K; the default receiving buffer
-is 64K.
+The default sending buffer is 128K; the default receiving buffer
+is 256K.
 You can often
 improve bandwidth utilization by increasing the default at the cost of
 eating up more kernel memory for each connection.
@@ -873,6 +875,15 @@
 Under no circumstances
 should you specify an arbitrarily high value for this parameter, it could
 lead to a boot-time crash.
+Please note that some drivers, require larger values, and in some cases the
+interfaces will hang on probe, e.g. dual-port (in some configurations) or
+quad-port
+.Xr igb 4 ,
+or cause system panics, e.g.
+.Xr cxgb 4 ,
+if you set
+.Va kern.ipc.nmbclusters
+to something less than 50000 and 75000, respectively.
 The
 .Fl m
 option to
@@ -1041,6 +1052,7 @@
 .Xr hier 7 ,
 .Xr ports 7 ,
 .Xr boot 8 ,
+.Xr bsdinstall 8 ,
 .Xr bsdlabel 8 ,
 .Xr ccdconfig 8 ,
 .Xr config 8 ,
@@ -1055,7 +1067,6 @@
 .Xr newfs 8 ,
 .Xr route 8 ,
 .Xr sysctl 8 ,
-.Xr sysinstall 8 ,
 .Xr tunefs 8
 .Sh HISTORY
 The


>Release-Note:
>Audit-Trail:

From: Garrett Cooper <yaneurabeya@gmail.com>
To: bug-followup <bug-followup@freebsd.org>
Cc:  
Subject: docs/163527: [patch] Update tuning(7) a bit
Date: Thu, 22 Dec 2011 03:32:58 -0800

 --f46d044470bf8c8fa004b4aca9d9
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: quoted-printable
 
 =A0 =A0 =A0 =A0I just reread the proposed addition to kern.ipc.nmbclusters =
 and
 cringed at my grammar. The proposed change isn't fantastic either
 (still draft quality in my mind), but it's better than the first
 proposed change.
 Thanks,
 -Garrett
 
 --f46d044470bf8c8fa004b4aca9d9
 Content-Type: TEXT/PLAIN; charset=US-ASCII; name="update-tuning-manpage.patch.txt"
 Content-Disposition: attachment; filename="update-tuning-manpage.patch.txt"
 Content-Transfer-Encoding: base64
 Content-ID: <alpine.BSF.2.00.1112220310360.19043@toaster.local>
 X-Attachment-Id: db257b2d21c828d8_0.1
 
 SW5kZXg6IHNoYXJlL21hbi9tYW43L3R1bmluZy43DQo9PT09PT09PT09PT09PT09PT09PT09PT09
 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQotLS0gc2hhcmUvbWFu
 L21hbjcvdHVuaW5nLjcJKHJldmlzaW9uIDIyODY2MikNCisrKyBzaGFyZS9tYW4vbWFuNy90dW5p
 bmcuNwkod29ya2luZyBjb3B5KQ0KQEAgLTEwMSw3ICsxMDEsOSBAQA0KIGRlcGVuZHMgb24gdGhl
 IGtpbmQgb2YgdGVtcG9yYXJ5IGZpbGUgdXNhZ2UgeW91IHRoaW5rIHlvdSB3aWxsIG5lZWQuDQog
 MTI4TSBpcw0KIHRoZSBtaW5pbXVtIHdlIHJlY29tbWVuZC4NCi1BbHNvIG5vdGUgdGhhdCBzeXNp
 bnN0YWxsIHdpbGwgY3JlYXRlIGENCitBbHNvIG5vdGUgdGhhdA0KKy5YciBic2RpbnN0YWxsIDgN
 Cit3aWxsIGNyZWF0ZSBhDQogLlBhIC90bXANCiBkaXJlY3RvcnkuDQogRGVkaWNhdGluZyBhIHBh
 cnRpdGlvbiBmb3IgdGVtcG9yYXJ5IGZpbGUgc3RvcmFnZSBpcyBpbXBvcnRhbnQgZm9yDQpAQCAt
 MjE5LDcgKzIyMSw3IEBADQogLlBwDQogLkZ4DQogcGVyZm9ybXMgYmVzdCB3aGVuIHVzaW5nIDhL
 IG9yIDE2SyBmaWxlIHN5c3RlbSBibG9jayBzaXplcy4NCi1UaGUgZGVmYXVsdCBmaWxlIHN5c3Rl
 bSBibG9jayBzaXplIGlzIDE2SywNCitUaGUgZGVmYXVsdCBmaWxlIHN5c3RlbSBibG9jayBzaXpl
 IGlzIDMySywNCiB3aGljaCBwcm92aWRlcyBiZXN0IHBlcmZvcm1hbmNlIGZvciBtb3N0IGFwcGxp
 Y2F0aW9ucywNCiB3aXRoIHRoZSBleGNlcHRpb24gb2YgdGhvc2UgdGhhdCBwZXJmb3JtIHJhbmRv
 bSBhY2Nlc3Mgb24gbGFyZ2UgZmlsZXMNCiAoc3VjaCBhcyBkYXRhYmFzZSBzZXJ2ZXIgc29mdHdh
 cmUpLg0KQEAgLTI4Niw3ICsyODgsNyBAQA0KIG9wdGlvbiB0bw0KIC5YciBuZXdmcyA4ICwNCiBh
 bmQNCi0uWHIgc3lzaW5zdGFsbCA4DQorLlhyIGJzZGluc3RhbGwgOA0KIHdpbGwgdHlwaWNhbGx5
 IGVuYWJsZSBzb2Z0dXBkYXRlcyBhdXRvbWF0aWNhbGx5IGZvciBub24tcm9vdCBmaWxlIHN5c3Rl
 bXMpLg0KIFNvZnR1cGRhdGVzIGRyYXN0aWNhbGx5IGltcHJvdmVzIG1ldGEtZGF0YSBwZXJmb3Jt
 YW5jZSwgbWFpbmx5IGZpbGUNCiBjcmVhdGlvbiBhbmQgZGVsZXRpb24uDQpAQCAtNTI1LDggKzUy
 Nyw4IEBADQogdG8gcHJlLXJlYWQgaWYgdGhlIGhldXJpc3RpY3MgYWxnb3JpdGhtIGRlY2lkZXMg
 dGhhdCB0aGUgcmVhZHMgYXJlDQogaXNzdWVkIHNlcXVlbnRpYWxseS4NCiBJdCBpcyB1c2VkIGJ5
 IHRoZSBVRlMsIGV4dDJmcyBhbmQgbXNkb3NmcyBmaWxlIHN5c3RlbXMuDQotV2l0aCB0aGUgZGVm
 YXVsdCBVRlMgYmxvY2sgc2l6ZSBvZiAxNiBLaUIsIGEgc2V0dGluZyBvZiAzMiB3aWxsIGFsbG93
 DQotc3BlY3VsYXRpdmVseSByZWFkaW5nIHVwIHRvIDUxMiBLaUIuDQorV2l0aCB0aGUgZGVmYXVs
 dCBVRlMgYmxvY2sgc2l6ZSBvZiAzMiBLaUIsIGEgc2V0dGluZyBvZiAzMiB3aWxsIGFsbG93DQor
 c3BlY3VsYXRpdmVseSByZWFkaW5nIHVwIHRvIDEgTWlCLg0KIFRoaXMgc2V0dGluZyBtYXkgYmUg
 aW5jcmVhc2VkIHRvIGdldCBhcm91bmQgZGlzayBJL08gbGF0ZW5jaWVzLCBlc3BlY2lhbGx5DQog
 d2hlcmUgdGhlc2UgbGF0ZW5jaWVzIGFyZSBsYXJnZSBzdWNoIGFzIGluIHZpcnR1YWwgbWFjaGlu
 ZSBlbXVsYXRlZA0KIGVudmlyb25tZW50cy4NCkBAIC01NjYsOCArNTY4LDggQEANCiBhcHBsaWNh
 dGlvbnMuDQogVGhleSBjb250cm9sIHRoZSBhbW91bnQgb2Ygc2VuZCBhbmQgcmVjZWl2ZSBidWZm
 ZXIgc3BhY2UNCiBhbGxvd2VkIGZvciBhbnkgZ2l2ZW4gVENQIGNvbm5lY3Rpb24uDQotVGhlIGRl
 ZmF1bHQgc2VuZGluZyBidWZmZXIgaXMgMzJLOyB0aGUgZGVmYXVsdCByZWNlaXZpbmcgYnVmZmVy
 DQotaXMgNjRLLg0KK1RoZSBkZWZhdWx0IHNlbmRpbmcgYnVmZmVyIGlzIDEyOEs7IHRoZSBkZWZh
 dWx0IHJlY2VpdmluZyBidWZmZXINCitpcyAyNTZLLg0KIFlvdSBjYW4gb2Z0ZW4NCiBpbXByb3Zl
 IGJhbmR3aWR0aCB1dGlsaXphdGlvbiBieSBpbmNyZWFzaW5nIHRoZSBkZWZhdWx0IGF0IHRoZSBj
 b3N0IG9mDQogZWF0aW5nIHVwIG1vcmUga2VybmVsIG1lbW9yeSBmb3IgZWFjaCBjb25uZWN0aW9u
 Lg0KQEAgLTg3Myw2ICs4NzUsMTUgQEANCiBVbmRlciBubyBjaXJjdW1zdGFuY2VzDQogc2hvdWxk
 IHlvdSBzcGVjaWZ5IGFuIGFyYml0cmFyaWx5IGhpZ2ggdmFsdWUgZm9yIHRoaXMgcGFyYW1ldGVy
 LCBpdCBjb3VsZA0KIGxlYWQgdG8gYSBib290LXRpbWUgY3Jhc2guDQorUGxlYXNlIG5vdGUgdGhh
 dCBzb21lIGRyaXZlcnMgcmVxdWlyZSBsYXJnZXIgdmFsdWVzLCBhbmQgaW4gc29tZSBjYXNlcyB0
 aGUNCitpbnRlcmZhY2VzIG5vdCBmdW5jdGlvbjsgc29tZSBkcml2ZXJzIGFyZSBrbm93biB0byBo
 YW5nIG9uDQorcHJvYmUvY29uZmlndXJhdGlvbiwgZS5nLiBzb21lIGR1YWwtcG9ydCBvciBxdWFk
 LXBvcnQNCisuWHIgaWdiIDQgLA0KK2NhcmRzLCBvciBjYXVzZSBzeXN0ZW0gcGFuaWNzLCBlLmcu
 DQorLlhyIGN4Z2IgNCAsDQoraWYgeW91IHNldA0KKy5WYSBrZXJuLmlwYy5ubWJjbHVzdGVycw0K
 K3RvIHNvbWV0aGluZyBsZXNzIHRoYW4gNTAwMDAgYW5kIDc1MDAwLCByZXNwZWN0aXZlbHkuDQog
 VGhlDQogLkZsIG0NCiBvcHRpb24gdG8NCkBAIC0xMDQxLDYgKzEwNTIsNyBAQA0KIC5YciBoaWVy
 IDcgLA0KIC5YciBwb3J0cyA3ICwNCiAuWHIgYm9vdCA4ICwNCisuWHIgYnNkaW5zdGFsbCA4ICwN
 CiAuWHIgYnNkbGFiZWwgOCAsDQogLlhyIGNjZGNvbmZpZyA4ICwNCiAuWHIgY29uZmlnIDggLA0K
 QEAgLTEwNTUsNyArMTA2Nyw2IEBADQogLlhyIG5ld2ZzIDggLA0KIC5YciByb3V0ZSA4ICwNCiAu
 WHIgc3lzY3RsIDggLA0KLS5YciBzeXNpbnN0YWxsIDggLA0KIC5YciB0dW5lZnMgOA0KIC5TaCBI
 SVNUT1JZDQogVGhlDQo=
 --f46d044470bf8c8fa004b4aca9d9--

From: Garrett Cooper <yaneurabeya@gmail.com>
To: bug-followup@FreeBSD.org, yanegomi@gmail.com
Cc:  
Subject: Re: docs/163527: [patch] Update tuning(7) a bit
Date: Fri, 23 Dec 2011 13:09:25 -0800

     I let some of my tweaks leak into the suggested changes: in
 reality, net.inet.tcp.{recv,send}space haven't changed to those new
 defaults. tuning(7) is being updated per
 http://wiki.freebsd.org/SystemTuning , so I'd just close this PR
 because the actual formulated recommended defaults will be determined
 there and seriously reviewed, compared to what I did here.
 Thanks!
 -Garrett
State-Changed-From-To: open->closed 
State-Changed-By: linimon 
State-Changed-When: Fri Dec 23 22:58:03 UTC 2011 
State-Changed-Why:  
Closed at submitter's request.  The wording of the page is 
currently being discussed on the wiki. 

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