From bmah@packetdesign.com  Thu Nov 15 15:35:37 2001
Return-Path: <bmah@packetdesign.com>
Received: from mailman.packetdesign.com (dns.packetdesign.com [65.192.41.10])
	by hub.freebsd.org (Postfix) with ESMTP id DA74837B416
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 15 Nov 2001 15:35:36 -0800 (PST)
Received: from nimitz.packetdesign.com (nimitz.packetdesign.com [192.168.0.184])
	by mailman.packetdesign.com (8.11.0/8.11.0) with ESMTP id fAFNZa515882
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 15 Nov 2001 15:35:36 -0800 (PST)
	(envelope-from bmah@packetdesign.com)
Received: (from bmah@localhost)
	by nimitz.packetdesign.com (8.11.6/8.11.6) id fAFNRwB51476;
	Thu, 15 Nov 2001 15:27:58 -0800 (PST)
	(envelope-from bmah)
Message-Id: <200111152327.fAFNRwB51476@nimitz.packetdesign.com>
Date: Thu, 15 Nov 2001 15:27:58 -0800 (PST)
From: "Bruce A. Mah" <bmah@packetdesign.com>
Reply-To: "Bruce A. Mah" <bmah@packetdesign.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: loader.8 manpage missing tunables
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         32020
>Category:       docs
>Synopsis:       loader(8) missing tunables
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Nov 15 15:40:01 PST 2001
>Closed-Date:    Fri Nov 03 08:53:01 GMT 2006
>Last-Modified:  Fri Nov 03 08:53:01 GMT 2006
>Originator:     Bruce A. Mah
>Release:        FreeBSD 4.4-STABLE i386
>Organization:
Packet Design
>Environment:
System: FreeBSD nimitz.packetdesign.com 4.4-STABLE FreeBSD 4.4-STABLE #11: Wed Nov 14 12:01:02 PST 2001 root@nimitz.packetdesign.com:/usr/obj/usr/src/sys/NIMITZ i386


	
>Description:
loader(8) manpage has an incomplete list of loader tunables.

>How-To-Repeat:
% man 8 loader
% cd /usr/src/sys/kern
% grep TUNABLE *

>Fix:

Fix it.  There's some notes in the release notes that will help, and I
am guessing that LINT might also have some remarks.

I don't have time to work on this now, but it might be a good project
for somebody else.

>Release-Note:
>Audit-Trail:

From: Hiten Pandya <hitmaster2k@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org
Cc: bmah@packetdesign.com
Subject: Re: docs/32020: loader.8 manpage missing tunables
Date: Tue, 11 Dec 2001 04:25:37 -0800 (PST)

 Environment 5.0-CURRENT user
 
 i think, it would be great if we had a central file,
 (some sort of SGML or plain text file) which had 
 all the tunables also categorized... this would
 make it easier for people, as they can visit the 
 file and know which tunables are available on a given
 version of FreeBSD.
 
 BTW, a patch which adds kern.maxusers (v. important)
 to
 the loader.8 man page, as there was only 
 kern.ipc.nmbclusters in the file...
 
 =Hiten
 =<hiten@uk.FreeBSD.org>
 
 *** 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
 
 
 
 
 =====
 -Hiten,
 
 Thank You,
 Yours Sincerely,
 Hiten Pandya,
 <hiten@uk.freebsd.org>
 <http://www.geocities.com/hitmaster2k>
 
 __________________________________________________
 Do You Yahoo!?
 Check out Yahoo! Shopping and Yahoo! Auctions for all of
 your unique holiday gifts! Buy at http://shopping.yahoo.com
 or bid at http://auctions.yahoo.com

From: Hiten Pandya <hiten@uk.FreeBSD.org>
To: bug-followup@FreeBSD.org
Cc: bmah@packetdesign.com
Subject: Re: docs/32020 (close request)
Date: Sat, 05 Jan 2002 15:18:32 +0000

 hi,
 This PR can now be closed, as most of the tunables
 are in the loader(8) man page, and I have also submitted
 a patch to the kern.maxusers tunable addition, in my last
 follow-up before this one to this PR..
 
 I am currently working on making a list
 -- 
 SSH Fingerprint:
 1024 45:a5:9c:f2:fb:07:da:70:18:02:0b:f3:63:f1:7a:a6 hitenp@hpdi.ath.cx

From: Hiten Pandya <hiten@uk.FreeBSD.org>
To: bug-followup@FreeBSD.org, bmah@packetdesign.com
Cc:  
Subject: Re: docs/32020 (close request - correct one)
Date: Sat, 05 Jan 2002 15:23:34 +0000

 hi,
 
 oops, the last followup was mocked up because of my mailer..
 (this followup might have ^M characters)
 
 This PR can be closed, as I am currently working on an article which
 will list all the various tunables and how to use them.  I also
 submitted 
 a patch for the loader(8) man page to address the kern.maxusers
 boot-time 
 tunable, which was sent on Tue, 11 Dec 2001 04:25:37 -0800 (PST) as a 
 follow-up to this PR.
 
 thanks,
 regards,
 
  - Hiten
  - <hiten@uk.FreeBSD.org>
 -- 
 SSH Fingerprint:
 1024 45:a5:9c:f2:fb:07:da:70:18:02:0b:f3:63:f1:7a:a6 hitenp@hpdi.ath.cx

From: bmah@packetdesign.com (Bruce A. Mah)
To: hiten@uk.FreeBSD.org
Cc: bug-followup@FreeBSD.org, bmah@packetdesign.com
Subject: Re: docs/32020 (close request - correct one) 
Date: Sat, 05 Jan 2002 08:31:00 -0800

 If memory serves me right, Hiten Pandya wrote:
 
 > This PR can be closed, as I am currently working on an article which
 > will list all the various tunables and how to use them.
 
 No.  In the FreeBSD Project, we do not close PRs until they are in some
 way resolved.  This normally means that the problem gets fixed, or that
 it is no longer an issue.  Although I encourage your work on documenting
 the loader tunables, PR 32020 should stay open until the loader(8) 
 manpage is completed.
 
 > I also
 > submitted 
 > a patch for the loader(8) man page to address the kern.maxusers
 > boot-time 
 > tunable, which was sent on Tue, 11 Dec 2001 04:25:37 -0800 (PST) as a 
 > follow-up to this PR.
 
 You also submitted the patch twice, in two separate PRs, which I closed
 because:  1) The information you gave was superceded by the autotuning
 maxusers code and 2) someone already committed the correct information.
 
 Bruce.
 
 
Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Wed Jan 28 10:39:51 PST 2004 
Responsible-Changed-Why:  
In line with my tunables documentation project. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=32020 
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Fri Nov 3 08:52:26 UTC 2006 
State-Changed-Why:  
The maxusers loader tunable was added to loader(8) some 
time ago.  Close this PR, thanks! 

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