From owner-freebsd-doc@FreeBSD.ORG Thu Dec 22 11:00:32 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 53A0810656B0 for ; Thu, 22 Dec 2011 11:00:32 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id E2F738FC16 for ; Thu, 22 Dec 2011 11:00:25 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id pBMB0Pah020882 for ; Thu, 22 Dec 2011 11:00:25 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pBMB0Pgu020881; Thu, 22 Dec 2011 11:00:25 GMT (envelope-from gnats) Resent-Date: Thu, 22 Dec 2011 11:00:25 GMT Resent-Message-Id: <201112221100.pBMB0Pgu020881@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Garrett Cooper Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 1220C1065673 for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/163527: [patch] Update tuning(7) a bit X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Dec 2011 11:00:32 -0000 >Number: 163527 >Category: docs >Synopsis: [patch] Update tuning(7) a bit >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Dec 22 11:00:25 UTC 2011 >Closed-Date: >Last-Modified: >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: >Unformatted: