Bug 32020

Summary: loader(8) missing tunables
Product: Documentation Reporter: Bruce A. Mah <bmah>
Component: Books & ArticlesAssignee: Tom Rhodes <trhodes>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Bruce A. Mah 2001-11-15 23:40:01 UTC
loader(8) manpage has an incomplete list of loader tunables.

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.
How-To-Repeat: % man 8 loader
% cd /usr/src/sys/kern
% grep TUNABLE *
Comment 1 hiten pandya 2001-12-11 12:25:37 UTC
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
Comment 2 Hiten Pandya 2002-01-05 15:18:32 UTC
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
Comment 3 Hiten Pandya 2002-01-05 15:23:34 UTC
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
Comment 4 Bruce A. Mah 2002-01-05 16:31:00 UTC
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.
Comment 5 Tom Rhodes freebsd_committer freebsd_triage 2004-01-28 18:39:51 UTC
Responsible Changed
From-To: freebsd-doc->trhodes

In line with my tunables documentation project.
Comment 6 Tom Rhodes freebsd_committer freebsd_triage 2006-11-03 08:52:26 UTC
State Changed
From-To: open->closed

The maxusers loader tunable was added to loader(8) some 
time ago.  Close this PR, thanks!