>Number:         19758
>Category:       kern
>Synopsis:       need docs for "maxusers" kernel config
>Confidential:   yes
>Severity:       non-critical
>Priority:       low
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Jan 09 10:20:00 PST 2003
>Closed-Date:
>Last-Modified:
>Originator:     
>Release:        NetBSD 1.6
>Organization:
http://bsd.reedmedia.net/
>Environment:
	
	
System: NetBSD rainier.reedmedia.net 1.6 NetBSD 1.6 (JCR-20020927) #3: Sat Sep 28 13:40:20 PDT 2002 reed@rainier.reedmedia.net:/usr/src/sys/arch/i386/compile/JCR-20020927 i386
Architecture: i386
Machine: i386
>Description:
MAXUSERS and maxusers aren't explained in config(8), config(9)
 or options(4) man pages.
Search at netbsd.org doesn't easily find docs.

/usr/share/doc/smm/02.config/ is also empty. I think license is free
again.

Also no explanation of "maxusers 2 16 128" in new style config file --
what do the three parameters mean and when and how should it be changed

>How-To-Repeat:
Try to find explanation of maxusers or MAXUSERS.
>Fix:
Add to options(4) something like:
But this needs to be improved to expain the new style config (three numbers)
and to list each system data structures effected
and also mention the appropriate sysctl's that are same.
The bsdi/config.n doc has good info but I don't know if it is applicable.

--- /usr/share/man/man4/options.4       Sun Sep  8 12:32:14 2002
+++ options.4   Thu Jan  9 10:22:55 2003
@@ -755,6 +755,10 @@
 .El
 .Ss Miscellaneous Options
 .Bl -ohang
+.It Cd maxusers integer
+The expected number of the maximum simultaneously active users.
+This sets MAXUSERS and is used to size several system data structures.
+(See above about the NVNODE option.)
 .It Cd options LKM
 Enable loadable kernel modules.
 See

>Release-Note:
>Audit-Trail:
>Unformatted: