From owner-freebsd-current@FreeBSD.ORG  Fri Jul  4 08:45:06 2003
Return-Path: <owner-freebsd-current@FreeBSD.ORG>
Delivered-To: freebsd-current@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id C3CAC37B401; Fri,  4 Jul 2003 08:45:06 -0700 (PDT)
Received: from bsdone.bsdwins.com (www.bsdwins.com [192.58.184.33])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id DDB8943FE0; Fri,  4 Jul 2003 08:45:05 -0700 (PDT)
	(envelope-from jwd@bsdwins.com)
Received: from bsdone.bsdwins.com (localhost [127.0.0.1])
	by bsdone.bsdwins.com (8.12.9/8.12.9) with ESMTP id h64FaMf1094229;
	Fri, 4 Jul 2003 11:36:22 -0400 (EDT)
	(envelope-from jwd@www.bsdwins.com)
Received: (from jwd@localhost)
	by bsdone.bsdwins.com (8.12.9/8.12.9/Submit) id h64FaM0F094228;
	Fri, 4 Jul 2003 11:36:22 -0400 (EDT)
Date: Fri, 4 Jul 2003 11:36:22 -0400
From: John <jwd@freebsd.org>
To: Joseph Koshy <jkoshy@freebsd.org>
Message-ID: <20030704153622.GA93986@BSDWins.Com>
References: <20030704084540.104CA37B401@hub.freebsd.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20030704084540.104CA37B401@hub.freebsd.org>
User-Agent: Mutt/1.4.1i
cc: freebsd-doc@freebsd.org
cc: freebsd-current@freebsd.org
Subject: Re: [review request] New config.5 manual page
X-BeenThere: freebsd-current@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Discussions about the use of FreeBSD-current
	<freebsd-current.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-current>
List-Post: <mailto:freebsd-current@freebsd.org>
List-Help: <mailto:freebsd-current-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 04 Jul 2003 15:45:07 -0000

Dealing with maxusers can be a bit confusing depending upon
the approach taken.  You may want to add a bit of additional
information:

     maxusers number
                  This optional directive is used to configure the size of
                  some kernel data structures.  number should be an integer
                  between 2 and 512, or can be 0.  From FreeBSD 4.5 onwards,
                  the kernel will automatically size its tables according to
                  the available physical memory if maxusers is not specified
                  or is specified to be 0.  As explained in tuning(7), this
                  tunable can also be set on a running kernel using sysctl(8).

<added>
                  When maxusers is not specified and thus automatically
                  sized, the default maximum is 384. To increase maxusers
                  beyond 384 requires either a config entry or boot time
                  override. As noted above, the config entry for maxusers
                  is limited to 512. If a maxusers of 1024 is desired, an
                  entry in /boot/loader.conf is required.
</added>

   If the maxusers can be specified in multiple locations, the limits
placed on the value should be similar/identical. Any differences in the
way the value is treated should be well documented (or fixed).  As we
move into larger memory systems our current limitations need to be either
removed or increased.
                  
   Hope this helps.

-John