From owner-freebsd-doc@FreeBSD.ORG Wed Jul 5 16:01:02 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 68ED416A4F6 for ; Wed, 5 Jul 2006 16:01:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 79CDB43DF6 for ; Wed, 5 Jul 2006 16:00:36 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k65G0aMs095642 for ; Wed, 5 Jul 2006 16:00:36 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k65G0aaU095641; Wed, 5 Jul 2006 16:00:36 GMT (envelope-from gnats) Resent-Date: Wed, 5 Jul 2006 16:00:36 GMT Resent-Message-Id: <200607051600.k65G0aaU095641@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Kevin Kinsey Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1074516A5E0 for ; Wed, 5 Jul 2006 15:53:31 +0000 (UTC) (envelope-from kdk@daleco.biz) Received: from ezekiel.daleco.biz (southernuniform.com [66.76.92.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id 98A1643D68 for ; Wed, 5 Jul 2006 15:53:28 +0000 (GMT) (envelope-from kdk@daleco.biz) Received: from archangel.daleco.biz ([69.27.149.254]) by ezekiel.daleco.biz (8.13.4/8.13.1) with ESMTP id k65FqZ1Y047855 for ; Wed, 5 Jul 2006 10:52:57 -0500 (CDT) (envelope-from kdk@daleco.biz) Received: from localhost (localhost [127.0.0.1]) by archangel.daleco.biz (8.13.6/8.13.6) with ESMTP id k65FqOAe097398 for ; Wed, 5 Jul 2006 10:52:24 -0500 (CDT) (envelope-from kdk@daleco.biz) Received: from archangel.daleco.biz ([127.0.0.1]) by localhost (archangel.daleco.biz [127.0.0.1]) (amavisd-new, port 10024) with LMTP id iaMwZLVCOfD1 for ; Wed, 5 Jul 2006 10:52:17 -0500 (CDT) Received: from archangel.daleco.biz (localhost [127.0.0.1]) by archangel.daleco.biz (8.13.6/8.13.6) with ESMTP id k65FiPCF097311 for ; Wed, 5 Jul 2006 10:44:25 -0500 (CDT) (envelope-from kadmin@archangel.daleco.biz) Received: (from kadmin@localhost) by archangel.daleco.biz (8.13.6/8.13.6/Submit) id k65FiP2w097310; Wed, 5 Jul 2006 10:44:25 -0500 (CDT) (envelope-from kadmin) Message-Id: <200607051544.k65FiP2w097310@archangel.daleco.biz> Date: Wed, 5 Jul 2006 10:44:25 -0500 (CDT) From: Kevin Kinsey To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/99804: [PATCH] Handbook "Config" chapter maxusers info outdated X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Kevin Kinsey List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 05 Jul 2006 16:01:02 -0000 >Number: 99804 >Category: docs >Synopsis: [PATCH] Handbook "Config" chapter maxusers info outdated >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Wed Jul 05 16:00:35 GMT 2006 >Closed-Date: >Last-Modified: >Originator: Kevin Kinsey >Release: FreeBSD 6.1-STABLE i386 >Organization: DaleCo, S.P. >Environment: System: FreeBSD archangel.daleco.biz 6.1-STABLE FreeBSD 6.1-STABLE #2: Sat May 27 07:15:18 CDT 2006 root@archangel.daleco.biz:/usr/obj/backup/src/sys/GENERIC i386 >Description: 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. >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 ;-) >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 ===== --- 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. - kern.maxfile's default value is - dictated by the option in your + In older FreeBSD releases, kern.maxfile's default + value is dictated by the option in your kernel configuration file. kern.maxfiles grows proportionally to the value of . 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. - The system will auto-tune + As of FreeBSD 4.5, kern.maxusers 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 + kern.maxusers 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 instead. + + In older releases, the system will auto-tune maxusers for you if you explicitly set it to 0 The auto-tuning algorithm sets ===== END ====== Sincerely, Kevin Kinsey >Release-Note: >Audit-Trail: >Unformatted: