From martin@sumuk.de  Sun Apr 14 10:50:23 2002
Return-Path: <martin@sumuk.de>
Received: from Kain.sumuk.de (Kain.sumuk.de [213.221.86.114])
	by hub.freebsd.org (Postfix) with ESMTP id 54E0937B404
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Apr 2002 10:50:21 -0700 (PDT)
Received: from Moses.earth.sol (Moses.earth.sol [192.168.1.1])
	by Kain.sumuk.de (8.11.6/8.11.6) with ESMTP id g3EHoK002120
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Apr 2002 19:50:20 +0200 (CEST)
	(envelope-from martin@sumuk.de)
Received: (from vincent@localhost)
	by Moses.earth.sol (8.11.6/8.11.6) id g3EHoK731513;
	Sun, 14 Apr 2002 19:50:20 +0200 (CEST)
	(envelope-from vincent)
Message-Id: <200204141750.g3EHoK731513@Moses.earth.sol>
Date: Sun, 14 Apr 2002 19:50:20 +0200 (CEST)
From: Martin Heinen <martin@sumuk.de>
Reply-To: Martin Heinen <martin@sumuk.de>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] Handbook contains a wrong equation
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         37068
>Category:       docs
>Synopsis:       [PATCH] Handbook contains a wrong equation
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Apr 14 11:00:02 PDT 2002
>Closed-Date:    Sun Apr 21 18:55:51 PDT 2002
>Last-Modified:  Sun Apr 21 18:55:51 PDT 2002
>Originator:     Martin Heinen
>Release:        FreeBSD 4.4-STABLE i386
>Organization:
>Environment:
System: FreeBSD Moses.earth.sol 4.4-STABLE FreeBSD 4.4-STABLE #0: Sat Dec 22 07:35:30 CET 2001 toor@Moses.earth.sol:/usr/obj/usr/src/sys/MOSES i386


	
>Description:
	The section 'Network Limits' states that 32MBx2 = 64MB/2K,
	which is wrong.  Fixed and regrouped the equation.  Changed
	the memory units from K to kB.
>How-To-Repeat:
	Read the section 'Network Limits' in the chapter
	'Configuration and Tuning'.
>Fix:

Index: config/chapter.sgml
===================================================================
RCS file: /u/cvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v
retrieving revision 1.46
diff -u -r1.46 chapter.sgml
--- config/chapter.sgml	1 Apr 2002 14:39:14 -0000	1.46
+++ config/chapter.sgml	7 Apr 2002 11:33:32 -0000
@@ -1101,14 +1101,14 @@
 	option dictates the amount of network mbufs available to the
 	system.  A heavily-trafficked server with a low number of MBUFs
 	will hinder FreeBSD's ability.  Each cluster represents
-	approximately 2K of memory, so a value of 1024 represents 2
+	approximately 2 kB of memory, so a value of 1024 represents 2
 	megabytes of kernel memory reserved for network buffers.  A
 	simple calculation can be done to figure out how many are
 	needed. If you have a web server which maxes out at 1000
-	simultaneous connections, and each connection eats a 16K receive
-	and 16K send buffer, you need approximately 32MB worth of
+	simultaneous connections, and each connection eats a 16 kB receive
+	and 16 kB send buffer, you need approximately 32 MB worth of
 	network buffers to cover the web server.  A good rule of thumb is
-	to multiply by 2, so 32MBx2 = 64MB/2K = 32768.</para>
+	to multiply by 2, so 2x32 MB / 2 KB = 64 MB / 2 kB = 32768.</para>
     </sect2>
   </sect1>
 
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Sun Apr 21 18:52:47 PDT 2002 
State-Changed-Why:  
I committed the equation change already.  I don't think that changing 
the units of things is a good idea, since it just might fire up that 
old thread about KB vs. Kb vs. Kbyte vs the world, etc. 

Thanks for submitting this :) 

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