Bug 99804
| Summary: | [PATCH] Handbook "Config" chapter maxusers info outdated | ||
|---|---|---|---|
| Product: | Documentation | Reporter: | Kevin Kinsey <kdk> |
| Component: | Books & Articles | Assignee: | Giorgos Keramidas <keramida> |
| Status: | Closed FIXED | ||
| Severity: | Affects Only Me | ||
| Priority: | Normal | ||
| Version: | Latest | ||
| Hardware: | Any | ||
| OS: | Any | ||
Responsible Changed From-To: freebsd-doc->keramida I'll handle this. State Changed From-To: open->closed A slightly modified version has been committed as: Revision Changes Path 1.218 +20 -3 doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml Thanks :) |
Handbook reference 11.13.1.1 "kern.maxfiles" only seems to refer to pre-4.5 behavior in regard to "kern.maxusers" (e.g., it doesn't mention this at all, only the older "maxusers" kernel option). This was creating a slight problem for a user this morning on the questions@ list. Also, since it is outdated, it doesn't agree with tuning(7). I've used material from that manpage to produce the included patch. Fix: Warning: IANAE on this (or much about kernels or SGML), but would this patch (against EN) help, at least for the immediate future? ===== START ===== ===== END ====== Sincerely, Kevin Kinsey--9cPGNo8i9egZHEjUmrGqmwpKpGkiapsPhAxkL5bg4RH5CrWl Content-Type: text/plain; name="file.diff" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="file.diff" --- chapter.sgml.orig Wed Jul 5 10:16:56 2006 +++ chapter.sgml Wed Jul 5 10:29:51 2006 @@ -2022,8 +2022,8 @@ require many thousands of file descriptors, depending on the kind and number of services running concurrently.</para> - <para><varname>kern.maxfile</varname>'s default value is - dictated by the <option>maxusers</option> option in your + <para>In older FreeBSD releases, <varname>kern.maxfile</varname>'s default + value is dictated by the <option>maxusers</option> option in your kernel configuration file. <varname>kern.maxfiles</varname> grows proportionally to the value of <option>maxusers</option>. When compiling a custom kernel, it is a good idea to set this kernel @@ -2033,7 +2033,19 @@ connected at once, the resources needed may be similar to a high-scale web server.</para> - <para>The system will auto-tune + <para>As of FreeBSD 4.5, <varname>kern.maxusers</varname> is automatically + sized at boot based on the amount of memory available in the system, and may be + determined at run-time by inspecting the value of the read-only + <varname>kern.maxusers</varname> sysctl. Some sites will require larger or + smaller values of kern.maxusers and may set it as a loader tunable; values of + 64, 128, and 256 are not uncommon. We do not recommend going above 256 unless + you need a huge number of file descriptors; many of the tunable values set to + their defaults by kern.maxusers may be individually overridden at boot-time or + run-time in /boot/loader.conf (see /boot/defaults/loader.conf for some hints) or + as described elsewhere in this document. Systems older than FreeBSD 4.4 must + set this value via the kernel config(8) option <option>maxusers</option> instead.</para> + + <para>In older releases, the system will auto-tune <literal>maxusers</literal> for you if you explicitly set it to <literal>0</literal><footnote> <para>The auto-tuning algorithm sets How-To-Repeat: Read the section above at: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/configtuning-kernel-limits.html ... and then try to find the "maxusers" option in your 6.X kernel config file ;-)