From nobody@FreeBSD.org  Sun Dec 16 08:05:23 2001
Return-Path: <nobody@FreeBSD.org>
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id D025537B419
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 16 Dec 2001 08:05:21 -0800 (PST)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id fBGG5LJ34279;
	Sun, 16 Dec 2001 08:05:21 -0800 (PST)
	(envelope-from nobody)
Message-Id: <200112161605.fBGG5LJ34279@freefall.freebsd.org>
Date: Sun, 16 Dec 2001 08:05:21 -0800 (PST)
From: Hiten Pandya <hiten@uk.FreeBSD.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [PATCH] - add kern.maxusers to loader(8) man page
X-Send-Pr-Version: www-1.0

>Number:         32904
>Category:       docs
>Synopsis:       [PATCH] - add kern.maxusers to loader(8) man page
>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:   Sun Dec 16 08:10:01 PST 2001
>Closed-Date:    Fri Dec 28 08:25:20 PST 2001
>Last-Modified:  Fri Dec 28 08:26:56 PST 2001
>Originator:     Hiten Pandya
>Release:        5.0-CURRENT
>Organization:
>Environment:
FreeBSD hpdi.ath.cx 5.0-CURRENT FreeBSD 5.0-CURRENT #1: Wed Dec 12 00:34:45 GMT 2001     hitenp@hpdi.ath.cx:/usr/obj/data/dev/src/sys/CURRENT5  i386

>Description:
The loader(8) man page is missing the kern.maxusers tunable
information.  The topic was originally raised when rwatson 
was making corrections to the tuning(7) man page.

I am attaching a patch, which will add this tunable information
to the loader(8) man page, which will make it clear for people
that kern.maxusers can be set at boot time.
>How-To-Repeat:
Visit the loader(8) man page, and you will notice kern.maxusers is
missing. :-)
>Fix:
*** loader.8.old        Fri Dec  7 09:04:51 2001
--- loader.8    Fri Dec  7 09:04:59 2001
***************
*** 397,402 ****
--- 397,411 ----
  Other variables are used to override kernel tunable
parameters.
  The following tunables are available:
  .Bl -tag -width Va
+ .It Va kern.maxusers
+ Sets the static sizing number of the internal
+ systems table. The tunable defaults to a very
+ low value. We recommend modifying the value
+ for this tunable to (default: 32) 64, 128 or
+ 256.  Please do not assign a value higher
+ than 256 unless you need a huge amount of file
+ descriptors. Modifies kernel config(8)
+ .Va maxusers .
  .It Va kern.ipc.nmbclusters
  Set the number of mbuf clusters to be allocated.
  The value cannot be set below the default
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: bmah 
State-Changed-When: Fri Dec 28 08:21:40 PST 2001 
State-Changed-Why:  


http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32904 
State-Changed-From-To: closed->open 
State-Changed-By: bmah 
State-Changed-When: Fri Dec 28 08:22:40 PST 2001 
State-Changed-Why:  
Grrr...closed by misteak. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32904 
State-Changed-From-To: open->closed 
State-Changed-By: bmah 
State-Changed-When: Fri Dec 28 08:25:20 PST 2001 
State-Changed-Why:  
OK, now this can be closed.  Upon further investigation,  
loader.8 1.35 and 1.18.2.10 already contain a patch to document 
kern.maxusers, which reflects the autosizing code added to recent 
FreeBSD versions.  Thanks for your patch though! 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32904 
>Unformatted:
